Set-AzureADUser
Updates een gebruiker.
Syntax
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
Met de cmdlet Set-AzureADUser wordt een gebruiker bijgewerkt 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 behalve 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgeGroup
Wordt gebruikt door bedrijfstoepassingen om de wettelijke 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
, notAdult
minor
en adult
. Raadpleeg de [wettelijke definities van eigenschappen van leeftijdsgroepen][Meer informatie over definities van leeftijdsgroepen en secundaire toestemmingen].
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
Hiermee geeft u de plaats van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConsentProvidedForMinor
Hiermee stelt u in of toestemming is verkregen voor minderjarigen. Toegestane waarden: null
, denied
granted
en notRequired
. Raadpleeg de [eigenschapsdefinities van juridische leeftijdsgroepen][Meer informatie over leeftijdsgroep en kleine toestemmingsdefinities] voor meer informatie.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Country
Hiermee geeft u het land of de regio van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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, geeft u de eigenschap niet op of stelt u deze niet in op null.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
Hiermee geeft u de afdeling van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Hiermee geeft u de weergavenaam van de gebruiker.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FacsimileTelephoneNumber
Het faxnummer van de gebruiker.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GivenName
Hiermee geeft u de opgegeven naam van de gebruiker.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImmutableId
Deze eigenschap wordt gebruikt om een on-premises Active Directory gebruikersaccount te koppelen aan het 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsCompromised
Waar als deze gebruiker is gecompromitteerd
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobTitle
Hiermee geeft u de functie van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MailNickName
Hiermee geeft u een bijnaam voor het e-mailadres van de gebruiker.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mobile
Hiermee geeft u het mobiele telefoonnummer van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OtherMails
Hiermee geeft u andere e-mailadressen voor de gebruiker op.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordPolicies
Hiermee geeft u wachtwoordbeleid voor de gebruiker.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordProfile
Hiermee geeft u het wachtwoordprofiel van de gebruiker op.
Type: | PasswordProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhysicalDeliveryOfficeName
De kantoorlocatie in de bedrijfslocatie van de gebruiker. De maximale lengte is 128 tekens.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostalCode
Hiermee geeft u de postcode van de gebruiker.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredLanguage
Hiermee geeft u de voorkeurstaal van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowInAddressList
Stel in op True om deze gebruiker in de adreslijst weer te geven.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SignInNames
De lijst met aanmeldingsnamen voor deze gebruiker
Type: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Hiermee geeft u de status van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StreetAddress
Hiermee geeft u het adres van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Surname
Hiermee geeft u de achternaam van de gebruiker op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TelephoneNumber
Hiermee geeft u het telefoonnummer van de gebruiker.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UsageLocation
Een land- of regiocode van twee letters (ISO-standaard 3166). Vereist voor gebruikers aan wie licenties worden toegewezen vanwege wettelijke vereisten om de beschikbaarheid van services in landen en regio's te controleren. Voorbeelden zijn: 'US', 'JP' en 'GB'. Niet nullable.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
Hiermee geeft u de user principal name van de gebruiker.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Accepted
zijnPendingAcceptance
, of null
voor alle andere gebruikers.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserStateChangedOn
Toont de tijdstempel voor de meest recente wijziging in de eigenschap externalUserState.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserType
Een tekenreekswaarde die kan worden gebruikt om gebruikerstypen in uw directory te classificeren, zoals 'Lid' en 'Gast'.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Notities
Zie de migratiehandleiding voor Set-AzureADUser naar Microsoft Graph PowerShell.
Verwante koppelingen
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub Issues geleidelijk uitfaseren als het feedbackmechanisme voor inhoud. Het wordt vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor