New-AzureADUser
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 MemberEste 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;
- crie uma variável no PowerShell com esse tipo:
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
- Defina o valor da palavra-passe nesta variável:
$PasswordProfile.Password = "\<Password\>"
- 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.