---
updatedAt: 2026-05-11T22:28:55.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/powershell/llms.txt
---

# User

Set-IAMUser

## Synopsis

Update a user.

## Syntax

```powershell
Set-IAMUser [-UIIdentityID] <String> [-Body] <Object> [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
```

## Description

Modifies a specified user's information.

It's recommended that you retrieve the user's information via the `Get-IAMUser` operation, edit it locally, and then pipe the result to this function.

## Parameters

<table>
  <tbody>
    <tr>
      <td class="ps-td"><code>&#8209;AccountSwitchKey</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>An account credential key that lets you move between accounts when using an API client enabled for multiple accounts. To find account switch keys, use <a href="https://techdocs.akamai.com/powershell/docs/get-accountswitchkey">Get-AccountSwitchKey</a>.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;Body</code><br/><span style="color: red; padding-left: 11px; font-size: 13px;"><em>Required</em></span></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">Object</span>
          <span class="ps-param-metadata">Pipeline input: ByValue</span>
        </div>
        <div>
          <p>A request body, either as a <code>PSCustomObject</code> or a string. This parameter supports pipelining.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;EdgeRCFile</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>Your EdgeGrid resource file to authenticate your command. Defaults to <code>~/.edgerc</code>.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;Section</code></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to <code>default</code>.</p>
        </div>
      </td>
    </tr>
    <tr>
      <td class="ps-td"><code>&#8209;UIIdentityID</code><br/><span style="color: red; padding-left: 11px; font-size: 13px;"><em>Required</em></span></td> 
      <td class="ps-tableinner">
        <div class="ps-metadata">
          <span class="ps-param-metadata">String</span>
          <span class="ps-param-metadata">Pipeline input: False</span>
        </div>
        <div>
          <p>A given user's ID. To get this value, run <code>Get-IAMUser</code>.</p>
        </div>
      </td>
    </tr>
  </tbody>
</table>

## Related Links

* [User Guide: Identity & Access Management](https://techdocs.akamai.com/powershell/docs/identity-access)
* [API Reference](https://techdocs.akamai.com/iam-user-admin/reference/put-ui-identity-basic-info)

# Sibling pages

* [API client](https://techdocs.akamai.com/powershell/docs/set-iamapiclient.md)
* [API credential](https://techdocs.akamai.com/powershell/docs/set-iamapicredential.md)
* [Blocked properties](https://techdocs.akamai.com/powershell/docs/set-iamuserblockedproperties.md)
* [CIDR block](https://techdocs.akamai.com/powershell/docs/set-iamcidrblock.md)
* [Group](https://techdocs.akamai.com/powershell/docs/set-iamgroup.md)
* [Group & role assignments](https://techdocs.akamai.com/powershell/docs/set-iamusergroupandrole.md)
* [Multi-factor authentication](https://techdocs.akamai.com/powershell/docs/set-iamusermfa.md)
* [Role](https://techdocs.akamai.com/powershell/docs/set-iamrole.md)
* [User notifications](https://techdocs.akamai.com/powershell/docs/set-iamusernotifications.md)
* [User password](https://techdocs.akamai.com/powershell/docs/set-iamuserpassword.md)
* [User profile](https://techdocs.akamai.com/powershell/docs/set-iamuserprofile.md)