New-AzureADUser

  • Referência
Módulo:
AzureAD

Cria um utilizador do Azure AD.

Sintaxe

New-AzureADUser
   [-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 New-AzureADUser cria um utilizador no Azure Active Directory (Azure AD).

Exemplos

Exemplo 1: Criar um utilizador

$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$PasswordProfile.Password = "<Password>"
New-AzureADUser -DisplayName "New User" -PasswordProfile $PasswordProfile -UserPrincipalName "NewUser@contoso.com" -AccountEnabled $true -MailNickName "Newuser"

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user    NewUser@contoso.com             Member

Este comando cria um novo utilizador.

Parâmetros

-AccountEnabled

Indica se a conta do utilizador está ativada.

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

-AgeGroup

Isto especifica a faixa etária do utilizador.

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

-City

Especifica a cidade do utilizador.

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

-CompanyName

Isto especifica o nome da empresa do utilizador.

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

-ConsentProvidedForMinor

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

-Country

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

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

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

-Department

Especifica o departamento do utilizador.

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

-DisplayName

Especifica o nome a apresentar do utilizador.

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

-ExtensionProperty

Tipo:Dictionary<TKey,TValue>[System.String,System.String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FacsimileTelephoneNumber

Isto especifica o número de telefone do utilizador.

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

-GivenName

Especifica o nome especificado pelo utilizador.

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

Importante: os $ carateres e _ não podem ser utilizados ao especificar esta propriedade.

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

-IsCompromised

Indica se este utilizador está comprometido.

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

-JobTitle

Especifica o cargo do utilizador.

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

-MailNickName

Especifica a alcunha de correio do utilizador.

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

-Mobile

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

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

-OtherMails

Uma lista de endereços de e-mail adicionais para o utilizador. Por exemplo, bob@contoso.com, Robert@fabrikam.com.

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

-PasswordPolicies

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

Este valor é uma enumeração com um valor possível, que DisableStrongPasswordpermite 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".

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

-PasswordProfile

Especifica o perfil de palavra-passe do utilizador. Tenha em atenção que o tipo de parâmetro para este parâmetro é PasswordProfile. Para transmitir um parâmetro deste tipo, primeiro tem de o fazer;

  1. crie uma variável no PowerShell com esse tipo:

$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile

  1. Defina o valor da palavra-passe nesta variável:

$PasswordProfile.Password = "\<Password\>"

  1. Por fim, transmita esta variável para o cmdlet:

New-AzureADUser -PasswordProfile $PasswordProfile ...

Outros atributos que podem ser definidos no PasswordProfile são:

  • $PasswordProfile.EnforceChangePasswordPolicy - um booleano que indica que a política alterar palavra-passe está ativada ou desativada para este utilizador.
  • $PasswordProfile.ForceChangePasswordNextLogin - um booleano que indica que o utilizador tem de alterar a palavra-passe no próximo início de sessão.
Tipo:PasswordProfile
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PhysicalDeliveryOfficeName

Especifica o nome do escritório de entrega física do utilizador.

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

-PostalCode

Especifica o código postal do utilizador.

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

-PreferredLanguage

Especifica o idioma preferencial do utilizador.

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

-ShowInAddressList

Se for Verdadeiro, mostre este utilizador na lista de endereços.

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

-SignInNames

Especifica a coleção de nomes de início de sessão para uma conta local num inquilino do Azure Active Directory B2C.

Cada nome de início de sessão tem de ser exclusivo em toda a empresa/inquilino. A propriedade tem de ser especificada quando cria um utilizador de conta local. Não o especifique quando criar uma conta escolar ou profissional.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-State

Especifica o estado do utilizador.

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

-StreetAddress

Especifica o endereço de rua do utilizador.

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

-Surname

Especifica o apelido do utilizador.

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

-TelephoneNumber

Especifica um número de telefone.

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

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

-UserPrincipalName

Especifica o nome principal (UPN) do utilizador.

O UPN é um nome de início de sessão de estilo Internet para o utilizador com base no RFC 822 padrão da Internet. Por convenção, isto deve ser mapeado para o nome de e-mail do utilizador. O formato geral é alias@domain.

Para contas escolares ou profissionais, o domínio tem de estar presente na coleção de domínios verificados do inquilino. Esta propriedade é necessária quando é criada uma conta escolar ou profissional; é opcional para contas locais.

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

-UserState

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

-UserStateChangedOn

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

Notas

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