Compartilhar via


Update-AzADUser

Atualiza a entidade em usuários

Sintaxe

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>]
Update-AzADUser
      [-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>]
      -ObjectId <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzADUser
      [-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>]
      -InputObject <IMicrosoftGraphUser>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzADUser
      [-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>]
      -UserPrincipalName <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Atualiza a entidade em usuários

Exemplos

Exemplo 1: atualizar o usuário pelo nome da entidade de segurança do usuário

Update-AzADUser -UPNOrObjectId $upn -City $city

Atualizar o usuário pelo nome da entidade de usuário

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.

Tipo:Boolean
Aliases:EnableAccount
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AgeGroup

Define a faixa etária do usuário. Valores permitidos: nulo, menor, notAdult e adulto. Consulte as definições de propriedade da faixa etária legal para obter mais informações. Dá suporte a $filter (eq, ne, NOT e in).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-City

A cidade na qual o usuário está localizado. O comprimento máximo é de 128 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CompanyName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConsentProvidedForMinor

Define se o consentimento foi obtido para menores. Valores permitidos: nulo, concedido, negado e não solicitado. Consulte as definições de propriedade da faixa etária legal para obter mais informações. Dá suporte a $filter (eq, ne, NOT e in).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Country

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:PSObject
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeletedDateTime

.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Department

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisplayName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EmployeeHireDate

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

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EmployeeId

O identificador de funcionário atribuído ao usuário pela organização. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EmployeeType

Captura o tipo de trabalho corporativo. Por exemplo, Funcionário, Empreiteiro, Consultor ou Fornecedor. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExternalUserState

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExternalUserStateChangeDateTime

Mostra o carimbo de data/hora da última alteração na propriedade externalUserState. Dá suporte a $filter (eq, ne, NOT , in).

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FaxNumber

O número de fax do usuário. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceChangePasswordNextLogin

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-GivenName

O nome fornecido (nome) do usuário. O comprimento máximo é de 64 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Somente leitura.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-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 uma conta local), por organizações ou por provedores de identidade social, como Facebook, Google e Microsoft, e vinculada a uma conta de usuário. Pode conter vários itens com o mesmo valor signInType. Dá suporte a $filter (eq) somente em que o signInType não é userPrincipalName. Para construir, consulte a seção NOTES para propriedades IDENTITY e crie uma tabela de hash.

Tipo:IMicrosoftGraphObjectIdentity[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

objeto de entrada do usuário

Tipo:IMicrosoftGraphUser
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-IsResourceAccount

Não use - reservado para uso futuro.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobTitle

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Mail

O endereço SMTP para o usuário, 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 essa propriedade possa conter caracteres de destaque, usá-los pode causar problemas de acesso com outros aplicativos da Microsoft para o usuário. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MailNickname

O alias de email para o usuário. Essa propriedade deve ser especificada quando um usuário é criado. O comprimento máximo é de 64 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ObjectId

O nome principal do usuário a ser atualizado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OfficeLocation

O local do escritório no local de negócios do usuário. O comprimento máximo é de 128 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnPremisesImmutableId

Essa propriedade é usada para associar uma conta de usuário do Active Directory local ao objeto de usuário do 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. OBSERVAÇÃO: os caracteres $ e _ não podem ser usados ao especificar essa propriedade. Retornado somente em $select. Dá suporte a $filter (eq, ne, NOT, ge, le, in)..

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OtherMail

Uma lista de endereços de email adicionais para o usuário; por exemplo: ['bob@contoso.com', 'Robert@fabrikam.com']. OBSERVAÇÃO: embora essa propriedade possa conter caracteres de destaque, elas podem causar problemas de acesso a aplicativos de primeira parte para o usuário. Dá suporte a $filter (eq, NOT, ge, le, in, startsWith).

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Retorna true quando o comando é bem-sucedido

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Password

A senha do usuário. Essa propriedade é necessária quando um usuário é criado.

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

A senha deve atender aos requisitos mínimos como speci./fied 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.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PasswordPolicy

Especifica políticas de senha para o usuário. Esse valor é uma enumeração com um valor possível sendo DisableStrongPassword, que permite que senhas mais fracas do que a política padrão sejam especificadas. DisablePasswordExpiration também pode ser especificado. Os dois podem ser especificados juntos; por exemplo: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PasswordProfile

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

Tipo:IMicrosoftGraphPasswordProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PostalCode

O código postal do endereço postal do usuário. O código postal é específico para o país/região do usuário. Nos Estados Unidos da América, esse atributo contém o CEP. O comprimento máximo é de 40 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PreferredLanguage

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ShowInAddressList

true se a lista de endereços global do Outlook deve conter esse usuário, caso contrário, false. 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. Dá suporte a $filter (eq, ne, NOT, in).

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-State

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StreetAddress

O endereço de rua do local de negócios do usuário. O comprimento máximo é de 1.024 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Surname

O sobrenome do usuário (nome da família ou sobrenome). O comprimento máximo é de 64 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UPNOrObjectId

O nome da entidade de usuário ou a ID do objeto do usuário a ser atualizado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UsageLocation

Um código de país de duas letras (ISO standard 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: EUA, JP e GB. Não é anulável. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserPrincipalName

O UPN (nome de entidade de usuário) do usuário. O UPN é um nome de logon no estilo da Internet para o usuário com base no RFC 822 padrão da Internet. Por convenção, isso deve ser mapeado para o nome de email do usuário. O formato geral é alias@domain, em que o domínio deve estar presente na coleção de domínios verificados do locatário. Essa propriedade é necessária quando um usuário é criado. Os domínios verificados para o locatário podem ser acessados da propriedade verifiedDomains da organização. OBSERVAÇÃO: embora essa propriedade possa conter caracteres de destaque, elas podem causar problemas de acesso a aplicativos de primeira parte para o usuário. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) e $orderBy.

Tipo:String
Aliases:UPN
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-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. Dá suporte a $filter (eq, ne, NOT, in,).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

IMicrosoftGraphUser

Saídas

Boolean

Observações

ALIASES

Set-AzADUser