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 |