Compartilhar via


Set-MsolUserPrincipalName

Altera a ID de usuário de um usuário.

Sintaxe

Set-MsolUserPrincipalName
   -ObjectId <Guid>
   -NewUserPrincipalName <String>
   [-ImmutableId <String>]
   [-NewPassword <String>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Set-MsolUserPrincipalName
   -NewUserPrincipalName <String>
   [-ImmutableId <String>]
   [-NewPassword <String>]
   -UserPrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

O cmdlet Set-MsolUserPrincipalName altera o nome principal do usuário ou a ID de usuário de um usuário. Esse cmdlet pode ser usado para mover um usuário entre um domínio federado e padrão, o que resulta na alteração do tipo de autenticação para o do domínio de destino.

Exemplos

Exemplo 1: renomear um usuário

PS C:\> Set-MsolUserPrincipalName -UserPrincipalName "davidc@contoso.com" -NewUserPrincipalName "davidchew@contoso.com"

Esse comando renomeia davidc@contoso.com para davidchew@contoso.com.

Parâmetros

-ImmutableId

Especifica a ID imutável da identidade federada do usuário. Isso será necessário se o usuário for movido de um padrão para um domínio de identidade federada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NewPassword

Especifica a nova senha para o usuário. Isso será necessário se o usuário for movido de um federado para um domínio de identidade padrão.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NewUserPrincipalName

Especifica a nova ID de usuário do usuário.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ObjectId

Especifica a ID de objeto exclusiva do usuário a ser atualizada.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
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

-UserPrincipalName

Especifica a ID de usuário original do usuário a ser atualizada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False