Partilhar via


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.