New-MsolUser
Cria um utilizador 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 utilizador no Azure Active Directory. Para dar acesso ao utilizador aos serviços, atribua uma licença com o parâmetro LicenseAssignment .
Exemplos
Exemplo 1: Criar um utilizador
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew"
Este comando cria um utilizador. O utilizador não tem nenhuma licença atribuída. É gerada uma palavra-passe aleatória para o utilizador.
Exemplo 2: Criar um utilizador e atribuir uma licença
Nota
O parâmetro -LicenseAssignment foi preterido. Saiba como atribuir licenças com o Microsoft Graph PowerShell. Para obter mais informações, consulte a aplicação Atribuir Licença do Microsoft Graph API.
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew" -UsageLocation "US" -LicenseAssignment "Contoso:BPOS_Standard"
Este comando cria um novo utilizador e atribui uma licença.
Exemplo 3: Criar um utilizador e uma localização de dados preferencial
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" -DisplayName "David" -PreferredDataLocation "EUR"
Este comando cria um utilizador cujo nome principal de utilizador é jdavidchew@contoso.onmicrosoft.com, o nome a apresentar é David e a localização de dados preferencial é EUR.
Parâmetros
-AlternateEmailAddresses
Especifica endereços de e-mail alternativos para o utilizador.
Tipo: | String[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-AlternateMobilePhones
Especifica números de telemóvel alternativos para o utilizador.
Tipo: | String[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-BlockCredential
Especifica se o utilizador não consegue iniciar sessão com o respetivo ID de utilizador.
Tipo: | Boolean |
Position: | Named |
Default value: | $false |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-City
Especifica a cidade do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-Country
Especifica o país ou região do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-Department
Especifica o departamento do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-DisplayName
Especifica o nome a apresentar do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-Fax
Especifica o número de fax do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-FirstName
Especifica o primeiro nome do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-ForceChangePassword
Indica que o utilizador tem de alterar a palavra-passe da próxima vez que iniciar sessão.
Tipo: | Boolean |
Position: | Named |
Default value: | $true |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-ImmutableId
Especifica o ID imutável da identidade federada do utilizador. Isto deve ser omitido para utilizadores com identidades padrão.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-LastName
Especifica o apelido do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-LastPasswordChangeTimestamp
Especifica uma hora em que a palavra-passe foi alterada pela última vez.
Tipo: | DateTime |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-LicenseAssignment
Especifica uma matriz de licenças para atribuir o utilizador.
Nota
O parâmetro -LicenseAssignment foi preterido. Saiba como atribuir licenças com o Microsoft Graph PowerShell. Para obter mais informações, consulte a aplicação Atribuir Licença do Microsoft Graph API.
Tipo: | String[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-LicenseOptions
Especifica as opções para a atribuição de licenças. Utilizado para desativar seletivamente planos de serviço individuais num SKU.
Tipo: | LicenseOption[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-MobilePhone
Especifica o número de telemóvel do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-Office
Especifica o escritório do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-Password
Especifica a nova palavra-passe para o utilizador. Se o utilizador estiver definido para exigir uma palavra-passe segura, todas as seguintes regras têm de ser cumpridas:
- A palavra-passe tem de conter, pelo menos, uma letra minúscula
- A palavra-passe tem de conter, pelo menos, uma letra em maiúscula
- A palavra-passe tem de conter, pelo menos, um caráter não alfanumérico
- A palavra-passe não pode conter espaços, separadores ou quebras de linha
- O comprimento da palavra-passe tem de ter entre 8 e 16 carateres
- Não é possível conter o nome de utilizador na palavra-passe
Se este valor for omitido, é atribuída uma palavra-passe aleatória ao utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-PasswordNeverExpires
Especifica se a palavra-passe do utilizador expira periodicamente.
Tipo: | Boolean |
Position: | Named |
Default value: | $false |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-PhoneNumber
Especifica o número de telefone do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-PostalCode
Especifica o código postal do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-PreferredDataLocation
Especifica a localização de dados preferencial para o utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-PreferredLanguage
Especifica o idioma preferencial do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-SoftDeletionTimestamp
Especifica uma hora para eliminação recuperável.
Tipo: | DateTime |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-State
Especifica o estado ou a província onde o utilizador está localizado.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-StreetAddress
Especifica o endereço de rua do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-StrongAuthenticationMethods
Especifica uma matriz de métodos de autenticação fortes.
Tipo: | StrongAuthenticationMethod[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-StrongAuthenticationRequirements
Especifica uma matriz de requisitos de autenticação fortes.
Tipo: | StrongAuthenticationRequirement[] |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-StrongPasswordRequired
Especifica se pretende exigir uma palavra-passe segura para o utilizador.
Tipo: | Boolean |
Position: | Named |
Default value: | $true |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-StsRefreshTokensValidFrom
Especifica um valor StsRefreshTokensValidFrom.
Tipo: | DateTime |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-TenantId
Especifica o ID exclusivo do inquilino no qual efetuar a operação. O valor predefinido é o inquilino do utilizador atual. Este parâmetro aplica-se apenas aos utilizadores parceiros.
Tipo: | Guid |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-Title
Especifica o título do utilizador.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-UsageLocation
Especifica a localização do utilizador onde os serviços são consumidos. Especifique um código de país ou região de duas letras.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-UserPrincipalName
Especifica o ID de utilizador para este utilizador. Isto é necessário.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-UserType
Especifica o tipo de utilizador.
Tipo: | UserType |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Saídas
Microsoft.Online.Administration.User
Este cmdlet devolve detalhes sobre o novo utilizador que foi criado, incluindo a respetiva palavra-passe temporária.