Bagikan melalui

Get-MsolUser

  • Referensi
Modul:
MSOnline

Mendapatkan pengguna dari Azure Active Directory.

Sintaks

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

Deskripsi

Cmdlet Get-MsolUser mendapatkan pengguna individu atau daftar pengguna. Tentukan parameter ObjectId atau UserPrincipalName untuk mendapatkan pengguna tertentu.

Contoh

Contoh 1: Mendapatkan semua pengguna

PS C:\> Get-MsolUser

Perintah ini mengambil semua pengguna di perusahaan. Ini menampilkan hingga nilai default 500 hasil.

Contoh 2: Mendapatkan pengguna yang diaktifkan

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

Perintah ini mendapatkan hingga 2000 pengguna yang diaktifkan.

Contoh 3: Mendapatkan pengguna dengan UPN

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

Perintah ini mengambil pengguna dengan UPN davidchew@contoso.com.

Contoh 4: Mendapatkan pengguna menurut ID objek

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

Perintah ini mengambil pengguna yang memiliki ID objek yang ditentukan.

Contoh 5: Mendapatkan pengguna menurut String pencarian

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

Perintah ini mengambil daftar pengguna dengan David di nama tampilan atau alamat email.

Contoh 6: Mendapatkan lokasi data pilihan pengguna

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

Perintah ini mengembalikan lokasi data yang disukai pengguna.

Parameter

-All

Menunjukkan bahwa cmdlet ini mengembalikan semua hasil. Jangan tentukan bersama dengan parameter MaxResults .

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters:False

-City

Menentukan kota untuk memfilter hasil.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Country

Menentukan negara atau wilayah untuk memfilter hasil.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Department

Menentukan departemen untuk memfilter hasil.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainName

Menentukan domain untuk memfilter hasil. Ini harus menjadi domain terverifikasi untuk perusahaan. Semua pengguna dengan alamat email, primer atau sekunder, pada domain ini dikembalikan.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-EnabledFilter

Menentukan filter untuk pengguna yang diaktifkan atau dinonaktifkan. Nilai yang valid adalah All, EnabledOnly, dan DisabledOnly.

Jenis:UserEnabledFilter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-HasErrorsOnly

Memulai bahwa cmdlet ini hanya mengembalikan pengguna yang memiliki kesalahan validasi.

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-LicenseReconciliationNeededOnly

Menunjukkan bahwa filter cmdlet ini hanya untuk pengguna yang memerlukan rekonsiliasi lisensi.

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

Menentukan jumlah maksimum hasil yang dikembalikan cmdlet ini. Nilai default adalah 500.

Jenis:Int32
Position:Named
nilai default:500
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-ObjectId

Menentukan ID objek unik pengguna yang akan didapatkan.

Jenis:Guid
Position:Named
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-ReturnDeletedUsers

Menunjukkan bahwa cmdlet ini hanya mengembalikan pengguna di keranjang sampah.

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-SearchString

Menentukan string yang cocok dengan alamat email atau nama tampilan yang dimulai dengan string ini.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-State

Menentukan filter untuk status pengguna.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Synchronized

Menunjukkan bahwa cmdlet ini hanya mengembalikan pengguna yang disinkronkan melalui Sinkronisasi Azure Active Directory.

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

Menentukan ID unik penyewa untuk melakukan operasi. Nilai default adalah penyewa pengguna saat ini. Parameter ini hanya berlaku untuk pengguna mitra.

Jenis:Guid
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters:False

-Title

Mempetik filter untuk judul pengguna.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-UnlicensedUsersOnly

Menunjukkan bahwa cmdlet ini hanya mengembalikan pengguna yang tidak diberi lisensi.

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-UsageLocation

Menentukan filter untuk negara atau wilayah tempat layanan digunakan oleh pengguna. Tentukan kode negara atau wilayah dua huruf.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-UserPrincipalName

Menipu ID pengguna pengguna untuk diambil.

Jenis:String
Position:Named
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

Output

Microsoft.Online.Administration.User

Cmdlet ini mengembalikan objek pengguna, yang mencakup informasi berikut:

  • AlternateEmailAddresses. Alamat email alternatif pengguna (eksternal ke Azure Active Directory).

  • BlockCredential. Apakah pengguna dapat masuk atau tidak.

  • Kota. Kota pengguna.

  • Negara. Negara atau wilayah pengguna.

  • Departemen. Departemen pengguna.

  • Displayname. Nama tampilan pengguna.

  • Kesalahan. Array kesalahan. Ini adalah kesalahan validasi yang dapat mengakibatkan hilangnya layanan.

  • Faks. Nomor faks pengguna.

  • Nama Depan. Nama depan pengguna.

  • ImmutableID. Hanya dikembalikan untuk pengguna federasi. Ini adalah ID yang diperlukan untuk digabungkan dengan Azure Active Directory.

  • isBlackBerryUser. Mengembalikan apakah pengguna memiliki perangkat BlackBerry atau tidak.

  • isLicensed. Apakah pengguna memiliki lisensi apa pun yang ditetapkan atau tidak.

  • LastDirSyncTime. Tanggal dan waktu sinkronisasi direktori terakhir (hanya dikembalikan dari pengguna yang disinkronkan dengan Azure Active Directory melalui sinkronisasi Direktori Aktif).

  • LastPasswordChangeTimestamp. Waktu terbaru saat perubahan kata sandi untuk pengguna terdaftar di Azure Active Directory.

  • NamaBelakang. Nama belakang pengguna.

  • LicenseReconciliationNeeded. Apakah pengguna saat ini memiliki kotak surat tanpa lisensi atau tidak. Dalam hal ini, pengguna harus dilisensikan dengan 30 hari untuk menghindari kehilangan kotak surat mereka.

  • Lisensi. Daftar lisensi pengguna.

  • LiveID. ID login unik pengguna.

  • Ponsel. Nomor ponsel pengguna.

  • ObjectId. ID unik pengguna.

  • Kantor. Nomor kantor pengguna.

  • OverallProvisioningStatus. Apakah pengguna telah diprovisikan untuk layanan mereka atau tidak.

  • PasswordNeverExpires. Apakah kata sandi pengguna harus dipaksa untuk berubah setiap 90 hari.

  • Nomor Telepon. Nomor telepon pengguna.

  • PostalCode. Kode pos pengguna.

  • PreferredDataLocation. Lokasi data pilihan pengguna.

  • PreferredLanguage. Bahasa pilihan pengguna.

  • Proxyaddresses. Alamat proksi yang terkait dengan pengguna ini.

  • Negara. Status pengguna.

  • StreetAddress. Alamat jalan pengguna.

  • StrongPasswordRequired. Apakah pengguna diharuskan untuk mengatur kata sandi yang kuat saat mereka mengubah kata sandi mereka. Kata sandi yang kuat direkomendasikan.

  • Judul. Judul pengguna.

  • UsageLocation. Negara atau wilayah tempat layanan digunakan oleh pengguna. Ini harus berupa kode negara atau wilayah dua huruf.

  • Userprincipalname. ID pengguna pengguna.

  • ValidationStatus. Apakah pengguna memiliki kesalahan atau tidak.