Delen via


Set-AzureADUser

Hiermee wordt een gebruiker bijgewerkt.

Syntaxis

Set-AzureADUser
   -ObjectId <String>
   [-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-CreationType <String>]
   [-Department <String>]
   [-DisplayName <String>]
   [-FacsimileTelephoneNumber <String>]
   [-GivenName <String>]
   [-IsCompromised <Boolean>]
   [-ImmutableId <String>]
   [-JobTitle <String>]
   [-MailNickName <String>]
   [-Mobile <String>]
   [-OtherMails <System.Collections.Generic.List`1[System.String]>]
   [-PasswordPolicies <String>]
   [-PasswordProfile <PasswordProfile>]
   [-PhysicalDeliveryOfficeName <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-ShowInAddressList <Boolean>]
   [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-TelephoneNumber <String>]
   [-UsageLocation <String>]
   [-UserPrincipalName <String>]
   [-UserState <String>]
   [-UserStateChangedOn <String>]
   [-UserType <String>]
   [<CommonParameters>]

Description

De cmdlet Set-AzureADUser werkt een gebruiker bij in Azure Active Directory (AD).

Voorbeelden

Voorbeeld 1: Een gebruiker bijwerken

PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com 
PS C:\> $user.DisplayName = 'YetAnotherTestUser' 
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.Displayname

Voorbeeld 2: alle maar opgegeven gebruikers instellen als minderjarigen met ouderlijke toestemming

Get-AzureADUser -All $true | 
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } | 
ForEach-Object  { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }

Met deze opdracht wordt de eigenschap van de opgegeven gebruiker bijgewerkt.

Parameters

-AccountEnabled

Geeft aan of het account is ingeschakeld.

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

-AgeGroup

Wordt gebruikt door bedrijfstoepassingen om de juridische leeftijdsgroep van de gebruiker te bepalen. Deze eigenschap is alleen-lezen en wordt berekend op basis van de eigenschappen ageGroup en consentProvidedForMinor . Toegestane waarden: null, minoren adultnotAdult . Raadpleeg de [definities van juridische leeftijdsgroepen][Meer informatie over definities van leeftijdsgroepen en secundaire toestemmingen].

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

-City

Hiermee geeft u de plaats van de gebruiker op.

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

-CompanyName

De bedrijfsnaam waaraan de gebruiker is gekoppeld. Deze eigenschap kan handig zijn voor het beschrijven van het bedrijf waaruit een externe gebruiker afkomstig is. De maximale lengte van de bedrijfsnaam is 64 tekens.

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

-ConsentProvidedForMinor

Hiermee stelt u in of toestemming is verkregen voor minderjarigen. Toegestane waarden: null, granteden notRequireddenied . Raadpleeg de [definities van juridische leeftijdsgroepen][Meer informatie over definities van leeftijdsgroepen en secundaire toestemming] voor meer informatie.

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

-Country

Hiermee geeft u het land of de regio van de gebruiker op.

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

-CreationType

Geeft aan of het gebruikersaccount een lokaal account is voor een Azure Active Directory B2C-tenant. Mogelijke waarden zijn LocalAccount en null. Wanneer u een lokaal account maakt, is de eigenschap vereist en moet u deze instellen op LocalAccount. Wanneer u een werk- of schoolaccount maakt, moet u de eigenschap niet opgeven of instellen op null.

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

-Department

Hiermee geeft u de afdeling van de gebruiker op.

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

-DisplayName

Hiermee geeft u de weergavenaam van de gebruiker op.

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

-ExtensionProperty

Voeg gegevens toe aan aangepaste gebruikerseigenschappen als de eenvoudige open extensies of de meer veelzijdige schema-uitbreidingen. Zie [meer informatie over extensies][Meer informatie over extensies].

Type:Dictionary<TKey,TValue>[System.String,System.String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FacsimileTelephoneNumber

Het faxnummer van de gebruiker.

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

-GivenName

Hiermee geeft u de opgegeven naam van de gebruiker.

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

-ImmutableId

Deze eigenschap wordt gebruikt om een on-premises Active Directory-gebruikersaccount te koppelen aan hun Azure AD-gebruikersobject. Deze eigenschap moet worden opgegeven bij het maken van een nieuw gebruikersaccount in graph als u een federatief domein gebruikt voor de upn-eigenschap van de gebruiker userPrincipalName . Belangrijk: De $ tekens en _ kunnen niet worden gebruikt bij het opgeven van deze eigenschap.

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

-IsCompromised

Waar als deze gebruiker is gecompromitteerd

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

-JobTitle

Hiermee geeft u de functietitel van de gebruiker op.

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

-MailNickName

Hiermee geeft u een bijnaam voor het e-mailadres van de gebruiker.

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

-Mobile

Hiermee geeft u het mobiele telefoonnummer van de gebruiker op.

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

-ObjectId

Hiermee geeft u de id van een gebruiker (als een UPN of ObjectId) in Azure AD.

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

-OtherMails

Hiermee geeft u andere e-mailadressen voor de gebruiker op.

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PasswordPolicies

Hiermee geeft u wachtwoordbeleid voor de gebruiker op.

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

-PasswordProfile

Hiermee geeft u het wachtwoordprofiel van de gebruiker op.

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

-PhysicalDeliveryOfficeName

De kantoorlocatie in de bedrijfslocatie van de gebruiker. De maximale lengte is 128 tekens.

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

-PostalCode

Hiermee geeft u de postcode van de gebruiker.

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

-PreferredLanguage

Hiermee geeft u de voorkeurstaal van de gebruiker op.

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

-ShowInAddressList

Stel in op True om deze gebruiker weer te geven in de adreslijst.

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

-SignInNames

De lijst met aanmeldingsnamen voor deze gebruiker

Type:List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-State

Hiermee geeft u de status van de gebruiker op.

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

-StreetAddress

Hiermee geeft u het adres van de gebruiker op.

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

-Surname

Hiermee geeft u de achternaam van de gebruiker op.

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

-TelephoneNumber

Hiermee geeft u het telefoonnummer van de gebruiker op.

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

-UsageLocation

Een land- of regiocode van twee letters (ISO-norm 3166). Vereist voor gebruikers aan wie licenties worden toegewezen vanwege wettelijke vereisten om te controleren op beschikbaarheid van services in landen en regio's. Voorbeelden zijn: 'US', 'JP' en 'GB'. Kan niet op null worden uitgevoerd.

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

-UserPrincipalName

Hiermee geeft u de user principal name van de gebruiker op.

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

-UserState

Voor een externe gebruiker die is uitgenodigd voor de tenant met behulp van de uitnodigings-API, vertegenwoordigt deze eigenschap de uitnodigingsstatus van de uitgenodigde gebruiker. Voor uitgenodigde gebruikers kan de status of AcceptedzijnPendingAcceptance, of null voor alle andere gebruikers.

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

-UserStateChangedOn

Toont de tijdstempel voor de meest recente wijziging in de eigenschap externalUserState.

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

-UserType

Een tekenreekswaarde die kan worden gebruikt voor het classificeren van gebruikerstypen in uw directory, zoals 'Lid' en 'Gast'.

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

Notities

Zie de migratiehandleiding voor Set-AzureADUser naar Microsoft Graph PowerShell.