Set-AzureADUser

Referência

Módulo:: AzureAD

Atualiza um utilizador.

Syntax

Set-AzureADUser
   -ObjectId <String>
   [-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-CreationType <String>]
   [-Department <String>]
   [-DisplayName <String>]
   [-FacsimileTelephoneNumber <String>]
   [-GivenName <String>]
   [-IsCompromised <Boolean>]
   [-ImmutableId <String>]
   [-JobTitle <String>]
   [-MailNickName <String>]
   [-Mobile <String>]
   [-OtherMails <System.Collections.Generic.List`1[System.String]>]
   [-PasswordPolicies <String>]
   [-PasswordProfile <PasswordProfile>]
   [-PhysicalDeliveryOfficeName <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-ShowInAddressList <Boolean>]
   [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-TelephoneNumber <String>]
   [-UsageLocation <String>]
   [-UserPrincipalName <String>]
   [-UserState <String>]
   [-UserStateChangedOn <String>]
   [-UserType <String>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureADUser atualiza um utilizador no Azure Active Directory (AD).

Exemplos

Exemplo 1: atualizar um utilizador

PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com 
PS C:\> $user.DisplayName = 'YetAnotherTestUser' 
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.Displayname

Exemplo 2: Definir todos os utilizadores, mas especificados, como menores com autorização parental

Get-AzureADUser -All $true | 
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } | 
ForEach-Object  { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }

Este comando atualiza a propriedade do utilizador especificado.

Parâmetros

-AccountEnabled

Indica se a conta está ativada.

Tipo:	Boolean
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AgeGroup

Utilizado por aplicações empresariais para determinar o grupo etário legal do utilizador. Esta propriedade é só de leitura e é calculada com base nas propriedades ageGroup e consentProvidedForMinor . Valores permitidos: null, minore adultnotAdult . Consulte as [definições de propriedade do grupo etário legal][Saiba mais sobre as definições de grupo etário e de consentimento secundário].

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-City

Especifica a cidade do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CompanyName

O nome da empresa ao qual o utilizador está associado. Esta propriedade pode ser útil para descrever a empresa de onde provém um utilizador externo. O comprimento máximo do nome da empresa é de 64 carateres.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConsentProvidedForMinor

Define se o consentimento foi obtido para menores. Valores permitidos: null, grantede notRequireddenied . Veja [legal age group property definitions][Saiba mais sobre a faixa etária e as definições de consentimento menor] para obter mais informações.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Country

Especifica o país ou região do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CreationType

Indica se a conta de utilizador é uma conta local de um inquilino do Azure Active Directory B2C. Os valores possíveis são "LocalAccount" e null. Ao criar uma conta local, a propriedade é necessária e tem de a definir como "LocalAccount". Ao criar uma conta escolar ou profissional, não especifique a propriedade nem defina-a como nula.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Department

Especifica o departamento do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

Especifica o nome a apresentar do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtensionProperty

Adicione dados a propriedades personalizadas do utilizador como extensões abertas básicas ou as extensões de esquema mais versáteis. Veja [mais sobre extensões][Saiba mais sobre extensões].

Tipo:	Dictionary<TKey,TValue>[System.String,System.String]
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FacsimileTelephoneNumber

O número de fax do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GivenName

Especifica o nome especificado pelo utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ImmutableId

Esta propriedade é utilizada para associar uma conta de utilizador do Active Directory no local ao objeto de utilizador do Azure AD. Esta propriedade tem de ser especificada ao criar uma nova conta de utilizador no Graph se estiver a utilizar um domínio federado para a propriedade do userPrincipalName utilizador (UPN). Importante: Os $ carateres e _ não podem ser utilizados ao especificar esta propriedade.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IsCompromised

Verdadeiro se este utilizador estiver comprometido

Tipo:	Boolean
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobTitle

Especifica o cargo do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MailNickName

Especifica uma alcunha para o endereço de correio do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Mobile

Especifica o número de telemóvel do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ObjectId

Especifica o ID de um utilizador (como UM UPN ou ObjectId) no Azure AD.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-OtherMails

Especifica outros endereços de e-mail para o utilizador.

Tipo:	List<T>[String]
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PasswordPolicies

Especifica políticas de palavra-passe para o utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PasswordProfile

Especifica o perfil de palavra-passe do utilizador.

Tipo:	PasswordProfile
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PhysicalDeliveryOfficeName

A localização do escritório no local de negócio do utilizador. O comprimento máximo é de 128 carateres.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PostalCode

Especifica o código postal do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PreferredLanguage

Especifica o idioma preferencial do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ShowInAddressList

Defina como Verdadeiro para mostrar este utilizador na lista de endereços.

Tipo:	Boolean
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SignInNames

A lista de nomes de início de sessão para este utilizador

Tipo:	List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-State

Especifica o estado do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StreetAddress

Especifica o endereço de rua do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Surname

Especifica o apelido do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TelephoneNumber

Especifica o número de telefone do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UsageLocation

Um indicativo de país ou região de duas letras (NORMA ISO 3166). Necessário para os utilizadores a quem serão atribuídas licenças devido a requisitos legais para verificar a disponibilidade de serviços em países e regiões. Os exemplos incluem: "US", "JP" e "GB". Não nulo.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserPrincipalName

Especifica o nome principal de utilizador do utilizador.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserState

Para um utilizador externo convidado para o inquilino através da API de convite, esta propriedade representa o estado de convite do utilizador convidado. Para utilizadores convidados, o estado pode ser PendingAcceptance ou Acceptedou , ou null para todos os outros utilizadores.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserStateChangedOn

Mostra o carimbo de data/hora da última alteração à propriedade externalUserState.

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserType

Um valor de cadeia que pode ser utilizado para classificar tipos de utilizador no seu diretório, como "Membro" e "Convidado".

Tipo:	String
Position:	Named
valor predefinido:	None
Necessário:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Notas

Veja o guia de migração de Set-AzureADUser para o Microsoft Graph PowerShell.

Partilhar via