Set-EntraBetaUser

Aktualizuje użytkownika.

Składnia

Default (domyślnie)

Set-EntraBetaUser

    -UserId <String>
    [-PostalCode <String>]
    [-CompanyName <String>]
    [-GivenName <String>]
    [-Mobile <String>]
    [-PreferredLanguage <String>]
    [-CreationType <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-AgeGroup <String>]
    [-MailNickName <String>]
    [-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
    [-ConsentProvidedForMinor <String>]
    [-ImmutableId <String>]
    [-Country <String>]
    [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
    [-Department <String>]
    [-StreetAddress <String>]
    [-PasswordPolicies <String>]
    [-JobTitle <String>]
    [-City <String>]
    [-OtherMails <System.Collections.Generic.List`1[System.String]>]
    [-UserPrincipalName <String>]
    [-DisplayName <String>]
    [-AccountEnabled <Boolean>]
    [-PasswordProfile <PasswordProfile>]
    [-State <String>]
    [-TelephoneNumber <String>]
    [-Surname <String>]
    [-ShowInAddressList <Boolean>]
    [<CommonParameters>]

Opis

Polecenie Set-EntraBetaUser cmdlet aktualizuje użytkownika w Microsoft Entra ID. UserId Określ parametr, aby zaktualizować użytkownika w Microsoft Entra ID.

Update-EntraBetaUser to alias dla elementu Set-EntraBetaUser.

Przykłady

Przykład 1. Aktualizowanie użytkownika

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -DisplayName 'Updated user Name'

W tym przykładzie zaktualizowano parametr Nazwa wyświetlana określonego użytkownika.

  • -UserId Określa identyfikator jako główną nazwę użytkownika (UPN) lub UserId.

Przykład 2. Ustawianie parametru AccountEnabled określonego użytkownika

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -AccountEnabled $true

W tym przykładzie zaktualizowano parametr AccountEnabled określonego użytkownika.

  • -UserId Określa identyfikator jako główną nazwę użytkownika (UPN) lub UserId.
  • -AccountEnabled Określa, czy konto jest włączone.

Przykład 3: Ustaw wszystkich, ale określonych użytkowników jako nieletnich z zgodą rodziców

Connect-Entra -Scopes 'User.ReadWrite.All'
Get-EntraBetaUser -All | Where-Object -Property DisplayName -Match '(George|James|Education)' |
ForEach-Object { Set-EntraBetaUser -UserId $($_.Id) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }

W tym przykładzie użytkownik jest aktualizowany jako osoby nieletnie ze zgodą rodziców.

  • -UserId Określa identyfikator jako główną nazwę użytkownika (UPN) lub UserId.
  • -ConsentProvidedForMinor Określa, czy zgoda ma być uzyskana dla osób nieletnich. Dozwolone wartości: null, przyznane, odrzucone i notRequired.

Przykład 4. Ustawianie właściwości określonego użytkownika

Connect-Entra -Scopes 'User.ReadWrite.All'
$params = @{
    UserId           = 'SawyerM@contoso.com'
    City             = 'Add city name'
    CompanyName      = 'Microsoft'
    Country          = 'Add country name'
    Department       = 'Add department name'
    GivenName        = 'Sawyer Miller G'
    JobTitle         = 'Manager'
    MailNickName     = 'Add mailnickname'
    Mobile           = '9984534564'
    OtherMails       = 'johndoe@contosodev.com'
    PasswordPolicies = 'DisableStrongPassword'
    State            = 'UP'
    StreetAddress    = 'Add address'
    UserType         = 'Member'
}
Set-EntraBetaUser @params

W tym przykładzie zaktualizowano właściwość określonego użytkownika.

  • -UserId Określa identyfikator jako główną nazwę użytkownika (UPN) lub UserId.
  • -UserType klasyfikuj typy użytkowników w katalogu, takie jak "Członek" i "Gość".
  • -PasswordPolicies Określa zasady haseł dla użytkownika.
  • -OtherMails Określa inne adresy e-mail użytkownika

Przykład 5. Ustawianie parametru PasswordProfile określonego użytkownika

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -PasswordProfile @{
    Password = '*****'
    ForceChangePasswordNextSignIn = $true
}

W tym przykładzie zaktualizowano parametr PasswordProfile określonego użytkownika.

  • -UserId Określa identyfikator jako główną nazwę użytkownika (UPN) lub UserId.
  • -PasswordProfile określa profil hasła użytkownika.

Przykład 6. Ustawianie lokalizacji użycia użytkownika na potrzeby przypisywania licencji

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -UsageLocation 'US'

W tym przykładzie zaktualizowano lokalizację użycia określonego użytkownika na potrzeby zarządzania licencjami.

  • -UserId Określa identyfikator jako główną nazwę użytkownika (UPN) lub UserId.
  • -UsageLocation określa lokalizację użycia użytkownika. Dwuliterowy kod kraju ISO 3166. Wymagane dla licencjonowanych użytkowników do sprawdzania dostępności usługi. Przykłady: USA, JP, GB. Nie może być null.

Przykład 7. Aktualizowanie zasad haseł użytkownika

Connect-Entra -Scopes 'User.ReadWrite.All'
Get-EntraBetaUser -UserId 'SawyerM@contoso.com' | Set-EntraBetaUser -PasswordPolicies DisablePasswordExpiration

W tym przykładzie zaktualizowano zasady haseł określonego użytkownika.

Możliwe wartości zasad haseł to:

  • DisableStrongPassword: zezwala na słabsze hasła niż domyślne zasady.
  • DisablePasswordExpiration: Uniemożliwia wygasanie haseł.

Możesz określić obie wartości razem, na przykład: DisablePasswordExpiration i DisableStrongPassword. Na przykład Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -PasswordPolicies "DisablePasswordExpiration,DisableStrongPassword".

Przykład 8. Ustawianie właściwości rozszerzenia użytkownika

Connect-Entra -Scopes 'User.ReadWrite.All'
$application = Get-EntraBetaApplication -Filter "DisplayName eq 'Helpdesk Application'"
$extensionName = (Get-EntraBetaApplicationExtensionProperty -ApplicationId $application.Id).Name | Select-Object -First 1
$additionalProperties = @{ $extensionName = "Survey.Report" }
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -AdditionalProperties $additionalProperties

W tym przykładzie zaktualizowano właściwości rozszerzenia określonego użytkownika, na przykład rolę aplikacji dla aplikacji.

  • -UserId Określa identyfikator jako główną nazwę użytkownika (UPN) lub UserId.

Przykład 9: aktualizowanie właściwości atrybutów onPremisesExtension użytkownika

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -AdditionalProperties @{
    onPremisesExtensionAttributes = @{
        extensionAttribute1 = "Job Group D"
        extensionAttribute2 = "Audit Role"
    }
}

W tym przykładzie zaktualizowano właściwości onPremisesExtensionAttributes określonego użytkownika.

  • -UserId Określa identyfikator jako główną nazwę użytkownika (UPN) lub UserId.

Przykład 10: aktualizowanie szczegółów telefonu użytkownika

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraBetaUser -UserId 'SawyerM@contoso.com' -BusinessPhones '+1 425 555 0109' -OfficeLocation '18/2111'

W tym przykładzie zaktualizowano właściwości onPremisesExtensionAttributes określonego użytkownika.

  • -UserId Określa identyfikator jako główną nazwę użytkownika (UPN) lub UserId.

Parametry

-AccountEnabled

Wskazuje, czy konto jest włączone.

Właściwości parametru

Typ:System.Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AgeGroup

Używane przez aplikacje dla przedsiębiorstw do określania legalnej grupy wiekowej użytkownika. Ta właściwość jest tylko do odczytu i obliczana na podstawie właściwości ageGroup i consentProvidedForMinor. Dozwolone wartości: null, minor, notAdult i adult. Zobacz, legal-age-group.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-City

Określa miasto użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-CompanyName

Nazwa firmy skojarzona z użytkownikiem. Ta właściwość może być przydatna do opisywania firmy pochodzącej od użytkownika zewnętrznego. Maksymalna długość nazwy firmy to 64 znaki.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ConsentProvidedForMinor

Określa, czy zgoda ma być uzyskana dla osób nieletnich. Dozwolone wartości: null, przyznane, odrzucone i notRequired.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Country

Określa kraj użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-CreationType

Wskazuje, czy konto użytkownika jest kontem lokalnym dla dzierżawy usługi Microsoft Entra ID B2C. Możliwe wartości to "LocalAccount" i null. Podczas tworzenia konta lokalnego właściwość jest wymagana i musisz ustawić ją na "LocalAccount". Podczas tworzenia konta służbowego nie określaj właściwości ani nie ustawiaj jej na wartość null.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Department

Określa dział użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DisplayName

Określa nazwę wyświetlaną użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ExtensionProperty

Dodaj dane do niestandardowych właściwości użytkownika jako podstawowe otwarte rozszerzenia lub bardziej uniwersalne rozszerzenia schematu.

Właściwości parametru

Typ:

System.Collections.Generic.Dictionary`2[System.String,System.String]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-GivenName

Określa nazwę użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ImmutableId

Ta właściwość łączy konto użytkownika lokalna usługa Active Directory z obiektem użytkownika Microsoft Entra ID. Tę właściwość należy określić podczas tworzenia nowego konta użytkownika w programie Graph, jeśli użytkownik userPrincipalName używa domeny federacyjnej.

Ważne: nie używaj znaków $ i _ podczas określania tej właściwości.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-JobTitle

Określa stanowisko użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MailNickName

Określa pseudonim adresu e-mail użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Mobile

Określa numer telefonu komórkowego użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-OtherMails

Określa inne adresy e-mail użytkownika.

Właściwości parametru

Typ:

System.Collections.Generic.List`1[System.String]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PasswordPolicies

Określa zasady haseł dla użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PasswordProfile

Określa profil hasła użytkownika.

Właściwości parametru

Typ:PasswordProfile
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PostalCode

Określa kod pocztowy użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PreferredLanguage

Określa preferowany język użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ShowInAddressList

Ustaw wartość True, aby pokazać tego użytkownika na liście adresów.

Właściwości parametru

Typ:System.Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SignInNames

Lista nazw logowania dla tego użytkownika

Właściwości parametru

Typ:

System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-State

Określa stan użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-StreetAddress

Określa adres ulicy użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Surname

Określa nazwisko użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-TelephoneNumber

Określa numer telefonu użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-UsageLocation

Dwuliterowy kod kraju lub regionu (iso standard 3166). Wymagane dla użytkowników, którzy przypisyli licencje z powodu wymagania prawnego, aby sprawdzić dostępność usług w kraju i regionach. Przykłady obejmują: "USA", "JP" i "GB". Nie można pustą wartość null.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-UserId

Określa identyfikator użytkownika (jako główna nazwa użytkownika lub userId) w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu, nazwa UPN, Identity, NazwaGłównaUżytkownika

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-UserPrincipalName

Określa główną nazwę użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-UserType

Wartość ciągu, która może służyć do klasyfikowania typów użytkowników w katalogu, takich jak "Członek" i "Gość".

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Notatki

Update-EntraBetaUser to alias dla elementu Set-EntraBetaUser.