Update-AzADUser

Referência

Módulo:: Az.Resources

Atualiza a entidade nos 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 nos usuários

Exemplos

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

Update-AzADUser -UPNOrObjectId $upn -City $city

Atualizar usuário por nome principal 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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DeletedDateTime

Tipo:	DateTime
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DisplayName

O nome exibido no catálogo de endereços do usuário. 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.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

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

Tipo:	DateTime
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-EmployeeId

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-EmployeeType

Captura o tipo de trabalhador da empresa. Por exemplo, Funcionário, Empreiteiro, Consultor ou Fornecedor. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-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 usuários convidados, o estado pode ser PendingAcceptance ou Accepted, ou null para todos os outros usuários. Suporta $filter (eq, ne, NOT, in).

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ExternalUserStateChangeDateTime

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

Tipo:	DateTime
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-FaxNumber

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-GivenName

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Id

Somente leitura.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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 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. 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.

Tipo:	IMicrosoftGraphObjectIdentity[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InputObject

objeto de entrada do usuário

Tipo:	IMicrosoftGraphUser
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-IsResourceAccount

Não usar - reservado para uso futuro.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-JobTitle

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Mail

O endereço SMTP do 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 acentuados, usá-los pode causar problemas de acesso com outros aplicativos da Microsoft para o usuário. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ObjectId

O nome principal do usuário a ser atualizado.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-OfficeLocation

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-OnPremisesImmutableId

Essa propriedade é usada para associar uma conta de usuário do Ative 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. 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)..

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

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

Tipo:	String[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PassThru

Retorna true quando o comando é bem-sucedido

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Password

A senha do usuário. Esta propriedade é necessária quando um usuário é 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./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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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 em conjunto; por exemplo: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PasswordProfile

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

Tipo:	IMicrosoftGraphPasswordProfile
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PreferredLanguage

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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. Suporta $filter (eq, ne, NOT, in).

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-State

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-StreetAddress

O endereço do estabelecimento comercial do utilizador. O comprimento máximo é de 1024 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Surname

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UPNOrObjectId

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-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. Exemplos incluem: EUA, JP e GB. Não anulável. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UserPrincipalName

O nome principal do usuário (UPN) do usuário. 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 usuário é 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.

Tipo:	String
Aliases:	UPN
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	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. Suporta $filter (eq, ne, NOT, in,).

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

IMicrosoftGraphUser

Saídas

Boolean

Notas

PSEUDÓNIMOS

Set-AzADUser

Partilhar via