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
, minor
en adult
notAdult
. 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
, granted
en notRequired
denied
. 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 Accepted
zijnPendingAcceptance
, 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.