New-EntraUser

Sintaxe

Default (Predefinição)

New-EntraUser

    -DisplayName <String>
    -AccountEnabled <Boolean>
    -PasswordProfile <PasswordProfile>
    [-City <String>]
    [-UserStateChangedOn <String>]
    [-CompanyName <String>]
    [-PreferredLanguage <String>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Mobile <String>]
    [-UsageLocation <String>]
    [-PostalCode <String>]
    [-AgeGroup <String>]
    [-CreationType <String>]
    [-ConsentProvidedForMinor <String>]
    [-MailNickName <String>]
    [-ImmutableId <String>]
    [-Country <String>]
    [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
    [-Department <String>]
    [-PasswordPolicies <String>]
    [-JobTitle <String>]
    [-UserState <String>]
    [-UserType <String>]
    [-OtherMails <System.Collections.Generic.List`1[System.String]>]
    [-UserPrincipalName <String>]
    [-State <String>]
    [-StreetAddress <String>]
    [-BusinessPhones <String>]
    [-Surname <String>]
    [-ShowInAddressList <Boolean>]
    [<CommonParameters>]

Descrição

Exemplos

Exemplo 1: Criar um utilizador usando o parâmetro MailNickName

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$userParams = @{
    DisplayName       = 'Avery Iona'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'AveryI@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'averyi'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Avery Iona    AveryI@contoso.com             Member

Exemplo 2: Criar um utilizador usando o parâmetro AgeGroup

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'

$userParams = @{
    DisplayName       = 'Peyton Davis'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'PeytonD@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'PeytonD'
    AgeGroup          = 'adult'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
bbbbbbbb-1111-2222-3333-cccccccccccc Peyton Davis    PeytonD@contoso.com             Member

Exemplo 3: Criar um utilizador usando o parâmetro City

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'

$userParams = @{
    DisplayName       = 'Blake Martin'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'BlakeM@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'BlakeM'
    City              = 'New York'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
cccccccc-2222-3333-4444-dddddddddddd Blake Martin    BlakeM@contoso.com             Member

Exemplo 4: Criar um utilizador usando o parâmetro Department

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$userParams = @{
    DisplayName       = 'Parker Jones'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'ParkerJ@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'ParkerJ'
    Department        = 'IT'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
dddddddd-3333-4444-5555-eeeeeeeeeeee Parker Jones    ParkerJ@contoso.com             Member

Exemplo 5: Criar um utilizador usando o parâmetro Mobile

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'

$UserParams = @{
    DisplayName        = 'Sawyer Miller'
    PasswordProfile    = $passwordProfile
    UserPrincipalName  = 'SawyerM@contoso.com'
    AccountEnabled     = $true
    MailNickName       = 'SawyerM'
    Mobile             = '+18989898989'
}

New-EntraUser @UserParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
eeeeeeee-4444-5555-6666-ffffffffffff Sawyer Miller    SawyerM@contoso.com             Member

Parâmetros

-AccountEnabled

Indica se a conta do utilizador está ativada.

Propriedades dos parâmetros

Conjuntos de parâmetros

-AgeGroup

Especifica o grupo etário do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-BusinessPhones

Especifica um número de telefone.

Propriedades dos parâmetros

Conjuntos de parâmetros

-City

Especifica a cidade do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CompanyName

Especifica o nome da empresa do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ConsentProvidedForMinor

Define se o consentimento foi obtido para menores.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Country

Especifica o país do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CreationType

Indica se a conta de utilizador é uma conta local para um inquilino B2C do Microsoft Entra ID. Os valores possíveis são "LocalAccount" e nulo.

• Ao criar uma conta local, a propriedade é necessária e deve defini-la como "LocalAccount".
• Ao criar uma conta de trabalho ou de escola, não especifique a propriedade nem a defina como null.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Department

Especifica o departamento do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-DisplayName

Especifica o nome de exibição do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-FaxNumber

Especifica o número de fax do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-GivenName

Especifica o nome próprio do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ImmutableId

Esta propriedade liga uma conta de utilizador local ao seu objeto Microsoft Entra ID e é necessária ao criar um novo utilizador no Microsoft Graph se o userPrincipalName (UPN) do utilizador estiver num domínio federado.

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-JobTitle

Especifica o cargo do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-MailNickName

Especifica o apelido de email do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Mobile

Especifica o número de telemóvel do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-OtherMails

Uma lista de outros endereços de email para o utilizador; por exemplo: "bob@contoso.com", "Robert@fabrikam.com".

Propriedades dos parâmetros

Conjuntos de parâmetros

-PasswordPolicies

Especifica políticas de palavra-passe para o utilizador. Este valor é uma enumeração com um valor possível sendo "DisableStrongPassword", que permite especificar palavras-passe mais fracas do que a política padrão. "DisablePasswordExpiration" também pode ser especificado. Os dois podem ser especificados em conjunto; por exemplo: "DisablePasswordExpiration, DisableStrongPassword".

Propriedades dos parâmetros

Conjuntos de parâmetros

-PasswordProfile

Especifica o perfil de palavra-passe do utilizador.

O tipo de parâmetro para este parâmetro é "PasswordProfile".

Para passar um parâmetro deste tipo, primeiro precisa de criar uma variável no PowerShell com esse tipo:

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

Depois pode avançar para definir o valor da palavra-passe nesta variável:

$passwordProfile.Password = "<Password>"

E, finalmente, pode passar esta variável ao cmdlet:

New-EntraUser -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á ativada ou desativada para este utilizador $passwordProfile.

• ForceChangePasswordNextLogin - um booleano que indica que o utilizador deve alterar a palavra-passe no próximo login.

Propriedades dos parâmetros

Conjuntos de parâmetros

-PostalCode

Especifica o código postal do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-PreferredLanguage

Especifica a linguagem preferida do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ShowInAddressList

Se for Verdadeiro, mostre este utilizador na lista de endereços.

Propriedades dos parâmetros

Conjuntos de parâmetros

-SignInNames

Especifica a coleção de nomes de início de sessão para uma conta local num tenant B2C do Microsoft Entra ID.

Cada nome de login deve ser único na empresa/inquilino.

A propriedade deve ser especificada quando cria um utilizador de conta local; Não especifiquem isso quando criarem uma conta de trabalho ou de escola.

Propriedades dos parâmetros

Conjuntos de parâmetros

-State

Especifica o estado do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-StreetAddress

Especifica a morada do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Surname

Especifica o apelido do utilizador.

Propriedades dos parâmetros

Conjuntos de parâmetros

-UsageLocation

Um código de país de duas letras (norma ISO 3166).

Obrigatório para utilizadores que recebem licenças devido à exigência legal de verificar a disponibilidade de serviços nos países.

Exemplos incluem: "US", "JP" e "GB".

Propriedades dos parâmetros

Conjuntos de parâmetros

-UserPrincipalName

O nome principal de utilizador (User Principal Name - UPN).

O UPN é um nome de início de sessão ao estilo da Internet para o utilizador com base no RFC 822 padrão da Internet.

Por convenção, este UPN deve corresponder ao nome do email do utilizador.

O formato geral é "alias@domain".

Para contas de trabalho ou escola, o domínio deve estar presente na coleção de domínios verificados do inquilino.

Esta propriedade é necessária quando é criada uma conta de trabalho ou escolar; É opcional para contas locais.

Propriedades dos parâmetros

Conjuntos de parâmetros

-UserState

Para um usuário externo convidado para o locatário usando a API de convite, essa propriedade representa o status de convite do usuário convidado.

Propriedades dos parâmetros

Conjuntos de parâmetros

-UserStateChangedOn

Mostra o carimbo temporal da última alteração à propriedade userState.

Propriedades dos parâmetros

Conjuntos de parâmetros

-UserType

Um valor de cadeia que pode ser usado para classificar tipos de utilizador no seu diretório, como "Membro" e "Convidado".

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Ligações Relacionadas

• Get-EntraUser
• Remove-EntraUser
• Set-EntraUser