你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az ad user

管理 Microsoft Entra 用户。

命令

名称 说明 类型 Status
az ad user create

创建一个用户。

核心 GA
az ad user delete

删除用户。

核心 GA
az ad user get-member-groups

获取用户所属的组。

核心 GA
az ad user list

列出用户。

核心 GA
az ad user show

获取用户的详细信息。

核心 GA
az ad user update

更新用户。

核心 GA

az ad user create

创建一个用户。

az ad user create --display-name
                  --password
                  --user-principal-name
                  [--force-change-password-next-sign-in {false, true}]
                  [--immutable-id]
                  [--mail-nickname]

示例

创建用户

az ad user create --display-name myuser --password password --user-principal-name myuser@contoso.com

必需参数

--display-name

对象的显示名称或其前缀。

--password

应分配给用户进行身份验证的密码。

--user-principal-name

用户主体名称 (someuser@contoso.com)。 它必须包含租户的已验证域之一。

可选参数

--force-change-password-next-sign-in

在下次进行身份验证时,将此用户标记为需要更新其密码。 如果省略,将使用 false。

接受的值: false, true
默认值: False
--immutable-id

此属性用于将本地 Active Directory用户帐户与其 Microsoft Entra 用户对象相关联。 如果在对用户的 userPrincipalName (UPN) 属性使用联合域,则必须在 Graph 中创建新用户帐户时指定此属性。 注意:指定此属性时不能使用 $ 和 _ 字符。

--mail-nickname

邮件别名。 默认为用户主体名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az ad user delete

删除用户。

az ad user delete --id

示例

删除用户。

az ad user delete --id myuser@contoso.com

必需参数

--id

要获取其信息的用户的对象 ID 或主体名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az ad user get-member-groups

获取用户所属的组。

az ad user get-member-groups --id
                             [--security-enabled-only {false, true}]

示例

获取用户所属的组

az ad user get-member-groups --id myuser@contoso.com

必需参数

--id

要获取其信息的用户的对象 ID 或主体名称。

可选参数

--security-enabled-only

如果指定仅应返回实体所属的安全组,则为 True;false 指定应返回实体所属的所有组和目录角色。

接受的值: false, true
默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az ad user list

列出用户。

az ad user list [--display-name]
                [--filter]
                [--upn]

示例

列出所有用户。

az ad user list

可选参数

--display-name

对象的显示名称或其前缀。

--filter

OData 筛选器,例如 --filter “displayname eq 'test' and servicePrincipalType eq 'Application'”。

--upn

用户主体名称,例如 john.doe@contoso.com。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az ad user show

获取用户的详细信息。

az ad user show --id

示例

显示用户。

az ad user show --id myuser@contoso.com

必需参数

--id

要获取其信息的用户的对象 ID 或主体名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az ad user update

更新用户。

az ad user update --id
                  [--account-enabled {false, true}]
                  [--display-name]
                  [--force-change-password-next-sign-in {false, true}]
                  [--mail-nickname]
                  [--password]

示例

更新用户。

az ad user update --id myuser@contoso.com --display-name username2

必需参数

--id

要获取其信息的用户的对象 ID 或主体名称。

可选参数

--account-enabled

启用用户帐户。

接受的值: false, true
--display-name

对象的显示名称或其前缀。

--force-change-password-next-sign-in

如果用户必须在下一次登录时更改密码。

接受的值: false, true
--mail-nickname

邮件别名。 默认为用户主体名称。

--password

用户密码。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。