Get-MsolUser
從 Azure Active Directory 取得使用者。
語法
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 參數一起指定。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-City
指定要篩選結果的城市。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Country
指定要篩選結果的國家或地區。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Department
指定要篩選結果的部門。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DomainName
指定要篩選結果的網域。 這必須是公司的已驗證網域。 系統會傳回具有電子郵件位址、主要或次要網域的所有使用者。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EnabledFilter
指定已啟用或停用用戶的篩選。 有效值為 All、EnabledOnly 和 DisabledOnly。
| 類型: | UserEnabledFilter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-HasErrorsOnly
此 Cmdlet 只會傳回驗證錯誤的使用者。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-LicenseReconciliationNeededOnly
指出此 Cmdlet 篩選僅針對需要授權對帳的使用者。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-MaxResults
指定這個 Cmdlet 傳回的結果數目上限。 預設值為 500。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | 500 |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ObjectId
指定要取得之使用者的唯一物件標識碼。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ReturnDeletedUsers
指出這個 Cmdlet 只會傳回回收站中的使用者。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SearchString
指定字串，以符合以這個字串開頭的電子郵件地址或顯示名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-State
指定用戶狀態的篩選。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Synchronized
指出此 Cmdlet 只會傳回透過 Azure Active Directory Sync 同步處理的使用者。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TenantId
指定要執行作業之租使用者的唯一標識符。 預設值是目前使用者的租使用者。 此參數僅適用於合作夥伴使用者。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Title
通知篩選用戶標題。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UnlicensedUsersOnly
表示此 Cmdlet 只會傳回未獲指派授權的使用者。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UsageLocation
指定用戶取用服務的國家或地區篩選。 指定兩個字母的國家或地區代碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-UserPrincipalName
告知使用者要擷取的使用者標識碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | 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。 使用者是否有任何錯誤。