New-MsolUser
Cria um usuário para o Azure Active Directory.
Sintaxe
New-MsolUser
[-ImmutableId <String>]
[-UserPrincipalName <String>]
[-BlockCredential <Boolean>]
[-City <String>]
[-Country <String>]
[-Department <String>]
[-DisplayName <String>]
[-Fax <String>]
[-FirstName <String>]
[-LastName <String>]
[-LastPasswordChangeTimestamp <DateTime>]
[-MobilePhone <String>]
[-Office <String>]
[-PasswordNeverExpires <Boolean>]
[-PhoneNumber <String>]
[-PostalCode <String>]
[-PreferredDataLocation <String>]
[-PreferredLanguage <String>]
[-SoftDeletionTimestamp <DateTime>]
[-State <String>]
[-StreetAddress <String>]
[-StrongPasswordRequired <Boolean>]
[-Title <String>]
[-UsageLocation <String>]
[-AlternateEmailAddresses <String[]>]
[-StrongAuthenticationMethods <StrongAuthenticationMethod[]>]
[-AlternateMobilePhones <String[]>]
[-StrongAuthenticationRequirements <StrongAuthenticationRequirement[]>]
[-StsRefreshTokensValidFrom <DateTime>]
[-UserType <UserType>]
[-Password <String>]
[-LicenseOptions <LicenseOption[]>]
[-ForceChangePassword <Boolean>]
[-LicenseAssignment <String[]>]
[-TenantId <Guid>]
[<CommonParameters>] Description
O cmdlet New-MsolUser cria um usuário no Azure Active Directory. Para dar ao usuário acesso aos serviços, atribua uma licença usando o parâmetro LicenseAssignment .
Exemplos
Exemplo 1: Criar um usuário
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew"Esse comando cria um usuário. O usuário não tem nenhuma licença atribuída. Uma senha aleatória é gerada para o usuário.
Exemplo 2: Criar um usuário e atribuir uma licença
Observação
O parâmetro -LicenseAssignment foi preterido. Saiba como atribuir licenças com o Microsoft Graph PowerShell. Para obter mais informações, consulte a API Atribuir Licença do Microsoft Graph.
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew" -UsageLocation "US" -LicenseAssignment "Contoso:BPOS_Standard"Esse comando cria um novo usuário e atribui uma licença.
Exemplo 3: Criar um usuário e um local de dados preferencial
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" -DisplayName "David" -PreferredDataLocation "EUR"Esse comando cria um usuário cujo nome de entidade de usuário é jdavidchew@contoso.onmicrosoft.com, o nome de exibição é David e o local de dados preferido é EUR.
Parâmetros
-AlternateEmailAddresses
Especifica endereços de email alternativos para o usuário.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-AlternateMobilePhones
Especifica números de telefone celular alternativos para o usuário.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-BlockCredential
Especifica se o usuário não consegue fazer logon usando sua ID de usuário.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | $false |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-City
Especifica a cidade do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Country
Especifica o país ou a região do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Department
Especifica o departamento do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-DisplayName
Especifica o nome de exibição do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Fax
Especifica o número de fax do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-FirstName
Especifica o nome do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-ForceChangePassword
Indica que o usuário deve alterar sua senha na próxima vez que entrar.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | $true |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-ImmutableId
Especifica a ID imutável da identidade federada do usuário. Isso deve ser omitido para usuários com identidades padrão.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-LastName
Especifica o sobrenome do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-LastPasswordChangeTimestamp
Especifica uma hora em que a senha foi alterada pela última vez.
| Tipo: | DateTime |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-LicenseAssignment
Especifica uma matriz de licenças para atribuir o usuário.
Observação
O parâmetro -LicenseAssignment foi preterido. Saiba como atribuir licenças com o Microsoft Graph PowerShell. Para obter mais informações, consulte a API Atribuir Licença do Microsoft Graph.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-LicenseOptions
Especifica as opções de atribuição de licença. Usado para desabilitar seletivamente planos de serviço individuais em um SKU.
| Tipo: | LicenseOption[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-MobilePhone
Especifica o número de telefone celular do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Office
Especifica o escritório do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Password
Especifica a nova senha para o usuário. Se o usuário estiver definido para requerer uma senha forte, então todas as seguinte regras devem ser atendidas:
- A senha deve conter pelo menos uma letra minúscula
- A senha deve conter pelo menos uma letra maiúscula
- A senha deve conter pelo menos um caractere não alfanumérico
- A senha não pode conter espaços, guias ou quebras de linha
- O comprimento da senha deve ser de 8 a 16 caracteres
- O nome de usuário não pode ser contido na senha
Se esse valor for omitido, uma senha aleatória será atribuída ao usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-PasswordNeverExpires
Especifica se a senha do usuário expira periodicamente.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | $false |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-PhoneNumber
Especifica o número de telefone do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-PostalCode
Especifica o código postal do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-PreferredDataLocation
Especifica o local de dados preferencial para o usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-PreferredLanguage
Especifica o idioma preferencial do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-SoftDeletionTimestamp
Especifica um tempo para exclusão temporária.
| Tipo: | DateTime |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-State
Especifica o estado ou a província em que o usuário está localizado.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-StreetAddress
Especifica o endereço de rua do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-StrongAuthenticationMethods
Especifica uma matriz de métodos de autenticação forte.
| Tipo: | StrongAuthenticationMethod[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-StrongAuthenticationRequirements
Especifica uma matriz de requisitos de autenticação fortes.
| Tipo: | StrongAuthenticationRequirement[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-StrongPasswordRequired
Especifica se é necessário exigir uma senha forte para o usuário.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | $true |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-StsRefreshTokensValidFrom
Especifica um valor StsRefreshTokensValidFrom.
| Tipo: | DateTime |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-TenantId
Especifica a ID exclusiva do locatário no qual executar a operação. O valor padrão é o locatário do usuário atual. Esse parâmetro se aplica somente a usuários parceiros.
| Tipo: | Guid |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-Title
Especifica o título do usuário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-UsageLocation
Especifica o local do usuário em que os serviços são consumidos. Especifique um código de país ou região de duas letras.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-UserPrincipalName
Especifica a ID de usuário para esse usuário. Isso é necessário.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-UserType
Especifica o tipo de usuário.
| Tipo: | UserType |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
Saídas
Microsoft.Online.Administration.User
Esse cmdlet retorna detalhes sobre o novo usuário que foi criado, incluindo sua senha temporária.