New-AzureADUser

Módulo:

AzureADPreview

Cria um utilizador do 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 (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.

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

-AgeGroup

{{ Fill AgeGroup Description }}

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

{{ Fill CompanyName Description }}

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

-ConsentProvidedForMinor

{{ Fill ConsentProvidedForMinor Description }}

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-a como nula.

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

@{Text=}

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

{{Fill FacsimileTelephoneNumber Description}}

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

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

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", "JP" e "GB".

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

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

-UserState

{{ Fill UserState Description }}

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

-UserStateChangedOn

{{ Fill UserStateChangedOn Description }}

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