Update-AzADUser

Modul:

Az.Resources

Uppdaterar entitet i användare

Syntax

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

Uppdaterar entitet i användare

Exempel

Exempel 1: Uppdatera användaren efter användarens huvudnamn

Update-AzADUser -UPNOrObjectId $upn -City $city

Uppdatera användaren efter användarens huvudnamn

Parametrar

-AccountEnabled

sant för att aktivera kontot; annars falskt. Alltid sant när det kombineras med -Password. -AccountEnabled $false ignoreras när kontots lösenord ändras.

Typ:	Boolean
Alias:	EnableAccount
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-AgeGroup

Anger användarens åldersgrupp. Tillåtna värden: null, minor, notAdult och adult. Mer information finns i egenskapsdefinitionerna för juridiska åldersgrupper. Stöder $filter (eq, ne, NOT och in).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-City

Den stad där användaren finns. Maximal längd är 128 tecken. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CompanyName

Företagsnamnet som användaren är associerad med. Den här egenskapen kan vara användbar för att beskriva företaget som en extern användare kommer från. Företagets maximala längd är 64 tecken. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ConsentProvidedForMinor

Anger om medgivande har erhållits för minderåriga. Tillåtna värden: null, beviljad, nekad och inteRequired. Mer information finns i egenskapsdefinitionerna för juridiska åldersgrupper. Stöder $filter (eq, ne, NOT och in).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Country

Det land/den region där användaren finns. till exempel USA eller Storbritannien. Maximal längd är 128 tecken. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	PSObject
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DeletedDateTime

.

Typ:	DateTime
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Department

Namnet på den avdelning där användaren arbetar. Maximal längd är 64 tecken. Stöder $filter (eq, ne, NOT , ge, le och in operatorer).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DisplayName

Namnet som visas i adressboken för användaren. Det här värdet är vanligtvis en kombination av användarens förnamn, mellan initialt och efternamn. Den här egenskapen krävs när en användare skapas och den inte kan rensas under uppdateringar. Maximal längd är 256 tecken. Stöder $filter (eq, ne, NOT , ge, le, in, startsWith), $orderBy och $search.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-EmployeeHireDate

Datum och tid då användaren anställdes eller kommer att börja arbeta vid en framtida anställning. Stöder $filter (eq, ne, NOT , ge, le, in).

Typ:	DateTime
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-EmployeeId

