Update-AzADUser

Sintaxe

UPNOrObjectIdParameterSet (Predefinição)

Update-AzADUser
    -UPNOrObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectIdParameterSet

Update-AzADUser
    -ObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Update-AzADUser
    -InputObject <IMicrosoftGraphUser>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UPNParameterSet

Update-AzADUser
    -UserPrincipalName <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: Atualizar usuário por nome principal de usuário

Update-AzADUser -UPNOrObjectId $upn -City $city

Parâmetros

-AccountEnabled

true para habilitar a conta; caso contrário, false. Sempre verdadeiro quando combinado com -Password. -AccountEnabled $false é ignorado ao alterar a senha da conta.

Propriedades dos parâmetros

Conjuntos de parâmetros

-AgeGroup

Define a faixa etária do usuário. Valores permitidos: nulo, menor, nãoAdulto e adulto. Consulte as definições legais de propriedade de faixa etária para obter mais informações. Suporta $filter (eq, ne, NOT e in).

Propriedades dos parâmetros

Conjuntos de parâmetros

-City

A cidade em que o usuário está localizado. O comprimento máximo é de 128 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-CompanyName

O nome da empresa à qual o usuário está associado. Esta propriedade pode ser útil para descrever a empresa de onde vem um usuário externo. O comprimento máximo do nome da empresa é de 64 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ConsentProvidedForMinor

Define se o consentimento foi obtido para menores. Valores permitidos: null, granted, denied e notRequired. Consulte as definições legais de propriedade de faixa etária para obter mais informações. Suporta $filter (eq, ne, NOT e in).

Propriedades dos parâmetros

Conjuntos de parâmetros

-Country

O país/região em que o utilizador está localizado; por exemplo, EUA ou Reino Unido. O comprimento máximo é de 128 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-DefaultProfile

As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.

Propriedades dos parâmetros

Conjuntos de parâmetros

-DeletedDateTime

.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Department

O nome do departamento no qual o usuário trabalha. O comprimento máximo é de 64 caracteres. Suporta $filter (eq, ne, NOT, ge, le e em operadores).

Propriedades dos parâmetros

Conjuntos de parâmetros

-DisplayName

O nome apresentado no livro de endereços do utilizador. Esse valor geralmente é a combinação do nome, da inicial do meio e do sobrenome do usuário. Essa propriedade é necessária quando um usuário é criado e não pode ser limpa durante as atualizações. O comprimento máximo é de 256 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith), $orderBy e $search.

Propriedades dos parâmetros

Conjuntos de parâmetros

-EmployeeHireDate

A data e hora em que o usuário foi contratado ou começará a trabalhar em caso de uma futura contratação. Suporta $filter (eq, ne, NOT, ge, le, in).

Propriedades dos parâmetros

Conjuntos de parâmetros

-EmployeeId

O identificador do funcionário atribuído ao utilizador pela organização. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-EmployeeType

Captura o tipo de trabalho empresarial. Por exemplo, Colaborador, Empreiteiro, Consultor ou Fornecedor. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-ExternalUserState

Para um usuário externo convidado para o locatário usando a API de convite, essa propriedade representa o status de convite do usuário convidado. Para utilizadores convidados, o estado pode ser PendingAcceptance, Aceite ou nulo para todos os outros utilizadores. Suporta $filter (eq, ne, NOT, in).

Propriedades dos parâmetros

Conjuntos de parâmetros

-ExternalUserStateChangeDateTime

Mostra o carimbo de data/hora da última alteração à propriedade externalUserState. Suporta $filter (eq, ne, NOT, in).

Propriedades dos parâmetros

Conjuntos de parâmetros

-FaxNumber

O número de fax do utilizador. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-ForceChangePasswordNextLogin

Deve ser especificado se o usuário deve alterar a senha no próximo login bem-sucedido (true). O comportamento padrão é (false) para não alterar a senha no próximo login bem-sucedido.

Propriedades dos parâmetros

Conjuntos de parâmetros

-GivenName

O nome próprio do utilizador especificado. O comprimento máximo é de 64 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-Id

Read-only.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Identity

Representa as identidades que podem ser usadas para entrar nessa conta de usuário. Uma identidade pode ser fornecida pela Microsoft (também conhecida como conta local), por organizações, ou por fornecedores de identidade social como o Facebook, Google e Microsoft, e associada a uma conta de utilizador. Pode conter vários itens com o mesmo valor signInType. Suporta $filter (eq) somente quando o signInType não é userPrincipalName. Para construir, consulte a seção NOTAS para propriedades IDENTITY e crie uma tabela de hash.

Propriedades dos parâmetros

Conjuntos de parâmetros

-InputObject

objeto de entrada do usuário

Propriedades dos parâmetros

Conjuntos de parâmetros

-IsResourceAccount

Não usar - reservado para uso futuro.

Propriedades dos parâmetros

Conjuntos de parâmetros

-JobTitle

O cargo do usuário. O comprimento máximo é de 128 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-Mail

O endereço SMTP para o utilizador, por exemplo, admin@contoso.com. As alterações nessa propriedade também atualizarão a coleção proxyAddresses do usuário para incluir o valor como um endereço SMTP. Embora esta propriedade possa conter caracteres de acento, o seu uso pode causar problemas de acesso com outras aplicações Microsoft para o utilizador. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-MailNickname

O alias de correio do utilizador. Esta propriedade tem de ser especificada quando um utilizador é criado. O comprimento máximo é de 64 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-ObjectId

O nome principal do usuário a ser atualizado.

Propriedades dos parâmetros

Conjuntos de parâmetros

-OfficeLocation

A localização do escritório no local de negócio do utilizador. O comprimento máximo é de 128 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-OnPremisesImmutableId

Esta propriedade é usada para associar uma conta de utilizador Active Directory no local ao seu objeto de utilizador Azure AD. 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. Devolvido apenas no $select. Suporta $filter (eq, ne, NOT, ge, le, in)..

Propriedades dos parâmetros

Conjuntos de parâmetros

-OtherMail

Uma lista de endereços de e-mail adicionais para o usuário; por exemplo: ['bob@contoso.com', 'Robert@fabrikam.com']. Observação : embora essa propriedade possa conter caracteres de destaque, eles podem causar problemas de acesso a aplicativos primários para o usuário. Suporta $filter (eq, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-PassThru

Retorna true quando o comando é bem-sucedido

Propriedades dos parâmetros

Conjuntos de parâmetros

-Password

A palavra-passe do utilizador. Esta propriedade é necessária quando um utilizador é criado.

Ele pode ser atualizado, mas o usuário será obrigado a alterar a senha no próximo login.

A senha deve satisfazer os requisitos mínimos, conforme especificado pela propriedade passwordPolicies do usuário. Por padrão, uma senha forte é necessária. Ao alterar a senha usando esse método, AccountEnabled é definido como true.

Propriedades dos parâmetros

Conjuntos de parâmetros

-PasswordPolicy

Especifica políticas de palavra-passe para o utilizador. Este valor é uma enumeração com um valor possível a ser DisableStrongPassword, que permite especificar palavras-passe mais fracas do que a política predefinida. DisablePasswordExpiration também pode ser especificado. Os dois podem ser especificados em conjunto; por exemplo: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Propriedades dos parâmetros

Conjuntos de parâmetros

-PasswordProfile

passwordProfile Para construir, consulte a seção NOTAS para propriedades PASSWORDPROFILE e crie uma tabela de hash.

Propriedades dos parâmetros

Conjuntos de parâmetros

-PostalCode

O código postal do endereço postal do utilizador. O código postal é específico para o país/região do utilizador. Na Estados Unidos da América, este atributo contém o código postal. O comprimento máximo é de 40 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-PreferredLanguage

O idioma preferencial para o utilizador. Deve seguir o código ISO 639-1; por exemplo, en-US. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-ShowInAddressList

verdade se a lista global de endereços do Outlook conter este utilizador, caso contrário falso. Se não estiver definido, isso será tratado como verdadeiro. Para usuários convidados por meio do gerenciador de convites, essa propriedade será definida como false. Suporta $filter (eq, ne, NOT, in).

Propriedades dos parâmetros

Conjuntos de parâmetros

-State

O estado ou província no endereço do utilizador. O comprimento máximo é de 128 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-StreetAddress

A morada do local de negócio do utilizador. O comprimento máximo é de 1024 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-Surname

O apelido do utilizador (nome da família ou apelido). O comprimento máximo é de 64 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-UPNOrObjectId

O nome principal do usuário ou ID do objeto do usuário a ser atualizado.

Propriedades dos parâmetros

Conjuntos de parâmetros

-UsageLocation

Um código de país de duas letras (norma ISO 3166). Necessário para usuários que receberão licenças devido a requisitos legais para verificar a disponibilidade de serviços em países. Os exemplos incluem: E.U.A., JP e GB. Não anulável. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-UserPrincipalName

O nome principal de utilizador (User Principal Name - UPN). O UPN é um nome de login no estilo Internet para o usuário baseado no padrão da Internet RFC 822. Por convenção, isso deve ser mapeado para o nome de e-mail do usuário. O formato geral é alias@domain, onde o domínio deve estar presente na coleção de domínios verificados do locatário. Esta propriedade é necessária quando um utilizador é criado. Os domínios verificados para o locatário podem ser acessados a partir da propriedade verifiedDomains da organização. Observação : embora essa propriedade possa conter caracteres de destaque, eles podem causar problemas de acesso a aplicativos primários para o usuário. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) e $orderBy.

Propriedades dos parâmetros

Conjuntos de parâmetros

-UserType

Um valor de cadeia de caracteres que pode ser usado para classificar tipos de usuário em seu diretório, como Membro e Convidado. Suporta $filter (eq, ne, NOT, in,).

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

IMicrosoftGraphUser

Saídas

Boolean

Notas