New-AzADUser
Adiciona nova entidade aos usuários
Sintaxe
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>]
New-AzADUser
-DisplayName <String>
-MailNickname <String>
-UserPrincipalName <String>
[-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>]
-PasswordProfile <IMicrosoftGraphPasswordProfile>
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Adiciona nova entidade aos usuários
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
Criar um usuário com perfil de senha
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
Criar usuário com senha
Parâmetros
-AboutMe
Um campo de entrada de texto de forma livre para o usuário se descrever. Retornado somente em $select.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-AccountEnabled
true para habilitar a conta; caso contrário, false.
Tipo: | Boolean |
Aliases: | EnableAccount |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Birthday
O aniversário do usuário. O tipo carimbo de data/hora 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.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-City
A cidade na qual o usuário está localizado. O comprimento máximo é de 128 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-CompanyName
O nome da empresa que o usuário está associado. Essa propriedade pode ser útil para descrever a empresa da qual um usuário externo vem. O comprimento máximo do nome da empresa é de 64 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Tipo: | PSObject |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DeletedDateTime
.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DeviceEnrollmentLimit
O limite no número máximo de dispositivos que o usuário tem permissão para registrar. Os valores permitidos são 5 ou 1000.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisplayName
O nome exibido no catálogo de endereços do usuário. Esse valor geralmente é a combinação do nome do usuário, da inicial do meio e do sobrenome. Essa propriedade é necessária quando um usuário é criado e não pode ser desmarcada durante as atualizações. O comprimento máximo é de 256 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith), $orderBy e $search.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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).
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-EmployeeType
Captura o tipo de trabalho corporativo. Por exemplo, Funcionário, Empreiteiro, Consultor ou Fornecedor. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ExternalUserStateChangeDateTime
Mostra o carimbo de data/hora da última alteração na propriedade externalUserState. Dá suporte a $filter (eq, ne, NOT , in).
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-FaxNumber
O número de fax do usuário. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-HireDate
A data de contratação do usuário. O tipo carimbo de data/hora 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-01-01T00:00:00Z. Retornado somente em $select. Observação: essa propriedade é específica do SharePoint Online. É recomendável usar a propriedade employeeHireDate nativa para definir e atualizar valores de data de contratação usando APIs do Microsoft Graph.
Tipo: | DateTime |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ImmutableId
Essa propriedade é usada para associar uma conta de usuário do 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)..
Tipo: | String |
Aliases: | OnPremisesImmutableId |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Interest
Uma lista para o usuário descrever seus interesses. Retornado somente em $select.
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-IsResourceAccount
Não use - reservado para uso futuro.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-JobTitle
O cargo do usuário. O comprimento máximo é de 128 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
O endereço SMTP para o 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 da Microsoft para o usuário. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MailNickname
O alias de email para o 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).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MobilePhone
O número de telefone celular primário para o usuário. Somente leitura para usuários sincronizados do diretório local. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MySite
A URL do site pessoal do usuário. Retornado somente em $select.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-OfficeLocation
O local do escritório no local de negócios do usuário. O comprimento máximo é de 128 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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).
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Password
Senha para o usuário. Ele deve atender aos requisitos de complexidade de senha do locatário. É recomendável definir uma senha forte.
Tipo: | SecureString |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PasswordPolicy
Especifica políticas de senha para o 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).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PasswordProfile
passwordProfile Para construir, consulte a seção NOTES para propriedades PASSWORDPROFILE e crie uma tabela de hash.
Tipo: | IMicrosoftGraphPasswordProfile |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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. Nos 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).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PreferredLanguage
O idioma preferencial para o 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).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-PreferredName
O nome preferencial para o usuário. Retornado somente em $select.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Responsibility
Uma lista para o usuário enumerar suas responsabilidades. Retornado somente em $select.
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-School
Uma lista para o usuário enumerar as escolas que frequentou. Retornado somente em $select.
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ShowInAddressList
true se a lista de endereços global do Outlook 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).
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Skill
Uma lista para o usuário enumerar suas habilidades. Retornado somente em $select.
Tipo: | String[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-State
O estado ou a província no endereço do usuário. O comprimento máximo é de 128 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-StreetAddress
O endereço de rua do local de negócios do usuário. O comprimento máximo é de 1.024 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Surname
O sobrenome do usuário (nome da família ou sobrenome). O comprimento máximo é de 64 caracteres. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UsageLocation
Um código de país de duas letras (ISO standard 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: EUA, JP e GB. Não é anulável. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UserPrincipalName
O UPN (nome de entidade de usuário) 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, isso deve ser mapeado para o nome de email do usuário. O formato geral é alias@domain, em que o domínio deve estar presente na coleção de domínios verificados do locatário. Essa propriedade é necessá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.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-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,).
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Saídas
Azure PowerShell