Get-MsolUser
從 Azure Active Directory 取得使用者。
Syntax
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 會取得個別使用者或使用者清單。 指定 ObjectId 或 UserPrincipalName 參數以取得特定使用者。
範例
範例 1：取得所有使用者
PS C:\> Get-MsolUser此命令會擷取公司中的所有使用者。 最多會顯示 500 個結果的預設值。
範例 2：取得已啟用的使用者
PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000此命令最多可以啟用 2000 位使用者。
範例 3：依 UPN 取得使用者
PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"此命令會擷取具有 UPN davidchew@contoso.com 的使用者。
範例 4：依物件識別碼取得使用者
PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7d此命令會擷取具有指定之物件識別碼的使用者。
範例 5：依搜尋字串取得使用者
PS C:\> Get-MsolUser -SearchString "David"此命令會擷取顯示名稱或電子郵件地址中具有 David 的使用者清單。
範例 6：取得使用者慣用的資料位置
PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocation此命令會傳回使用者慣用的資料位置。
參數
-All
表示此 Cmdlet 會傳回所有結果。 請勿與 MaxResults 參數一起指定。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-City
指定要篩選結果的城市。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Country
指定要篩選結果的國家或地區。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Department
指定要篩選結果的部門。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainName
指定要篩選結果的網域。 這必須是公司的已驗證網域。 系統會傳回具有電子郵件地址、主要或次要網域的所有使用者。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnabledFilter
指定已啟用或停用使用者的篩選。 有效值為 All、EnabledOnly 和 DisabledOnly。
| Type: | UserEnabledFilter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HasErrorsOnly
此 Cmdlet 只會傳回驗證錯誤的使用者。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LicenseReconciliationNeededOnly
指出此 Cmdlet 篩選僅針對需要授權對帳的使用者。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxResults
指定這個 Cmdlet 傳回的結果數目上限。 預設值為 500。
| Type: | Int32 |
| Position: | Named |
| Default value: | 500 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ObjectId
指定要取得之使用者的唯一物件識別碼。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReturnDeletedUsers
指出這個 Cmdlet 只會傳回回收站中的使用者。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SearchString
指定字串，以符合以這個字串開頭的電子郵件地址或顯示名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-State
指定使用者狀態的篩選。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Synchronized
指出此 Cmdlet 只會傳回透過 Azure Active Directory Sync 同步處理的使用者。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantId
指定要執行作業之租使用者的唯一識別碼。 預設值是目前使用者的租使用者。 此參數僅適用于合作夥伴使用者。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Title
通知篩選使用者標題。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnlicensedUsersOnly
表示此 Cmdlet 只會傳回未獲指派授權的使用者。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UsageLocation
指定使用者取用服務的國家或地區篩選。 指定兩個字母的國家或地區代碼。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserPrincipalName
告知使用者要擷取的使用者識別碼。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
輸出
Microsoft.Online.Administration.User
此 Cmdlet 會傳回使用者物件，其中包含下列資訊：
AlternateEmailAddresses。 Azure Active Directory 外部使用者 (替代電子郵件地址) 。
BlockCredential。 使用者是否能夠登入。
City： 使用者的城市。
國家。 使用者的國家或地區。
部門。 使用者的部門。
DisplayName。 使用者的顯示名稱。
錯誤。 錯誤的陣列。 這些是可能導致失去服務的驗證錯誤。
傳真。 使用者的傳真號碼。
FirstName。 使用者的名字。
ImmutableID。 僅對同盟使用者傳回。 這是與 Azure Active Directory 同盟所需的識別碼。
isBlackBerryUser。 傳回使用者是否具有 BlackBerry 裝置。
isLicensed。 使用者是否已指派任何授權。
LastDirSyncTime。 上次目錄同步處理的日期和時間 (只會透過 Active Directory 同步處理) 從與 Azure Active Directory 同步處理的使用者傳回。
LastPasswordChangeTimestamp。 最近在 Azure Active Directory 中註冊使用者的密碼變更時間。
LastName 使用者的姓氏。
LicenseReconciliationNeeded。 使用者目前是否具有沒有授權的信箱。 在此狀況下，應該授與使用者 30 天權限，以避免失去其信箱。
許可證。 使用者的授權清單。
LiveID。 使用者的唯一登入識別碼。
手機。 使用者的行動電話號碼。
ObjectId。 使用者的唯一識別碼。
辦公室。 使用者的辦公室號碼。
OverallProvisioningStatus。 是否已對其服務佈建使用者。
PasswordNeverExpires。 是否應該強制使用者的密碼每隔 90 天變更一次。
PhoneNumber。 使用者的電話號碼。
PostalCode。 使用者的郵遞區號。
PreferredDataLocation。 使用者的慣用資料位置。
PreferredLanguage。 使用者偏好的語言。
ProxyAddresses。 與此使用者相關聯的 Proxy 位址。
狀態。 使用者的州 (省)。
StreetAddress。 使用者的街道地址。
StrongPasswordRequired。 使用者是否需要在變更其密碼時設定強式密碼。 建議使用強式密碼。
標題。 使用者的職稱。
UsageLocation。 使用者取用服務的國家/地區。 這必須是兩個字母的國家或地區代碼。
UserPrincipalName。 使用者的使用者識別碼。
ValidationStatus。 使用者是否有任何錯誤。
相關連結
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應