Den medarbetaridentifierare som tilldelats användaren av organisationen. Stöder $filter (eq, ne, NOT , ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-EmployeeType

Samlar in företagsarbetstyp. Till exempel Anställd, Entreprenör, Konsult eller Leverantör. Stöder $filter (eq, ne, NOT , ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ExternalUserState

För en extern användare som bjudits in till klientorganisationen med hjälp av inbjudnings-API:et representerar den här egenskapen den inbjudna användarens inbjudningsstatus. För inbjudna användare kan tillståndet vara PendingAcceptance eller Godkänd, eller null för alla andra användare. Stöder $filter (eq, ne, NOT , in).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ExternalUserStateChangeDateTime

Visar tidsstämpeln för den senaste ändringen av egenskapen externalUserState. Stöder $filter (eq, ne, NOT , in).

Typ:	DateTime
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-FaxNumber

Faxnumret för användaren. Stöder $filter (eq, ne, NOT , ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ForceChangePasswordNextLogin

Det måste anges om användaren måste ändra lösenordet vid nästa lyckade inloggning (sant). Standardbeteendet är (falskt) att inte ändra lösenordet vid nästa lyckade inloggning.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-GivenName

Användarens förnamn. Maximal längd är 64 tecken. Stöder $filter (eq, ne, NOT , ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Id

Skrivskyddad.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Identity

Representerar de identiteter som kan användas för att logga in på det här användarkontot. En identitet kan tillhandahållas av Microsoft (även kallat ett lokalt konto), av organisationer eller av sociala identitetsprovidrar som Facebook, Google och Microsoft, och kopplas till ett användarkonto. Kan innehålla flera objekt med samma signInType-värde. Stöder endast $filter (eq) där signInType inte är userPrincipalName. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för IDENTITY-egenskaper och skapa en hash-tabell.

Typ:	IMicrosoftGraphObjectIdentity[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-InputObject

användarindataobjekt

Typ:	IMicrosoftGraphUser
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-IsResourceAccount

Använd inte – reserverad för framtida användning.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-JobTitle

Användarens befattning. Maximal längd är 128 tecken. Stöder $filter (eq, ne, NOT , ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Mail

SMTP-adressen för användaren, till exempel admin@contoso.com. Ändringar av den här egenskapen uppdaterar även användarens proxyAddresses-samling så att värdet inkluderas som en SMTP-adress. Även om den här egenskapen kan innehålla dekortecken kan användningen av dem orsaka åtkomstproblem med andra Microsoft-program för användaren. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MailNickname

E-postaliaset för användaren. Den här egenskapen måste anges när en användare skapas. Maximal längd är 64 tecken. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ObjectId

Användarens huvudnamn för den användare som ska uppdateras.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-OfficeLocation

Kontorsplatsen i användarens verksamhetsplats. Maximal längd är 128 tecken. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-OnPremisesImmutableId

Den här egenskapen används för att associera ett lokalt Active Directory-användarkonto till deras Azure AD-användarobjekt. Den här egenskapen måste anges när du skapar ett nytt användarkonto i Graph om du använder en federerad domän för användarens egenskapen userPrincipalName (UPN). Obs! Tecknen $ och _ kan inte användas när du anger den här egenskapen. Returnerades endast på $select. Stöder $filter (eq, ne, NOT, ge, le, in)..

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-OtherMail

En lista över ytterligare e-postadresser för användaren. till exempel: ['bob@contoso.com', 'Robert@fabrikam.com']. Obs! Även om den här egenskapen kan innehålla dekortecken kan de orsaka åtkomstproblem för program från första part för användaren. Stöder $filter (eq, NOT, ge, le, in, startsWith).

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PassThru

Returnerar sant när kommandot lyckas

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Password

Lösenordet för användaren. Den här egenskapen krävs när en användare skapas.

Det kan uppdateras, men användaren måste ändra lösenordet vid nästa inloggning.

Lösenordet måste uppfylla minimikraven som speci./fied av användarens passwordPolicies-egenskap. Som standard krävs ett starkt lösenord. När du ändrar lösenordet med den här metoden anges AccountEnabled till true.

Typ:	SecureString
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PasswordPolicy

Anger lösenordsprinciper för användaren. Det här värdet är en uppräkning där ett möjligt värde är DisableStrongPassword, vilket gör att svagare lösenord än standardprincipen kan anges. DisablePasswordExpiration kan också anges. De två kan anges tillsammans. till exempel: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PasswordProfile

passwordProfile För att skapa, se AVSNITTET ANTECKNINGAR för PASSWORDPROFILE-egenskaper och skapa en hash-tabell.

Typ:	IMicrosoftGraphPasswordProfile
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PostalCode

Postnumret för användarens postadress. Postnumret är specifikt för användarens land/region. I USA innehåller det här attributet postnummer. Maximal längd är 40 tecken. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PreferredLanguage

Det föredragna språket för användaren. Bör följa ISO 639-1 Code; till exempel en-US. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ShowInAddressList

sant om den globala Adresslistan i Outlook ska innehålla den här användaren, annars falskt. Om det inte anges behandlas detta som sant. För användare som bjuds in via inbjudningshanteraren anges den här egenskapen till false. Stöder $filter (eq, ne, NOT, in).

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-State

Delstaten eller provinsen i användarens adress. Maximal längd är 128 tecken. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-StreetAddress

Gatuadressen för användarens verksamhet. Maximal längd är 1 024 tecken. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Surname

Användarens efternamn (efternamn eller efternamn). Maximal längd är 64 tecken. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UPNOrObjectId

Användarens huvudnamn eller objekt-ID för användaren som ska uppdateras.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UsageLocation

En landskod med två bokstäver (ISO-standard 3166). Krävs för användare som ska tilldelas licenser på grund av juridiska krav för att söka efter tillgänglighet för tjänster i länder. Exempel är: USA, JP och GB. Inte nullbar. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UserPrincipalName

Användarens huvudnamn (UPN). UPN är ett inloggningsnamn i Internetstil för användaren baserat på Internetstandarden RFC 822. Enligt konventionen bör detta mappas till användarens e-postnamn. Det allmänna formatet är alias@domain, där domänen måste finnas i klientorganisationens samling av verifierade domäner. Den här egenskapen krävs när en användare skapas. Verifierade domäner för klientorganisationen kan nås från den verifierade egenskapenDomains i organisationen. Obs! Även om den här egenskapen kan innehålla dekortecken kan de orsaka åtkomstproblem för program från första part för användaren. Stöder $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) och $orderBy.

Typ:	String
Alias:	UPN
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UserType

Ett strängvärde som kan användas för att klassificera användartyper i din katalog, till exempel Medlem och Gäst. Stöder $filter (eq, ne, NOT, in,).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

IMicrosoftGraphUser

Utdata

Boolean

Kommentarer

ALIAS

Set-AzADUser