Set-MsolUserPrincipalName

  • Referência
Módulo:
MSOnline

Altera a ID do usuário para um usuário.

Syntax

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 da entidade de 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 em seu tipo de autenticação mudando 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 é renomeado 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 federado.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NewUserPrincipalName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UserPrincipalName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False