Get-MsolUser

  • Başvuru
Modül:
MSOnline

Kullanıcıları Azure Active Directory'den alır.

Sözdizimi

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

Description

Get-MsolUser cmdlet'i tek bir kullanıcıyı veya kullanıcı listesini alır. Belirli bir kullanıcıyı almak için ObjectId veya UserPrincipalName parametresini belirtin.

Örnekler

Örnek 1: Tüm kullanıcıları alma

PS C:\> Get-MsolUser

Bu komut, şirketteki tüm kullanıcıları alır. Varsayılan değer olan 500 sonucu görüntüler.

Örnek 2: Etkin kullanıcıları alma

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

Bu komut en fazla 2000 etkin kullanıcı alır.

Örnek 3: UPN ile kullanıcı alma

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

Bu komut, UPN davidchew@contoso.comile kullanıcıyı alır.

Örnek 4: Nesne kimliğine göre kullanıcı alma

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

Bu komut, belirtilen nesne kimliğine sahip bir kullanıcıyı alır.

Örnek 5: Arama Dizesine göre kullanıcıları alma

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

Bu komut, görünen ad veya e-posta adresinde David bulunan kullanıcıların listesini alır.

Örnek 6: Kullanıcının tercih edilen veri konumunu alma

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

Bu komut, kullanıcının tercih edilen veri konumunu döndürür.

Parametreler

-All

Bu cmdlet'in tüm sonuçları döndürdüğünü gösterir. MaxResults parametresiyle birlikte belirtmeyin.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-City

Sonuçların filtreleneceği şehri belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Country

Sonuçların filtreleneceği ülkeyi veya bölgeyi belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Department

Sonuçların filtreleneceği bölümü belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DomainName

Sonuçların filtreleneceği etki alanını belirtir. Bu, şirket için doğrulanmış bir etki alanı olmalıdır. Bu etki alanında birincil veya ikincil bir e-posta adresi olan tüm kullanıcılar döndürülür.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-EnabledFilter

Etkin veya devre dışı bırakılmış kullanıcılar için filtreyi belirtir. Geçerli değerler Tümü, EnabledOnly ve DisabledOnly değerleridir.

Tür:UserEnabledFilter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HasErrorsOnly

Bu cmdlet'in yalnızca doğrulama hataları olan kullanıcıları döndürdüğünü ifade eder.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-LicenseReconciliationNeededOnly

Bu cmdlet'in yalnızca lisans mutabakatı gerektiren kullanıcılar için filtrelendiğini gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaxResults

Bu cmdlet'in döndürdüğü en fazla sonuç sayısını belirtir. Varsayılan değer 500'dür.

Tür:Int32
Position:Named
Default value:500
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ObjectId

Alınacak kullanıcının benzersiz nesne kimliğini belirtir.

Tür:Guid
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ReturnDeletedUsers

Bu cmdlet'in yalnızca geri dönüşüm kutusundaki kullanıcıları döndürdüğünü gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SearchString

Bu dizeyle başlayan e-posta adresi veya görünen adla eşleşecek bir dize belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-State

Kullanıcının durumu için filtreyi belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Synchronized

Bu cmdlet'in yalnızca Azure Active Directory Eşitleme aracılığıyla eşitlenen kullanıcıları döndürdüğünü gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TenantId

İşlemin gerçekleştirildiği kiracının benzersiz kimliğini belirtir. Varsayılan değer, geçerli kullanıcının kiracısıdır. Bu parametre yalnızca iş ortağı kullanıcıları için geçerlidir.

Tür:Guid
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Title

Kullanıcının başlığı için filtreyi kesindir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UnlicensedUsersOnly

Bu cmdlet'in yalnızca lisans atanmamış kullanıcıları döndürdüğünü gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UsageLocation

Hizmetlerin kullanıcı tarafından kullanıldığı ülke veya bölge için filtreyi belirtir. İki harfli bir ülke veya bölge kodu belirtin.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UserPrincipalName

Alınacak kullanıcının kullanıcı kimliğini doğrular.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

Çıkışlar

Microsoft.Online.Administration.User

Bu cmdlet, aşağıdaki bilgileri içeren kullanıcı nesnelerini döndürür:

  • AlternateEmailAddresses. Kullanıcının alternatif e-posta adresi (Azure Active Directory dışında).

  • BlockCredential. Kullanıcının oturum açıp açamadığı.

  • Şehir. Kullanıcının şehri.

  • Ülke. Kullanıcının ülkesi veya bölgesi.

  • Bölümü. Kullanıcının bölümü.

  • Displayname. Kullanıcının görünen adı.

  • Hata. Bir hata dizisi. Bunlar hizmet kaybına neden olabilecek doğrulama hatalarıdır.

  • Faks. Kullanıcının faks numarası.

  • Ad. Kullanıcının adı.

  • SabitID. Yalnızca federasyon kullanıcıları için döndürülür. Bu, Azure Active Directory ile federasyon için gereken kimliktir.

  • isBlackBerryUser. Kullanıcının BlackBerry cihazı olup olmadığını döndürür.

  • isLicensed. Kullanıcının atanmış lisansları olup olmadığı.

  • LastDirSyncTime. Son dizin eşitlemesinin tarihi ve saati (yalnızca Active Directory eşitlemesi aracılığıyla Azure Active Directory ile eşitlenen kullanıcılardan döndürülür).

  • LastPasswordChangeTimestamp. Kullanıcı için parola değişikliğinin Azure Active Directory'ye en son kaydedildiği zaman.

  • Soyadı. Kullanıcının soyadı.

  • LicenseReconciliationNeed. Kullanıcının şu anda lisanssız bir posta kutusu olup olmadığı. Bu durumda, kullanıcının posta kutusunu kaybetmemesi için 30 gün lisanslanması gerekir.

  • Lisans. Kullanıcının lisanslarının listesi.

  • Liveıd. Kullanıcının benzersiz oturum açma kimliği.

  • Mobilephone. Kullanıcının cep telefonu numarası.

  • Objectıd. Kullanıcının benzersiz kimliği.

  • Office. Kullanıcının ofis numarası.

  • OverallProvisioningStatus. Kullanıcının hizmetleri için sağlanıp sağlanmadığı.

  • PasswordNeverExpires. Kullanıcının parolasının 90 günde bir değiştirilmesi gerekip gerekmediği.

  • Phonenumber. Kullanıcının telefon numarası.

  • Postakodu. Kullanıcının posta kodu.

  • PreferredDataLocation. Kullanıcının tercih ettiği veri konumu.

  • PreferredLanguage. Kullanıcının tercih ettiği dil.

  • Proxyaddresses. Bu kullanıcıyla ilişkilendirilmiş ara sunucu adresleri.

  • Durum. Kullanıcının durumu.

  • Streetaddress. Kullanıcının açık adresi.

  • StrongPasswordRequired. Kullanıcının parolasını değiştirdiğinde güçlü bir parola ayarlaması gerekip gerekmediği. Güçlü parolalar önerilir.

  • Başlık. Kullanıcının başlığı.

  • UsageLocation. Hizmetlerin kullanıcı tarafından kullanıldığı ülke veya bölge. Bu, iki harfli bir ülke veya bölge kodu olmalıdır.

  • Userprincipalname. Kullanıcının kullanıcı kimliği.

  • Validationstatus. Kullanıcının herhangi bir hatası olup olmadığı.