Delen via


Update-AzADUser

Entiteit bijwerken in gebruikers

Syntaxis

Update-AzADUser
      -UPNOrObjectId <String>
      [-AccountEnabled <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-AgeGroup <String>]
      [-City <String>]
      [-CompanyName <String>]
      [-ConsentProvidedForMinor <String>]
      [-Country <String>]
      [-DeletedDateTime <DateTime>]
      [-Department <String>]
      [-DisplayName <String>]
      [-EmployeeHireDate <DateTime>]
      [-EmployeeId <String>]
      [-EmployeeType <String>]
      [-ExternalUserState <String>]
      [-ExternalUserStateChangeDateTime <DateTime>]
      [-FaxNumber <String>]
      [-GivenName <String>]
      [-Id <String>]
      [-Identity <IMicrosoftGraphObjectIdentity[]>]
      [-IsResourceAccount]
      [-JobTitle <String>]
      [-Mail <String>]
      [-MailNickname <String>]
      [-OfficeLocation <String>]
      [-OnPremisesImmutableId <String>]
      [-OtherMail <String[]>]
      [-PasswordPolicy <String>]
      [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
      [-PostalCode <String>]
      [-PreferredLanguage <String>]
      [-ShowInAddressList]
      [-State <String>]
      [-StreetAddress <String>]
      [-Surname <String>]
      [-UsageLocation <String>]
      [-UserType <String>]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzADUser
      [-AccountEnabled <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-AgeGroup <String>]
      [-City <String>]
      [-CompanyName <String>]
      [-ConsentProvidedForMinor <String>]
      [-Country <String>]
      [-DeletedDateTime <DateTime>]
      [-Department <String>]
      [-DisplayName <String>]
      [-EmployeeHireDate <DateTime>]
      [-EmployeeId <String>]
      [-EmployeeType <String>]
      [-ExternalUserState <String>]
      [-ExternalUserStateChangeDateTime <DateTime>]
      [-FaxNumber <String>]
      [-GivenName <String>]
      [-Id <String>]
      [-Identity <IMicrosoftGraphObjectIdentity[]>]
      [-IsResourceAccount]
      [-JobTitle <String>]
      [-Mail <String>]
      [-MailNickname <String>]
      [-OfficeLocation <String>]
      [-OnPremisesImmutableId <String>]
      [-OtherMail <String[]>]
      [-PasswordPolicy <String>]
      [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
      [-PostalCode <String>]
      [-PreferredLanguage <String>]
      [-ShowInAddressList]
      [-State <String>]
      [-StreetAddress <String>]
      [-Surname <String>]
      [-UsageLocation <String>]
      [-UserType <String>]
      -ObjectId <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzADUser
      [-AccountEnabled <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-AgeGroup <String>]
      [-City <String>]
      [-CompanyName <String>]
      [-ConsentProvidedForMinor <String>]
      [-Country <String>]
      [-DeletedDateTime <DateTime>]
      [-Department <String>]
      [-DisplayName <String>]
      [-EmployeeHireDate <DateTime>]
      [-EmployeeId <String>]
      [-EmployeeType <String>]
      [-ExternalUserState <String>]
      [-ExternalUserStateChangeDateTime <DateTime>]
      [-FaxNumber <String>]
      [-GivenName <String>]
      [-Id <String>]
      [-Identity <IMicrosoftGraphObjectIdentity[]>]
      [-IsResourceAccount]
      [-JobTitle <String>]
      [-Mail <String>]
      [-MailNickname <String>]
      [-OfficeLocation <String>]
      [-OnPremisesImmutableId <String>]
      [-OtherMail <String[]>]
      [-PasswordPolicy <String>]
      [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
      [-PostalCode <String>]
      [-PreferredLanguage <String>]
      [-ShowInAddressList]
      [-State <String>]
      [-StreetAddress <String>]
      [-Surname <String>]
      [-UsageLocation <String>]
      [-UserType <String>]
      -InputObject <IMicrosoftGraphUser>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzADUser
      [-AccountEnabled <Boolean>]
      [-Password <SecureString>]
      [-ForceChangePasswordNextLogin]
      [-AgeGroup <String>]
      [-City <String>]
      [-CompanyName <String>]
      [-ConsentProvidedForMinor <String>]
      [-Country <String>]
      [-DeletedDateTime <DateTime>]
      [-Department <String>]
      [-DisplayName <String>]
      [-EmployeeHireDate <DateTime>]
      [-EmployeeId <String>]
      [-EmployeeType <String>]
      [-ExternalUserState <String>]
      [-ExternalUserStateChangeDateTime <DateTime>]
      [-FaxNumber <String>]
      [-GivenName <String>]
      [-Id <String>]
      [-Identity <IMicrosoftGraphObjectIdentity[]>]
      [-IsResourceAccount]
      [-JobTitle <String>]
      [-Mail <String>]
      [-MailNickname <String>]
      [-OfficeLocation <String>]
      [-OnPremisesImmutableId <String>]
      [-OtherMail <String[]>]
      [-PasswordPolicy <String>]
      [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
      [-PostalCode <String>]
      [-PreferredLanguage <String>]
      [-ShowInAddressList]
      [-State <String>]
      [-StreetAddress <String>]
      [-Surname <String>]
      [-UsageLocation <String>]
      [-UserType <String>]
      -UserPrincipalName <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Entiteit bijwerken in gebruikers

Voorbeelden

Voorbeeld 1: Gebruiker bijwerken op user principal name

Update-AzADUser -UPNOrObjectId $upn -City $city

Gebruiker bijwerken op principal-naam van gebruiker

Parameters

-AccountEnabled

waar voor het inschakelen van het account; anders, onwaar. Altijd waar in combinatie met -Password. -AccountEnabled $false wordt genegeerd bij het wijzigen van het wachtwoord van het account.

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

-AgeGroup

Hiermee stelt u de leeftijdsgroep van de gebruiker in. Toegestane waarden: null, minor, notAdult en volwassenen. Raadpleeg de definities van eigenschappen voor juridische leeftijdsgroepen voor meer informatie. Ondersteunt $filter (eq, ne, NOT en in).

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

-City

De plaats waarin de gebruiker zich bevindt. De maximale lengte is 128 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-Confirm

U wordt 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

-ConsentProvidedForMinor

Hiermee stelt u in of er toestemming is verkregen voor minderjarigen. Toegestane waarden: null, verleend, geweigerd en notRequired. Raadpleeg de definities van eigenschappen voor juridische leeftijdsgroepen voor meer informatie. Ondersteunt $filter (eq, ne, NOT en in).

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

-Country

Het land/de regio waarin de gebruiker zich bevindt; Bijvoorbeeld VS of VK. De maximale lengte is 128 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
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:PSObject
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DeletedDateTime

.

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

-Department

De naam voor de afdeling waarin de gebruiker werkt. De maximale lengte is 64 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le en in operators).

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

-DisplayName

De naam die wordt weergegeven in het adresboek voor de gebruiker. Deze waarde is meestal de combinatie van de voornaam, de eerste en achternaam van de gebruiker. Deze eigenschap is vereist wanneer een gebruiker wordt gemaakt en deze niet kan worden gewist tijdens updates. De maximale lengte is 256 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith), $orderBy en $search.

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

-EmployeeHireDate

De datum en tijd waarop de gebruiker is ingehuurd of zal aan het werk gaan in het geval van een toekomstige inhuur. Ondersteunt $filter (eq, ne, NOT, ge, le, in).

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

-EmployeeId

De werknemer-id die door de organisatie aan de gebruiker is toegewezen. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-EmployeeType

Legt het ondernemingswerkroltype vast. Bijvoorbeeld werknemer, aannemer, consultant of leverancier. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-ExternalUserState

Voor een externe gebruiker die is uitgenodigd voor de tenant met behulp van de uitnodigings-API, vertegenwoordigt deze eigenschap de status van de uitnodiging van de uitgenodigde gebruiker. Voor uitgenodigde gebruikers kan de status PendingAcceptance of Accepted of null zijn voor alle andere gebruikers. Ondersteunt $filter (eq, ne, NOT , in).

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

-ExternalUserStateChangeDateTime

Geeft de tijdstempel weer voor de meest recente wijziging in de eigenschap externalUserState. Ondersteunt $filter (eq, ne, NOT , in).

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

-FaxNumber

Het faxnummer van de gebruiker. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-ForceChangePasswordNextLogin

Deze moet worden opgegeven als de gebruiker het wachtwoord moet wijzigen bij de volgende geslaagde aanmelding (waar). Standaardgedrag is (onwaar) om het wachtwoord niet te wijzigen bij de volgende geslaagde aanmelding.

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

-GivenName

De opgegeven naam (voornaam) van de gebruiker. De maximale lengte is 64 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-Id

Alleen-lezen.

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

-Identity

Vertegenwoordigt de identiteiten die kunnen worden gebruikt om u aan te melden bij dit gebruikersaccount. Een identiteit kan worden verstrekt door Microsoft (ook wel een lokaal account genoemd), door organisaties of door sociale id-providers, zoals Facebook, Google en Microsoft, en gekoppeld aan een gebruikersaccount. Kan meerdere items met dezelfde signInType-waarde bevatten. Ondersteunt alleen $filter (eq) waarbij het signInType geen userPrincipalName is. Zie de sectie NOTES voor IDENTITEITS-eigenschappen en maak een hash-tabel om deze samen te stellen.

Type:IMicrosoftGraphObjectIdentity[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

gebruikersinvoerobject

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

-IsResourceAccount

Niet gebruiken - gereserveerd voor toekomstig gebruik.

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

-JobTitle

De functie van de gebruiker. De maximale lengte is 128 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-Mail

Het SMTP-adres voor de gebruiker, bijvoorbeeld admin@contoso.com. Wijzigingen in deze eigenschap werken ook de proxyAddresses-verzameling van de gebruiker bij om de waarde als SMTP-adres op te nemen. Hoewel deze eigenschap accenttekens kan bevatten, kan het gebruik ervan toegangsproblemen veroorzaken met andere Microsoft-toepassingen voor de gebruiker. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

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

-MailNickname

De e-mailalias voor de gebruiker. Deze eigenschap moet worden opgegeven wanneer een gebruiker wordt gemaakt. De maximale lengte is 64 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-ObjectId

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

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

-OfficeLocation

De kantoorlocatie in de bedrijfslocatie van de gebruiker. De maximale lengte is 128 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-OnPremisesImmutableId

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 userPrincipalName (UPN). OPMERKING: de tekens $ en _ kunnen niet worden gebruikt bij het opgeven van deze eigenschap. Alleen geretourneerd op $select. Ondersteunt $filter (eq, ne, NOT, ge, le, in)..

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

-OtherMail

Een lijst met extra e-mailadressen voor de gebruiker; bijvoorbeeld: ['bob@contoso.com', 'Robert@fabrikam.com']. OPMERKING: Hoewel deze eigenschap accenttekens kan bevatten, kunnen ze toegangsproblemen veroorzaken voor toepassingen van derden voor de gebruiker. Ondersteunt $filter (eq, NOT, ge, le, in, startsWith).

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

-PassThru

Retourneert waar wanneer de opdracht slaagt

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

-Password

Het wachtwoord voor de gebruiker. Deze eigenschap is vereist wanneer een gebruiker wordt gemaakt.

Deze kan worden bijgewerkt, maar de gebruiker moet het wachtwoord wijzigen bij de volgende aanmelding.

Het wachtwoord moet voldoen aan minimale vereisten als speci./fied door de eigenschap passwordPolicies van de gebruiker. Standaard is een sterk wachtwoord vereist. Wanneer u het wachtwoord wijzigt met deze methode, wordt AccountEnabled ingesteld op true.

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

-PasswordPolicy

Hiermee geeft u wachtwoordbeleid voor de gebruiker. Deze waarde is een opsomming met één mogelijke waarde die DisableStrongPassword is, waardoor zwakkere wachtwoorden kunnen worden opgegeven dan het standaardbeleid. DisablePasswordExpiration kan ook worden opgegeven. De twee kunnen samen worden opgegeven; bijvoorbeeld: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

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

-PasswordProfile

passwordProfile Zie de sectie NOTES voor de eigenschappen PASSWORDPROFILE en maak een hash-tabel.

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

-PostalCode

De postcode voor het postadres van de gebruiker. De postcode is specifiek voor het land/de regio van de gebruiker. In de Verenigde Staten van Amerika bevat dit kenmerk de postcode. De maximale lengte is 40 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-PreferredLanguage

De voorkeurstaal voor de gebruiker. Moet de ISO 639-1-code volgen; bijvoorbeeld en-US. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-ShowInAddressList

waar als de algemene adreslijst van Outlook deze gebruiker moet bevatten, anders onwaar. Als deze niet is ingesteld, wordt dit behandeld als waar. Voor gebruikers die zijn uitgenodigd via de uitnodigingsmanager, wordt deze eigenschap ingesteld op false. Ondersteunt $filter (eq, ne, NOT, in).

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

-State

De staat of provincie in het adres van de gebruiker. De maximale lengte is 128 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-StreetAddress

Het adres van de locatie van de gebruiker. De maximumlengte is 1024 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-Surname

De achternaam van de gebruiker (familienaam of achternaam). De maximale lengte is 64 tekens. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
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:False
Jokertekens accepteren:False

-UsageLocation

Een landcode van twee letters (ISO-standaard 3166). Vereist voor gebruikers waaraan licenties worden toegewezen vanwege wettelijke vereisten om te controleren op beschikbaarheid van services in landen. Voorbeelden zijn: VS, JP en GB. Niet nullable. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-UserPrincipalName

De UPN (User Principal Name) van de gebruiker. De UPN is een aanmeldingsnaam in internetstijl voor de gebruiker op basis van de internetstandaard RFC 822. Dit moet standaard worden toegewezen aan de e-mailnaam van de gebruiker. De algemene indeling is alias@domain, waarbij het domein aanwezig moet zijn in de verzameling geverifieerde domeinen van de tenant. Deze eigenschap is vereist wanneer een gebruiker wordt gemaakt. De geverifieerde domeinen voor de tenant kunnen worden geopend vanuit de eigenschap verifiedDomains van de organisatie. OPMERKING: Hoewel deze eigenschap accenttekens kan bevatten, kunnen ze toegangsproblemen veroorzaken voor toepassingen van derden voor de gebruiker. Ondersteunt $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) en $orderBy.

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

-UserType

Een tekenreekswaarde die kan worden gebruikt om gebruikerstypen in uw directory te classificeren, zoals Lid en Gast. Ondersteunt $filter (eq, ne, NOT, in,).

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

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

IMicrosoftGraphUser

Uitvoerwaarden

Boolean

Notities

ALIASSEN

Set-AzADUser