Update-AzureRmADUser

Referentie

Module:: AzureRM.Resources

Hiermee werkt u een bestaande Active Directory-gebruiker bij.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntaxis

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>]

Description

Hiermee wordt een bestaande Active Directory-gebruiker bijgewerkt (werk-/schoolaccount wordt ook wel organisatie-id genoemd). Voor meer informatie: https://msdn.microsoft.com/en-us/library/azure/ad/graph/api/users-operations#UpdateUser

Voorbeelden

Voorbeeld 1: de weergavenaam van een gebruiker bijwerken met behulp van object-id

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

Hiermee wordt de weergavenaam van de gebruiker bijgewerkt met object-id '155a5c10-93a9-4941-a0df-96d83ab5ab24' als 'MyNewDisplayName'.

Voorbeeld 2: de weergavenaam van een gebruiker bijwerken met de principal-naam van de gebruiker

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

Hiermee werkt u de weergavenaam van de gebruiker bij met de user principal name 'foo@domain.com' als 'MyNewDisplayName'.

Voorbeeld 3: de weergavenaam van een gebruiker bijwerken met behulp van piping

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

Hiermee haalt u de gebruiker op met object-id '155a5c10-93a9-4941-a0df-96d83ab5ab24' en pijpt deze naar de cmdlet Update-AzureRmADUser om de weergavenaam van die gebruiker bij te werken naar 'MyNewDisplayName'.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisplayName

Nieuwe weergavenaam voor de gebruiker.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-EnableAccount

waar voor het inschakelen van het account; anders, onwaar.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ForceChangePasswordNextLogin

Deze moet worden opgegeven als de gebruiker het wachtwoord moet wijzigen bij de volgende geslaagde aanmelding. Alleen geldig als het wachtwoord wordt bijgewerkt, anders wordt het genegeerd.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-InputObject

Het object dat de gebruiker vertegenwoordigt die moet worden bijgewerkt.

Type:	PSADUser
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ObjectId

De object-id van de gebruiker die moet worden bijgewerkt.

Type:	Guid
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Password

Nieuw wachtwoord voor de gebruiker.

Type:	SecureString
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-UPNOrObjectId

De principal-naam of object-id van de gebruiker die moet worden bijgewerkt.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-UserPrincipalName

De principal-naam van de gebruiker die moet worden bijgewerkt.

Type:	String
Aliassen:	UPN
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

String

Guid

PSADUser

Parameters: InputObject (ByValue)

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

SecureString

Uitvoerwaarden