New-AzADUser

Sintaxe

WithPassword (Default)

New-AzADUser
    -DisplayName <String>
    -MailNickname <String>
    -UserPrincipalName <String>
    -Password <SecureString>
    [-AboutMe <String>]
    [-AccountEnabled <Boolean>]
    [-AgeGroup <String>]
    [-Birthday <DateTime>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DeviceEnrollmentLimit <Int32>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-HireDate <DateTime>]
    [-Interest <String[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MobilePhone <String>]
    [-MySite <String>]
    [-OfficeLocation <String>]
    [-ImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-PreferredName <String>]
    [-Responsibility <String[]>]
    [-School <String[]>]
    [-ShowInAddressList]
    [-Skill <String[]>]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-ForceChangePasswordNextLogin]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

WithPasswordProfile

New-AzADUser
    -DisplayName <String>
    -MailNickname <String>
    -UserPrincipalName <String>
    -PasswordProfile <IMicrosoftGraphPasswordProfile>
    [-AboutMe <String>]
    [-AccountEnabled <Boolean>]
    [-AgeGroup <String>]
    [-Birthday <DateTime>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DeviceEnrollmentLimit <Int32>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-HireDate <DateTime>]
    [-Interest <String[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MobilePhone <String>]
    [-MySite <String>]
    [-OfficeLocation <String>]
    [-ImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-PreferredName <String>]
    [-Responsibility <String[]>]
    [-School <String[]>]
    [-ShowInAddressList]
    [-Skill <String[]>]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: criar um usuário com o perfil de senha

$password = "xxxxxxxxxx"
$pp = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile" -Property @{Password=$password}
New-AzADUser -DisplayName $uname -PasswordProfile $pp -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Exemplo 2: Criar usuário com senha

$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
New-AzADUser -DisplayName $uname -Password $password -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Parâmetros

-AboutMe

Um campo de entrada de texto em forma livre para o usuário se descrever. Retornado somente em $select.

Propriedades do parâmetro

Conjuntos de parâmetros

-AccountEnabled

true para habilitar a conta; caso contrário, false.

Propriedades do parâmetro

Conjuntos de parâmetros

-AgeGroup

Define a faixa etária do usuário. Valores permitidos: nulo, menor, notAdult e adulto. Consulte as definições de propriedade da faixa etária legal para obter mais informações. Dá suporte a $filter (eq, ne, NOT e in).

Propriedades do parâmetro

Conjuntos de parâmetros

-Birthday

O aniversário do usuário. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1º de janeiro de 2014 é 2014-01T00:00:00Z Retornado somente em $select.

Propriedades do parâmetro

Conjuntos de parâmetros

-City

A cidade em que o usuário está localizado. O comprimento máximo é de 128 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-CompanyName

O nome da empresa que o usuário está associado. Essa propriedade pode ser útil para descrever a empresa de onde procede um usuário externo. O comprimento máximo do nome da empresa é de 64 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Conjuntos de parâmetros

-ConsentProvidedForMinor

Define se o consentimento foi obtido para menores. Valores permitidos: nulo, concedido, negado e não solicitado. Consulte as definições de propriedade da faixa etária legal para obter mais informações. Dá suporte a $filter (eq, ne, NOT e in).

Propriedades do parâmetro

Conjuntos de parâmetros

-Country

O país/região em que o usuário está localizado; por exemplo, EUA ou Reino Unido. O comprimento máximo é de 128 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com Azure.

Propriedades do parâmetro

Conjuntos de parâmetros

-DeletedDateTime

.

Propriedades do parâmetro

Conjuntos de parâmetros

-Department

O nome do departamento no qual o usuário trabalha. O comprimento máximo é de 64 caracteres. Dá suporte a $filter (operadores eq, ne, NOT, ge, le e in).

Propriedades do parâmetro

Conjuntos de parâmetros

-DeviceEnrollmentLimit

O limite do número máximo de dispositivos que o usuário tem permissão para inscrever. Os valores permitidos vão de 5 a 1000.

Propriedades do parâmetro

Conjuntos de parâmetros

-DisplayName

O nome exibido para o usuário no catálogo de endereços. Geralmente o valor é a combinação do nome, da inicial do nome do meio e do sobrenome do usuário. Essa propriedade é obrigatória quando um usuário é criado e não pode ser apagado durante atualizações. O comprimento máximo é de 256 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith), $orderBy e $search.

Propriedades do parâmetro

Conjuntos de parâmetros

-EmployeeHireDate

A data e a hora em que o usuário foi contratado ou iniciará o trabalho em caso de uma futura contratação. Dá suporte a $filter (eq, ne, NOT, ge, le, in).

Propriedades do parâmetro

Conjuntos de parâmetros

-EmployeeId

O identificador de funcionário atribuído ao usuário pela organização. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-EmployeeType

Captura o tipo de trabalhador corporativo. Por exemplo, Funcionário, Empreiteiro, Consultor ou Fornecedor. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-ExternalUserState

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. Para usuários convidados, o estado pode ser PendingAcceptance ou Accepted ou nulo para todos os outros usuários. Dá suporte a $filter (eq, ne, NOT , in).

Propriedades do parâmetro

Conjuntos de parâmetros

-ExternalUserStateChangeDateTime

Mostra o carimbo de hora da alteração mais recente da propriedade externalUserState. Dá suporte a $filter (eq, ne, NOT , in).

Propriedades do parâmetro

Conjuntos de parâmetros

-FaxNumber

O número de fax do usuário. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-ForceChangePasswordNextLogin

Ele deverá ser especificado se o usuário precisar alterar a senha no próximo logon bem-sucedido (true). O comportamento padrão é (false) para não alterar a senha no próximo logon bem-sucedido.

Propriedades do parâmetro

Conjuntos de parâmetros

-GivenName

O nome fornecido (nome) do usuário. O comprimento máximo é de 64 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-HireDate

A data de contratação do usuário. O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Retornado somente em $select. Observação: essa propriedade é específica para SharePoint Online. É recomendável usar a propriedade employeeHireDate nativa para definir e atualizar valores de data de contratação usando APIs de Microsoft Graph.

Propriedades do parâmetro

Conjuntos de parâmetros

-ImmutableId

Essa propriedade é usada para associar uma conta de usuário Active Directory local ao objeto de usuário do Azure AD. 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. OBSERVAÇÃO: os caracteres $ e _ não podem ser usados ao especificar essa propriedade. Retornado somente em $select. Dá suporte a $filter (eq, ne, NOT, ge, le, in)..

Propriedades do parâmetro

Conjuntos de parâmetros

-Interest

Uma lista para o usuário descrever os interesses dele. Retornado somente em $select.

Propriedades do parâmetro

Conjuntos de parâmetros

-IsResourceAccount

Não use - reservado para uso futuro.

Propriedades do parâmetro

Conjuntos de parâmetros

-JobTitle

O cargo do usuário. O comprimento máximo é de 128 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-Mail

O endereço SMTP do usuário, por exemplo, admin@contoso.com. As alterações nessa propriedade também atualizarão a coleção proxyAddresses do usuário para incluir o valor como um endereço SMTP. Embora essa propriedade possa conter caracteres de destaque, usá-los pode causar problemas de acesso com outros aplicativos Microsoft para o usuário. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-MailNickname

O alias de email do usuário. Essa propriedade deve ser especificada quando um usuário é criado. O comprimento máximo é de 64 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-MobilePhone

O número de celular principal do usuário. Somente leitura para usuários sincronizados do diretório local. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-MySite

A URL do site pessoal do usuário. Retornado somente em $select.

Propriedades do parâmetro

Conjuntos de parâmetros

-OfficeLocation

A localização do escritório no local de trabalho do usuário. O comprimento máximo é de 128 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-OtherMail

Uma lista de endereços de email adicionais para o usuário; por exemplo: [''bob@contoso.com, 'Robert@fabrikam.com']. OBSERVAÇÃO: embora essa propriedade possa conter caracteres de destaque, elas podem causar problemas de acesso a aplicativos de primeira parte para o usuário. Dá suporte a $filter (eq, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-Password

Senha do usuário. Ele deve atender aos requisitos de complexidade de senha do locatário. É recomendável definir uma senha forte.

Propriedades do parâmetro

Conjuntos de parâmetros

-PasswordPolicy

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.Supports $filter (ne, NOT).

Propriedades do parâmetro

Conjuntos de parâmetros

-PasswordProfile

passwordProfile Para construir, consulte a seção NOTES para propriedades PASSWORDPROFILE e crie uma tabela de hash.

Propriedades do parâmetro

Conjuntos de parâmetros

-PostalCode

O código postal do endereço postal do usuário. O código postal é específico para o país/região do usuário. No Estados Unidos da América, esse atributo contém o CEP. O comprimento máximo é de 40 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-PreferredLanguage

O idioma preferencial do usuário. Deve seguir o código ISO 639-1; por exemplo, en-US. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-PreferredName

O nome preferencial do usuário. Retornado somente em $select.

Propriedades do parâmetro

Conjuntos de parâmetros

-Responsibility

Uma lista para o usuário enumerar suas responsabilidades. Retornado somente em $select.

Propriedades do parâmetro

Conjuntos de parâmetros

-School

Uma lista para o usuário enumerar as escolas que frequentou. Retornado somente em $select.

Propriedades do parâmetro

Conjuntos de parâmetros

-ShowInAddressList

true se o Outlook lista de endereços global deve conter esse usuário, caso contrário, false. Se não estiver definido, isso será tratado como verdadeiro. Para usuários convidados por meio do gerenciador de convites, essa propriedade será definida como false. Dá suporte a $filter (eq, ne, NOT, in).

Propriedades do parâmetro

Conjuntos de parâmetros

-Skill

Uma lista para o usuário enumerar suas qualificações. Retornado somente em $select.

Propriedades do parâmetro

Conjuntos de parâmetros

-State

O estado ou município no endereço do usuário. O comprimento máximo é de 128 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-StreetAddress

O endereço do local de trabalho do usuário. O comprimento máximo é de 1024 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-Surname

O sobrenome do usuário (nome de família ou sobrenome). O comprimento máximo é de 64 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

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 receberão licenças devido a requisitos legais para verificar a disponibilidade de serviços em países. Os exemplos incluem: E.U.A., JP e GB. Não é anulável. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-UserPrincipalName

O nome principal de usuário (UPN) do usuário. O UPN é um nome de logon no estilo da Internet para o usuário com base no RFC 822 padrão da Internet. Por convenção, ele deve ser mapeado para o nome de email do usuário. O formato geral é alias@domain, onde o domínio deve estar presente na coleta de domínios verificados pelo locatário. Essa propriedade é obrigatória quando um usuário é criado. Os domínios verificados para o locatário podem ser acessados da propriedade verifiedDomains da organização. OBSERVAÇÃO: embora essa propriedade possa conter caracteres de destaque, elas podem causar problemas de acesso a aplicativos de primeira parte para o usuário. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) e $orderBy.

Propriedades do parâmetro

Conjuntos de parâmetros

-UserType

Um valor de cadeia de caracteres que pode ser usado para classificar tipos de usuário em seu diretório, como Membro e Convidado. Dá suporte a $filter (eq, ne, NOT, in,).

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Saídas

IMicrosoftGraphUser