New-EntraUser

Sintaxe

Default (Default)

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>]

Description

Exemplos

Exemplo 1: criar um usuário 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 usuário 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 usuário 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 usuário 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 usuário 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 usuário está habilitada.

Propriedades do parâmetro

Conjuntos de parâmetros

-AgeGroup

Especifica a faixa etária do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-BusinessPhones

Especifica um número de telefone.

Propriedades do parâmetro

Conjuntos de parâmetros

-City

Especifica a cidade do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-CompanyName

Especifica o nome da empresa do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-ConsentProvidedForMinor

Define se o consentimento foi obtido para menores.

Propriedades do parâmetro

Conjuntos de parâmetros

-Country

Especifica o país do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-CreationType

Indica se a conta de usuário é uma conta local para um locatário Microsoft Entra ID B2C. Os valores possíveis são "LocalAccount" e nulo.

• 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 nula.

Propriedades do parâmetro

Conjuntos de parâmetros

-Department

Especifica o departamento do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-DisplayName

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

Propriedades do parâmetro

Conjuntos de parâmetros

-FaxNumber

Especifica o número de fax do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-GivenName

Especifica o nome fornecido pelo usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-ImmutableId

Essa propriedade vincula uma conta de usuário local ao objeto Microsoft Entra ID e é necessária ao criar um novo usuário no Microsoft Graph se o UPN (userPrincipalName) do usuário estiver em um domínio federado.

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

Propriedades do parâmetro

Conjuntos de parâmetros

-JobTitle

Especifica o cargo do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-MailNickName

Especifica o apelido de email do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-Mobile

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

Propriedades do parâmetro

Conjuntos de parâmetros

-OtherMails

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

Propriedades do parâmetro

Conjuntos de parâmetros

-PasswordPolicies

Especifica as políticas de senha do usuário. Este valor é uma enumeração com um possível valor sendo "DisableStrongPassword", que permite especificar as senhas mais fracas do que a política padrão. O "DisablePasswordExpiration" também pode ser especificado. Os dois podem ser especificados juntos; por exemplo: "DisablePasswordExpiration, DisableStrongPassword".

Propriedades do parâmetro

Conjuntos de parâmetros

-PasswordProfile

Especifica o perfil de senha do usuário.

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

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

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

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

$passwordProfile.Password = "<Password>"

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

New-EntraUser -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 é eabilitada ou desabilitada para este usuário $passwordProfile.

• ForceChangePasswordNextLogin - um booliano que indica que o usuário deve alterar a senha na próxima entrada.

Propriedades do parâmetro

Conjuntos de parâmetros

-PostalCode

Especifica o código postal do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-PreferredLanguage

Especifica o idioma preferencial do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-ShowInAddressList

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

Propriedades do parâmetro

Conjuntos de parâmetros

-SignInNames

Especifica a coleção de nomes de entrada para uma conta local em um locatário Microsoft Entra ID B2C.

Cada nome de entrada deve ser exclusivo em toda a empresa/locatário.

A propriedade deve ser especificada quando você cria um usuário de conta local; não especifique quando você cria uma conta corporativa ou de estudante.

Propriedades do parâmetro

Conjuntos de parâmetros

-State

Especifica o estado do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-StreetAddress

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Surname

Especifica o sobrenome do usuário.

Propriedades do parâmetro

Conjuntos de parâmetros

-UsageLocation

Um código de duas letras (padrão ISO 3166).

Necessário para usuários que recebem licenças devido a requisitos legais para verificar a disponibilidade de serviços em países.

Os exemplos incluem: "US", "JP" e "GB".

Propriedades do parâmetro

Conjuntos de parâmetros

-UserPrincipalName

O nome principal de usuário (UPN) do usuário.

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, esse UPN 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.

Essa propriedade é necessária quando uma conta corporativa ou de estudante é criada; é opcional para contas locais.

Propriedades do parâmetro

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 do convite do usuário convidado.

Propriedades do parâmetro

Conjuntos de parâmetros

-UserStateChangedOn

Mostra o carimbo de data/hora da última alteração na propriedade userState.

Propriedades do parâmetro

Conjuntos de parâmetros

-UserType

Um valor de cadeia de caracteres que pode ser usado para classificar tipos de usuários no seu diretório, como “Membro” e “Convidado”.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Links Relacionados

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