Share via


New-AzureADUser

Cria um utilizador do AD.

Syntax

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

Exemplos

Exemplo 1: Criar um utilizador

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

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AgeGroup

{{ Fill AgeGroup Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-City

Especifica a cidade do utilizador.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CompanyName

{{ Fill CompanyName Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConsentProvidedForMinor

{{ Fill ConsentProvidedForMinor Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Country

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

Type:String
Position:Named
Default value:None
Required: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Department

Especifica o departamento do utilizador.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Especifica o nome a apresentar do utilizador.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExtensionProperty

@{Text=}

Type:Dictionary<TKey,TValue>[System.String,System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FacsimileTelephoneNumber

{{Fill FacsimileTelephoneNumber Description}}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GivenName

Especifica o nome especificado pelo utilizador.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImmutableId

Esta propriedade é utilizada para associar uma conta de utilizador Active Directory no local ao respetivo objeto de utilizador 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsCompromised

Indica se este utilizador está comprometido.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobTitle

Especifica o cargo do utilizador.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailNickName

Especifica a alcunha de correio do utilizador.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Mobile

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OtherMails

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

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordPolicies

Especifica políticas de palavra-passe para o utilizador. Este valor é uma enumeração com um valor possível a ser "DisableStrongPassword", que permite que sejam especificadas palavras-passe mais fracas do que a política predefinida. Também é possível especificar "DisablePasswordExpiration". Os dois podem ser especificados em conjunto; por exemplo: "DisablePasswordExpiration, DisableStrongPassword".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 criar um vaidoso no PowerShell com esse tipo:

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

Em seguida, pode avançar para definir o valor da palavra-passe nesta variável:

$PasswordProfile.Password = "<Palavra-passe>"

Por fim, pode transmitir 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 de alteração de palavra-passe está inativa 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

Type:PasswordProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PhysicalDeliveryOfficeName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PostalCode

Especifica o código postal do utilizador.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferredLanguage

Especifica o idioma preferencial do utilizador.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowInAddressList

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-State

Especifica o estado do utilizador.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StreetAddress

Especifica o endereço de rua do utilizador.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Surname

Especifica o apelido do utilizador.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TelephoneNumber

Especifica um número de telefone.

Type:String
Position:Named
Default value:None
Required: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".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserPrincipalName

O nome principal de utilizador (UPN). 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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserState

{{ Fill UserState Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserStateChangedOn

{{ Fill UserStateChangedOn Description }}

Type:String
Position:Named
Default value:None
Required: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".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False