Set-AzureADUser
Uppdaterar en användare.
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
Cmdleten Set-AzureADUser uppdaterar en användare i Azure Active Directory (AD).
Exempel
Exempel 1: Uppdatera en användare
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
Exempel 2: Ange alla men angivna användare som underåriga med föräldramedgivande
Get-AzureADUser -All $true |
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } |
ForEach-Object { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }
Det här kommandot uppdaterar den angivna användarens egenskap.
Parametrar
-AccountEnabled
Anger om kontot är aktiverat.
Typ: | Boolean |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgeGroup
Används av företagsprogram för att fastställa användarens juridiska åldersgrupp. Den här egenskapen är skrivskyddad och beräknas baserat på egenskaperna ageGroup och consentProvidedForMinor . Tillåtna värden: null
, minor
och adult
notAdult
. Se [definitioner av egenskap för juridiska åldersgrupper][Läs mer om definitioner för åldersgrupp och mindre medgivande].
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
Anger användarens stad.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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. Den maximala längden på företagsnamnet är 64 tecken.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConsentProvidedForMinor
Anger om medgivande har erhållits för minderåriga. Tillåtna värden: null
, granted
och notRequired
denied
. Mer information finns i [definitioner av egenskap för juridiska åldersgrupper][Läs mer om definitioner för åldersgrupper och mindre medgivanden].
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Country
Anger användarens land eller region.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CreationType
Anger om användarkontot är ett lokalt konto för en Azure Active Directory B2C-klientorganisation. Möjliga värden är "LocalAccount" och null. När du skapar ett lokalt konto krävs egenskapen och du måste ange den till "LocalAccount". När du skapar ett arbets- eller skolkonto ska du inte ange egenskapen eller ange den som null.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
Anger användarens avdelning.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Anger användarens visningsnamn.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtensionProperty
Lägg till data i anpassade användaregenskaper som grundläggande öppna tillägg eller mer mångsidiga schemautökningar. Se [mer om tillägg][Läs mer om tillägg].
Typ: | Dictionary<TKey,TValue>[System.String,System.String] |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FacsimileTelephoneNumber
Användarens faxnummer.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GivenName
Anger användarens förnamn.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImmutableId
Den här egenskapen används för att associera ett lokalt Active Directory-användarkonto med 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 userPrincipalName
(UPN) egenskap. Viktigt: Det $ går inte att använda tecknen och _ när du anger den här egenskapen.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsCompromised
Sant om den här användaren har komprometterats
Typ: | Boolean |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobTitle
Anger användarens jobbrubrik.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MailNickName
Anger ett smeknamn för användarens e-postadress.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mobile
Anger användarens mobiltelefonnummer.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Anger ID för en användare (som ett UPN eller ObjectId) i Azure AD.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OtherMails
Anger andra e-postadresser för användaren.
Typ: | List<T>[String] |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordPolicies
Anger lösenordsprinciper för användaren.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordProfile
Anger användarens lösenordsprofil.
Typ: | PasswordProfile |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhysicalDeliveryOfficeName
Kontorsplatsen i användarens verksamhet. Maximal längd är 128 tecken.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostalCode
Anger användarens postnummer.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredLanguage
Anger användarens föredragna språk.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowInAddressList
Ställ in på Sant om du vill visa den här användaren i adresslistan.
Typ: | Boolean |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SignInNames
Listan över inloggningsnamn för den här användaren
Typ: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Anger användarens tillstånd.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StreetAddress
Anger användarens gatuadress.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Surname
Anger användarens efternamn.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TelephoneNumber
Anger användarens telefonnummer.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UsageLocation
En lands- eller regionkod 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 och regioner. Exempel är: "US", "JP" och "GB". Inte nullbar.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
Anger användarens huvudnamn.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserState
För en extern användare som bjudits in till klientorganisationen med hjälp av api:et för inbjudan representerar den här egenskapen den inbjudna användarens inbjudningsstatus. För inbjudna användare kan tillståndet vara PendingAcceptance
eller Accepted
, eller null
för alla andra användare.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserStateChangedOn
Visar tidsstämpeln för den senaste ändringen av egenskapen externalUserState.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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".
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Kommentarer
Se migreringsguiden för Set-AzureADUser till Microsoft Graph PowerShell.
Relaterade länkar
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för