New-AzureADUser
Cria um utilizador do Azure 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 (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 Member
Este comando cria um novo utilizador.
Parâmetros
-AccountEnabled
Indica se a conta do utilizador está ativada.
Tipo: | Boolean |
Position: | Named |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgeGroup
Isto especifica a faixa etária do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
Especifica a cidade do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompanyName
Isto especifica o nome da empresa do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConsentProvidedForMinor
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Country
Especifica o país ou região do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | 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 como null
.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
Especifica o departamento do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Especifica o nome a apresentar do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtensionProperty
Tipo: | Dictionary<TKey,TValue>[System.String,System.String] |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FacsimileTelephoneNumber
Isto especifica o número de telefone do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GivenName
Especifica o nome especificado pelo utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsCompromised
Indica se este utilizador está comprometido.
Tipo: | Boolean |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobTitle
Especifica o cargo do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MailNickName
Especifica a alcunha de correio do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mobile
Especifica o número de telemóvel do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | 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
.
Tipo: | List<T>[String] |
Position: | Named |
valor predefinido: | None |
Necessário: | 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, que DisableStrongPassword
permite 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 |
valor predefinido: | None |
Necessário: | 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 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 |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhysicalDeliveryOfficeName
Especifica o nome do escritório de entrega física do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostalCode
Especifica o código postal do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredLanguage
Especifica o idioma preferencial do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowInAddressList
Se for Verdadeiro, mostre este utilizador na lista de endereços.
Tipo: | Boolean |
Position: | Named |
valor predefinido: | None |
Necessário: | 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.
Tipo: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Especifica o estado do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StreetAddress
Especifica o endereço de rua do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Surname
Especifica o apelido do utilizador.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TelephoneNumber
Especifica um número de telefone.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | 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
.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserState
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserStateChangedOn
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | 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".
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Notas
Veja o guia de migração de New-AzureADUser para o Microsoft Graph PowerShell.
Ligações Relacionadas
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários