Partilhar via

az ad user

Gerencie usuários do Microsoft Entra.

Comandos

Name Description Tipo Status
az ad user create

Crie um utilizador.

 Core disponibilidade geral
az ad user delete

Excluir um usuário.

 Core disponibilidade geral
az ad user get-member-groups

Obter grupos dos quais o usuário é membro.

 Core disponibilidade geral
az ad user list

Listar usuários.

 Core disponibilidade geral
az ad user show

Obtenha os detalhes de um usuário.

 Core disponibilidade geral
az ad user update

Atualize um usuário.

 Core disponibilidade geral

az ad user create

Editar

Crie um utilizador.

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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.

Propriedade Valor
Default value: False
Valores aceites: false, true
--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Default value: False

az ad user delete

Editar

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Default value: False

az ad user get-member-groups

Editar

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Default value: False

az ad user list

Editar

Listar usuários.

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

Exemplos

Liste todos os usuários.

az ad user list

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Default value: False

az ad user show

Editar

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Default value: False

az ad user update

Editar

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--account-enabled

Habilite a conta de usuário.

Propriedade Valor
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.

Propriedade Valor
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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Default value: False