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
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
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
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.
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.
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.