Set-MsolUserPrincipalName

Ändrar användar-ID för en användare.

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

Cmdleten Set-MsolUserPrincipalName ändrar användarens huvudnamn, eller användar-ID, för en användare. Den här cmdleten kan användas för att flytta en användare mellan en federerad domän och en standarddomän, vilket gör att deras autentiseringstyp ändras till måldomänens.

Exempel

Exempel 1: Byt namn på en användare

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

Det här kommandot byter namn davidc@contoso.com till davidchew@contoso.com.

Parametrar

-ImmutableId

Anger det oföränderliga ID:t för användarens federerade identitet. Detta krävs om du flyttar användaren från en standard till en federerad identitetsdomän.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NewPassword

Anger det nya lösenordet för användaren. Detta krävs om du flyttar användaren från en federerad till en standardidentitetsdomän.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NewUserPrincipalName

Anger användarens nya användar-ID.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ObjectId

Anger det unika objekt-ID för användaren som ska uppdateras.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TenantId

Anger det unika ID för klientorganisationen som åtgärden ska utföras på. Standardvärdet är den aktuella användarens klientorganisation. Den här parametern gäller endast för partneranvändare.

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-UserPrincipalName

Anger det ursprungliga användar-ID:t för användaren som ska uppdateras.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False