Udostępnij za pośrednictwem

Get-MsolUser

  • Odwołanie
Moduł:
MSOnline

Pobiera użytkowników z usługi Azure Active Directory.

Składnia

Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   -ObjectId <Guid>
   [-ReturnDeletedUsers]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   -UserPrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-MsolUser pobiera pojedynczego użytkownika lub listę użytkowników. Określ parametr ObjectId lub UserPrincipalName , aby uzyskać określonego użytkownika.

Przykłady

Przykład 1. Pobieranie wszystkich użytkowników

PS C:\> Get-MsolUser

To polecenie pobiera wszystkich użytkowników w firmie. Zostanie wyświetlona wartość domyślna 500 wyników.

Przykład 2. Uzyskiwanie użytkowników z włączoną obsługą

PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000

To polecenie pobiera do 2000 użytkowników z włączoną obsługą.

Przykład 3. Pobieranie użytkownika według nazwy UPN

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"

To polecenie pobiera użytkownika z nazwą UPN davidchew@contoso.com.

Przykład 4. Pobieranie użytkownika według identyfikatora obiektu

PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7d

To polecenie pobiera użytkownika, który ma określony identyfikator obiektu.

Przykład 5. Pobieranie użytkowników według ciągu wyszukiwania

PS C:\> Get-MsolUser -SearchString "David"

To polecenie pobiera listę użytkowników z David w nazwie wyświetlanej lub adresie e-mail.

Przykład 6. Pobieranie preferowanej lokalizacji danych użytkownika

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocation

To polecenie zwraca preferowaną lokalizację danych użytkownika.

Parametry

-All

Wskazuje, że to polecenie cmdlet zwraca wszystkie wyniki. Nie należy określać razem z parametrem MaxResults .

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-City

Określa miasto do filtrowania wyników.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Country

Określa kraj lub region do filtrowania wyników.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Department

Określa dział do filtrowania wyników.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DomainName

Określa domenę do filtrowania wyników. Musi to być zweryfikowana domena dla firmy. Wszyscy użytkownicy z adresem e-mail, podstawowym lub pomocniczym, w tej domenie są zwracane.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EnabledFilter

Określa filtr dla użytkowników z włączoną lub wyłączoną. Prawidłowe wartości to Wszystkie, WłączoneOnly i DisabledOnly.

Typ:UserEnabledFilter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HasErrorsOnly

Inidates, że to polecenie cmdlet zwraca tylko użytkowników, którzy mają błędy walidacji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LicenseReconciliationNeededOnly

Wskazuje, że ten filtr poleceń cmdlet dotyczy tylko użytkowników, którzy wymagają uzgodnień licencji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MaxResults

Określa maksymalną liczbę wyników zwracanych przez to polecenie cmdlet. Wartość domyślna to 500.

Typ:Int32
Position:Named
Domyślna wartość:500
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ObjectId

Określa unikatowy identyfikator obiektu użytkownika do pobrania.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ReturnDeletedUsers

Wskazuje, że to polecenie cmdlet zwraca tylko użytkowników w koszu recyklingu.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SearchString

Określa ciąg zgodny z adresem e-mail lub nazwą wyświetlaną rozpoczynającą się od tego ciągu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-State

Określa filtr stanu użytkownika.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Synchronized

Wskazuje, że to polecenie cmdlet zwraca tylko użytkowników, którzy są synchronizowani za pośrednictwem usługi Azure Active Directory Sync.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TenantId

Określa unikatowy identyfikator dzierżawy, w której ma być wykonywana operacja. Wartość domyślna to dzierżawa bieżącego użytkownika. Ten parametr ma zastosowanie tylko do użytkowników partnerów.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Title

Speicifies filtr dla tytułu użytkownika.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UnlicensedUsersOnly

Wskazuje, że to polecenie cmdlet zwraca tylko użytkowników, którzy nie mają przypisanej licencji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UsageLocation

Określa filtr kraju lub regionu, w którym usługi są używane przez użytkownika. Określ dwuliterowy kod kraju lub regionu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UserPrincipalName

Speicifies identyfikator użytkownika do pobrania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

Microsoft.Online.Administration.User

To polecenie cmdlet zwraca obiekty użytkownika, które zawierają następujące informacje:

  • AlternateEmailAddresses. Alternatywny adres e-mail użytkownika (zewnętrzny do usługi Azure Active Directory).

  • BlockCredential. Niezależnie od tego, czy użytkownik może się zalogować.

  • Miasta. Miasto użytkownika.

  • Kraju. Kraj lub region użytkownika.

  • Dział. Dział użytkownika.

  • Displayname. Nazwa wyświetlana użytkownika.

  • Błędy. Tablica błędów. Są to błędy weryfikacji, które mogą spowodować utratę usług.

  • Faksu. Numer faksu użytkownika.

  • Imię. Imię użytkownika.

  • Niezmienny IDENTYFIKATOR. Zwracane tylko dla użytkowników federacyjnych. Jest to identyfikator wymagany do sfederowania z usługą Azure Active Directory.

  • isBlackBerryUser. Zwraca informację, czy użytkownik ma urządzenie BlackBerry.

  • isLicensed. Bez względu na to, czy użytkownik ma przypisane licencje.

  • LastDirSyncTime. Data i godzina ostatniej synchronizacji katalogów (zwracane tylko od użytkowników zsynchronizowanych z usługą Azure Active Directory za pośrednictwem synchronizacji z usługą Active Directory).

  • LastPasswordChangeTimestamp. Ostatni raz, w którym zmiana hasła użytkownika została zarejestrowana w usłudze Azure Active Directory.

  • Nazwisko. Nazwisko użytkownika.

  • LicenseReconciliationNeeded. Bez względu na to, czy użytkownik ma obecnie skrzynkę pocztową bez licencji. W takim przypadku użytkownik powinien mieć licencję na 30 dni, aby uniknąć utraty skrzynki pocztowej.

  • Licencje. Lista licencji użytkownika.

  • LiveID. Unikatowy identyfikator logowania użytkownika.

  • Telefon komórkowy. Numer telefonu komórkowego użytkownika.

  • Objectid. Unikatowy identyfikator użytkownika.

  • Office. Numer biura użytkownika.

  • OverallProvisioningStatus. Określa, czy użytkownik został aprowizowany dla swoich usług.

  • PasswordNeverExpires. Określa, czy hasło użytkownika powinno być wymuszane co 90 dni.

  • Phonenumber. Numer telefonu użytkownika.

  • Postalcode. Kod pocztowy użytkownika.

  • PreferredDataLocation. Preferowana lokalizacja danych użytkownika.

  • PreferredLanguage. Preferowany język użytkownika.

  • Proxyaddresses. Adresy serwera proxy skojarzone z tym użytkownikiem.

  • Państwa. Stan użytkownika.

  • Streetaddress. Adres ulicy użytkownika.

  • StrongPasswordRequired. Określa, czy użytkownik musi ustawić silne hasło podczas zmiany hasła. Zalecane są silne hasła.

  • Tytuł. Tytuł użytkownika.

  • UsageLocation. Kraj lub region, w którym usługi są używane przez użytkownika. Musi to być dwuliterowy kod kraju lub regionu.

  • Userprincipalname. Identyfikator użytkownika użytkownika.

  • Validationstatus. Bez względu na to, czy użytkownik ma jakiekolwiek błędy.