Partilhar via


az ad user

Gerencie usuários do Microsoft Entra.

Comandos

Name Description Tipo Status
az ad user create

Crie um usuário.

Principal GA
az ad user delete

Excluir um usuário.

Principal GA
az ad user get-member-groups

Obter grupos dos quais o usuário é membro.

Principal GA
az ad user list

Listar usuários.

Principal GA
az ad user show

Obtenha os detalhes de um usuário.

Principal GA
az ad user update

Atualize um usuário.

Principal GA

az ad user create

Crie um usuário.

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

Exemplos

Criar um utilizador

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

Parâmetros Obrigatórios

--display-name

Nome de exibição do objeto ou seu prefixo.

--password

A senha que deve ser atribuída ao usuário para autenticação.

--user-principal-name

O nome principal do usuário (someuser@contoso.com). Ele deve conter um dos domínios verificados para o locatário.

Parâmetros Opcionais

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

Marca esse usuário como precisando atualizar sua senha na próxima vez que se autenticar. Se omitido, falso será usado.

Valores aceites: false, true
Default value: False
--immutable-id

Essa propriedade é usada para associar uma conta de usuário do Ative Directory local ao objeto de usuário do Microsoft Entra. Essa propriedade deve ser especificada ao criar uma nova conta de usuário no Graph se você estiver usando um domínio federado para a propriedade userPrincipalName (UPN) do usuário. NOTA: Os caracteres $ e _ não podem ser usados ao especificar essa propriedade.

--mail-nickname

Alias de email. O padrão é o nome principal do usuário.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ad user delete

Excluir um usuário.

az ad user delete --id

Exemplos

Excluir um usuário.

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

Parâmetros Obrigatórios

--id

O ID do objeto ou nome principal do usuário para o qual obter informações.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ad user get-member-groups

Obter grupos dos quais o usuário é membro.

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

Exemplos

Obter grupos dos quais o usuário é membro

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

Parâmetros Obrigatórios

--id

O ID do objeto ou nome principal do usuário para o qual obter informações.

Parâmetros Opcionais

--security-enabled-only

True para especificar que apenas os grupos de segurança dos quais a entidade é membro devem ser retornados; false para especificar que todos os grupos e funções de diretório dos quais a entidade é membro devem ser retornados.

Valores aceites: false, true
Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ad user list

Listar usuários.

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

Exemplos

Liste todos os usuários.

az ad user list

Parâmetros Opcionais

--display-name

Nome de exibição do objeto ou seu prefixo.

--filter

Filtro OData, por exemplo, --filter "displayname eq 'test' e servicePrincipalType eq 'Application'".

--upn

Nome principal do utilizador, por exemplo: john.doe@contoso.com.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ad user show

Obtenha os detalhes de um usuário.

az ad user show --id

Exemplos

Mostrar um usuário.

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

Parâmetros Obrigatórios

--id

O ID do objeto ou nome principal do usuário para o qual obter informações.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az ad user update

Atualize um usuário.

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

Exemplos

Atualize um usuário.

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

Parâmetros Obrigatórios

--id

O ID do objeto ou nome principal do usuário para o qual obter informações.

Parâmetros Opcionais

--account-enabled

Habilite a conta de usuário.

Valores aceites: false, true
--display-name

Nome de exibição do objeto ou seu prefixo.

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

Se o usuário deve alterar sua senha no próximo login.

Valores aceites: false, true
--mail-nickname

Alias de email. O padrão é o nome principal do usuário.

--password

Palavra-passe de utilizador.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.