Update-AzureRmADUser

Odwołanie

Moduł:: AzureRM.Resources

Aktualizuje istniejącego użytkownika usługi Active Directory.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

Update-AzureRmADUser
      -UPNOrObjectId <String>
      [-DisplayName <String>]
      [-EnableAccount <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADUser
      -UserPrincipalName <String>
      [-DisplayName <String>]
      [-EnableAccount <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADUser
      -ObjectId <Guid>
      [-DisplayName <String>]
      [-EnableAccount <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADUser
      -InputObject <PSADUser>
      [-DisplayName <String>]
      [-EnableAccount <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Aktualizuje istniejącego użytkownika usługi Active Directory (konto służbowe również powszechnie znane jako org-id). Więcej informacji: https://msdn.microsoft.com/en-us/library/azure/ad/graph/api/users-operations#UpdateUser

Przykłady

Przykład 1 — aktualizowanie nazwy wyświetlanej użytkownika przy użyciu identyfikatora obiektu

PS C:\> Update-AzureRmADUser -ObjectId 155a5c10-93a9-4941-a0df-96d83ab5ab24 -DisplayName MyNewDisplayName

Aktualizuje nazwę wyświetlaną użytkownika o identyfikatorze obiektu "155a5c10-93a9-4941-a0df-96d83ab5ab24" jako "MyNewDisplayName".

Przykład 2 — aktualizowanie nazwy wyświetlanej użytkownika przy użyciu głównej nazwy użytkownika

PS C:\> Update-AzureRmADUser -UserPrincipalName foo@domain.com -DisplayName MyNewDisplayName

Aktualizuje nazwę wyświetlaną użytkownika o głównej nazwie użytkownika "foo@domain.com" na "MyNewDisplayName".

Przykład 3 — aktualizowanie nazwy wyświetlanej użytkownika przy użyciu potoków

PS C:\> Get-AzureRmADUser -ObjectId 155a5c10-93a9-4941-a0df-96d83ab5ab24 | Update-AzureRmADUser -DisplayName MyNewDisplayName

Pobiera użytkownika o identyfikatorze obiektu "155a5c10-93a9-4941-a0df-96d83ab5ab24" i potokach do polecenia cmdlet Update-AzureRmADUser w celu zaktualizowania nazwy wyświetlanej tego użytkownika na "MyNewDisplayName".

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:	IAzureContextContainer
Aliasy:	AzureRmContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DisplayName

Nowa nazwa wyświetlana użytkownika.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-EnableAccount

wartość true dla włączenia konta; w przeciwnym razie, fałsz.

Typ:	Nullable<T>[Boolean]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-ForceChangePasswordNextLogin

Należy określić, czy użytkownik powinien zmienić hasło podczas następnego pomyślnego logowania. Prawidłowe tylko wtedy, gdy hasło zostanie zaktualizowane. W przeciwnym razie zostanie ono zignorowane.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-InputObject

Obiekt reprezentujący użytkownika do zaktualizowania.

Typ:	PSADUser
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-ObjectId

Identyfikator obiektu użytkownika do zaktualizowania.

Typ:	Guid
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-Password

Nowe hasło użytkownika.

Typ:	SecureString
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-UPNOrObjectId

Główna nazwa użytkownika lub identyfikator obiektu, który ma zostać zaktualizowany.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-UserPrincipalName

Główna nazwa użytkownika, który ma zostać zaktualizowany.

Typ:	String
Aliasy:	UPN
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False