New-AzureADUser

Módulo:

AzureADPreview

Cria um usuário 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 usuário no Azure Active Directory (AD).

Exemplos

Exemplo 1: Criar um usuário

-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

Esse comando cria um novo usuário.

Parâmetros

-AccountEnabled

Indica se a conta do usuário está habilitada.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AgeGroup

{{ Fill AgeGroup Description }}

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-City

Especifica a cidade do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CompanyName

{{ Fill CompanyName Description }}

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ConsentProvidedForMinor

{{ Fill ConsentProvidedForMinor Description }}

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Country

Especifica o país ou a região do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CreationType

Indica se a conta de usuário é uma conta local para um locatário do Azure Active Directory B2C. Os valores possíveis são "LocalAccount" e null. Ao criar uma conta local, a propriedade é obrigatória e você deve configurá-la como "LocalAccount". Ao criar uma conta corporativa ou de estudante, não especifique a propriedade ou configure-a como null.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Department

Especifica o departamento do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DisplayName

Especifica o nome de exibição do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ExtensionProperty

@{Text=}

Tipo:	Dictionary<TKey,TValue>[System.String,System.String]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-FacsimileTelephoneNumber

{{Fill FacsimileTelephoneNumber Description}}

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-GivenName

Especifica o nome fornecido pelo usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ImmutableId

Esta propriedade é usada para associar uma conta de usuário no Active Directory local ao seu objeto de usuário do AD do Azure. 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.

Importante: os caracteres $ e _ não podem ser usados ao especificar essa propriedade.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-IsCompromised

Indica se esse usuário está comprometido.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-JobTitle

Especifica o cargo do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-MailNickName

Especifica o apelido de email do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Mobile

Especifica o número de telefone celular do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-OtherMails

Uma lista de endereços de email adicionais para o usuário; por exemplo: "bob@contoso.com", "Robert@fabrikam.com".

Tipo:	List<T>[String]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PasswordPolicies

Especifica as políticas de senha do usuário. Este valor é uma enumeração com um valor possível "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 juntos, por exemplo: "DisablePasswordExpiration, DisableStrongPassword".

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PasswordProfile

Especifica o perfil de senha do usuário. Observe que o tipo de parâmetro para esse parâmetro é "PasswordProfile". para passar um parâmetro desse tipo, primeiro você precisa criar um vairable no PowerShell com esse tipo:

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

Em seguida, você pode definir o valor da senha nesta variável:

$PasswordProfile.Password = "<Password>"

Por fim, você pode passar essa variável para o cmdlet:

New-AzureADUser -PasswordProfile $PasswordProfile ...

Outros atributos que podem ser definidos no PasswordProfile são

$PasswordProfile.EnforceChangePasswordPolicy - um booliano que indica que a política de alteração de senha é enababled ou desabilitada para este usuário $PasswordProfile.ForceChangePasswordNextLogin - um booliano que indica que o usuário deve alterar a senha na próxima entrada

Tipo:	PasswordProfile
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PhysicalDeliveryOfficeName

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

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PostalCode

Especifica o código postal do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PreferredLanguage

Especifica o idioma preferido do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ShowInAddressList

Se True, mostre esse usuário na lista de endereços.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SignInNames

Especifica a coleção de nomes de entrada para uma conta local em um locatário do Azure Active Directory B2C. Cada nome de entrada deve ser exclusivo na empresa/locatário. A propriedade deve ser especificada ao um usuário de conta local, não a especifique ao criar uma conta corporativa ou de estudante.

Tipo:	List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-State

Especifica o estado do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-StreetAddress

Especifica o endereço de rua do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Surname

Especifica o sobrenome do usuário.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TelephoneNumber

Especifica um número de telefone.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UsageLocation

Um código de país ou região de duas letras (ISO padrão 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 e regiões. Os exemplos incluem: "US", "JP" e "GB".

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UserPrincipalName

O UPN (nome principal do usuário) do usuário. O UPN é um nome de entrada de um usuário, no estilo da Internet, para o usuário com base no padrão RFC 822 da Internet. Por convenção, ele deve ser mapeado para o nome de email do usuário. O formato geral é "alias@domain". Para contas corporativas ou de estudante, o domínio deve estar presente na coleção de domínios verificados do locatário. Esta propriedade é obrigatória ao criar uma conta corporativa ou de estudante, é opcional para contas locais.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UserState

{{ Preencher UserState Description }}

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UserStateChangedOn

{{ Preencher UserStateChangedOn Description }}

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UserType

Um valor de cadeia de caracteres que pode ser usado para classificar os tipos de usuário em seu diretório, como "Member" e "Guest".

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False