New-AzADUser
Adiciona nova entidade aos usuários
Syntax
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 usuário com 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 usuário com perfil de senha
Exemplo 2: Criar usuário com senha
$password = "xxxxxxxxxx"
$password = ConvertTo-SecureString -AsPlainText -Force $password
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. Devolvido apenas no $select.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AccountEnabled
true para habilitar a conta; caso contrário, false.
Type: | Boolean |
Aliases: | EnableAccount |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgeGroup
Define a faixa etária do usuário. Valores permitidos: nulo, menor, nãoAdulto e adulto. Consulte as definições legais de propriedade de faixa etária para obter mais informações. Suporta $filter (eq, ne, NOT e in).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Birthday
O aniversário do usuário. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em hora UTC. Por exemplo, meia-noite UTC de 1 de janeiro de 2014 é 2014-01-01T00:00:00Z Retornado somente em $select.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
A cidade na qual o utilizador se encontra. O comprimento máximo é de 128 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompanyName
O nome da empresa à qual o usuário está associado. Esta propriedade pode ser útil para descrever a empresa de onde vem um usuário externo. O comprimento máximo do nome da empresa é de 64 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConsentProvidedForMinor
Define se o consentimento foi obtido para menores. Valores permitidos: null, granted, denied e notRequired. Consulte as definições legais de propriedade de faixa etária para obter mais informações. Suporta $filter (eq, ne, NOT e in).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Country
O país/região em que o utilizador está localizado; por exemplo, EUA ou Reino Unido. O comprimento máximo é de 128 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Type: | PSObject |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeletedDateTime
.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
O nome do departamento no qual o usuário trabalha. O comprimento máximo é de 64 caracteres. Suporta $filter (eq, ne, NOT, ge, le e em operadores).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceEnrollmentLimit
O limite do número máximo de dispositivos que o usuário tem permissão para registrar. Os valores permitidos são 5 ou 1000.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
O nome exibido no catálogo de endereços do usuário. Esse valor geralmente é a combinação do nome, da inicial do meio e do sobrenome do usuário. Essa propriedade é necessária quando um usuário é criado e não pode ser limpa durante as atualizações. O comprimento máximo é de 256 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith), $orderBy e $search.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EmployeeHireDate
A data e hora em que o usuário foi contratado ou começará a trabalhar em caso de uma futura contratação. Suporta $filter (eq, ne, NOT, ge, le, in).
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EmployeeId
O identificador de funcionário atribuído ao usuário pela organização. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EmployeeType
Captura o tipo de trabalhador da empresa. Por exemplo, Funcionário, Empreiteiro, Consultor ou Fornecedor. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExternalUserState
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. Para usuários convidados, o estado pode ser PendingAcceptance ou Accepted, ou null para todos os outros usuários. Suporta $filter (eq, ne, NOT, in).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExternalUserStateChangeDateTime
Mostra o carimbo de data/hora da alteração mais recente na propriedade externalUserState. Suporta $filter (eq, ne, NOT, in).
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FaxNumber
O número de fax do usuário. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceChangePasswordNextLogin
Deve ser especificado se o usuário deve alterar a senha no próximo login bem-sucedido (true). O comportamento padrão é (false) para não alterar a senha no próximo login bem-sucedido.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GivenName
O nome próprio (nome) do utilizador. O comprimento máximo é de 64 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HireDate
A data de contratação do usuário. O tipo de carimbo de data/hora representa informações de data e hora usando o formato ISO 8601 e está sempre em hora UTC. Por exemplo, meia-noite UTC de 1 de janeiro de 2014 é 2014-01-01T00:00:00Z. Devolvido apenas no $select. Nota: Esta propriedade é específica do SharePoint Online. Recomendamos usar a propriedade employeeHireDate nativa para definir e atualizar valores de data de contratação usando APIs do Microsoft Graph.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImmutableId
Essa propriedade é usada para associar uma conta de usuário do Ative 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. NOTA: Os caracteres $ e _ não podem ser usados ao especificar essa propriedade. Devolvido apenas no $select. Suporta $filter (eq, ne, NOT, ge, le, in)..
Type: | String |
Aliases: | OnPremisesImmutableId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Interest
Uma lista para o utilizador descrever os seus interesses. Devolvido apenas no $select.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsResourceAccount
Não usar - reservado para uso futuro.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobTitle
O cargo do usuário. O comprimento máximo é de 128 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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 acentuados, usá-los pode causar problemas de acesso com outros aplicativos da Microsoft para o usuário. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MobilePhone
O número de telefone celular principal do usuário. Somente leitura para usuários sincronizados a partir do diretório local. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MySite
O URL do site pessoal do utilizador. Devolvido apenas no $select.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OfficeLocation
A localização do escritório no local de negócios do usuário. O comprimento máximo é de 128 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OtherMail
Uma lista de endereços de e-mail adicionais para o usuário; por exemplo: ['bob@contoso.com', 'Robert@fabrikam.com']. Observação : embora essa propriedade possa conter caracteres de destaque, eles podem causar problemas de acesso a aplicativos primários para o usuário. Suporta $filter (eq, NOT, ge, le, in, startsWith).
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Password
A palavra-passe do utilizador. Ele deve atender aos requisitos de complexidade de senha do locatário. Recomenda-se definir uma senha forte.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 em conjunto; por exemplo: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordProfile
passwordProfile Para construir, consulte a seção NOTAS para propriedades PASSWORDPROFILE e crie uma tabela de hash.
Type: | IMicrosoftGraphPasswordProfile |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostalCode
O código postal do endereço postal do utilizador. O código postal é específico para o país/região do utilizador. Nos Estados Unidos da América, este atributo contém o código postal. O comprimento máximo é de 40 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredLanguage
O idioma preferido para o usuário. Deve seguir o código ISO 639-1; por exemplo, en-US. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredName
O nome preferido para o usuário. Devolvido apenas no $select.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Responsibility
Uma lista para o usuário enumerar suas responsabilidades. Devolvido apenas no $select.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-School
Uma lista para o usuário enumerar as escolas que frequentou. Devolvido apenas no $select.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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. Suporta $filter (eq, ne, NOT, in).
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Skill
Uma lista para o usuário enumerar suas habilidades. Devolvido apenas no $select.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
O estado ou província no endereço do usuário. O comprimento máximo é de 128 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StreetAddress
O endereço do estabelecimento comercial do utilizador. O comprimento máximo é de 1024 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Surname
O apelido do utilizador (apelido ou apelido). O comprimento máximo é de 64 caracteres. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UsageLocation
Um código de país de duas letras (norma 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. Exemplos incluem: EUA, JP e GB. Não anulável. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
O nome principal de utilizador (UPN). O UPN é um nome de login no estilo Internet para o usuário baseado no padrão da Internet RFC 822. Por convenção, isso deve ser mapeado para o nome de e-mail do usuário. O formato geral é alias@domain, onde o domínio deve estar presente na coleção de domínios verificados do locatário. Esta propriedade é necessária quando um usuário é criado. Os domínios verificados para o locatário podem ser acessados a partir da propriedade verifiedDomains da organização. Observação : embora essa propriedade possa conter caracteres de destaque, eles podem causar problemas de acesso a aplicativos primários para o usuário. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) e $orderBy.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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. Suporta $filter (eq, ne, NOT, in,).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Saídas
Notas
PSEUDÓNIMOS
PROPRIEDADES DE PARÂMETROS COMPLEXOS
Para criar os parâmetros descritos abaixo, construa uma tabela de hash contendo as propriedades apropriadas. Para obter informações sobre tabelas de hash, execute Get-Help about_Hash_Tables.
PASSWORDPROFILE <IMicrosoftGraphPasswordProfile>
: passwordProfile
[(Any) <Object>]
: Isso indica que qualquer propriedade pode ser adicionada a este objeto.[ForceChangePasswordNextSignIn <Boolean?>]
: true se o usuário deve alterar sua senha no próximo login; caso contrário, falso. Se não estiver definido, o padrão será false. NOTA: Para locatários B2C do Azure, defina como false e, em vez disso, use políticas personalizadas e fluxos de usuário para forçar a redefinição de senha no primeiro login. Consulte Forçar redefinição de senha no primeiro logon.[ForceChangePasswordNextSignInWithMfa <Boolean?>]
: Se verdadeiro, no próximo login, o usuário deve executar uma autenticação multifator (MFA) antes de ser forçado a alterar sua senha. O comportamento é idêntico a forceChangePasswordNextSignIn, exceto que o usuário é obrigado a executar primeiro uma autenticação multifator antes da alteração de senha. Após uma alteração de senha, essa propriedade será redefinida automaticamente para false. Se não estiver definido, o padrão será false.[Password <String>]
: A senha para o usuário. Esta propriedade é necessária quando um usuário é criado. Ele pode ser atualizado, mas o usuário será obrigado a alterar a senha no próximo login. A senha deve satisfazer os requisitos mínimos, conforme especificado pela propriedade passwordPolicies do usuário. Por padrão, uma senha forte é necessária.
Azure PowerShell
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