New-AzureADUser
Cria um usuário 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 usuário no Azure AD (Azure Active Directory).
Exemplos
Exemplo 1: Criar um usuário
$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
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
Isso especifica a faixa etária do usuário.
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
Isso especifica o nome da empresa do usuário.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ConsentProvidedForMinor
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 é necessária e você deve defini-la como LocalAccount
.
Ao criar uma conta corporativa ou de estudante, não especifique a propriedade ou defina-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
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
Isso especifica o número de telefone do usuário.
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 e-mail adicionais do 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.
Esse valor é uma enumeração com um valor possível sendo 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;
- crie uma variável no PowerShell com esse tipo:
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
- Defina o valor da senha nesta variável:
$PasswordProfile.Password = "\<Password\>"
- Por fim, passe 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 está habilitada ou desabilitada para esse 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 quando você cria um usuário de conta local. Não especifique-o 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).
Ele é 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
Especifica o nome principal do usuário (UPN).
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
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UserStateChangedOn
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 |
Observações
Consulte o guia de migração de New-AzureADUser para o Microsoft Graph PowerShell.