Get-AzureRmADUser
篩選 Active Directory 使用者。
警告
自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。
語法
Get-AzureRmADUser
[-UserPrincipalName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-IncludeTotalCount]
[-Skip <UInt64>]
[-First <UInt64>]
[<CommonParameters>] Get-AzureRmADUser
-StartsWith <String>
[-DefaultProfile <IAzureContextContainer>]
[-IncludeTotalCount]
[-Skip <UInt64>]
[-First <UInt64>]
[<CommonParameters>] Get-AzureRmADUser
-DisplayName <String>
[-DefaultProfile <IAzureContextContainer>]
[-IncludeTotalCount]
[-Skip <UInt64>]
[-First <UInt64>]
[<CommonParameters>] Get-AzureRmADUser
-ObjectId <Guid>
[-DefaultProfile <IAzureContextContainer>]
[-IncludeTotalCount]
[-Skip <UInt64>]
[-First <UInt64>]
[<CommonParameters>] Get-AzureRmADUser
-UserPrincipalName <String>
[-DefaultProfile <IAzureContextContainer>]
[-IncludeTotalCount]
[-Skip <UInt64>]
[-First <UInt64>]
[<CommonParameters>] Get-AzureRmADUser
-Mail <String>
[-DefaultProfile <IAzureContextContainer>]
[-IncludeTotalCount]
[-Skip <UInt64>]
[-First <UInt64>]
[<CommonParameters>] Description
篩選 Active Directory 使用者。
範例
範例 1 - 列出所有使用者
PS C:\> Get-AzureRmADUser列出租使用者中的所有 AD 使用者。
範例 2 - 使用分頁列出所有使用者
PS C:\> Get-AzureRmADUser -First 100列出租使用者中的前 100 個 AD 使用者。
範例 3 - 依用戶主體名稱取得 AD 使用者
PS C:\> Get-AzureRmADUser -UserPrincipalName foo@domain.com取得具有用戶主體名稱 「foo@domain.com的 AD 使用者」。
範例 4 - 依搜尋字串列出
PS C:\> Get-AzureRmADUser -SearchString Joe列出顯示名稱開頭為 「Joe」 的所有 AD 使用者。
參數
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶
| 類型: | IAzureContextContainer |
| 別名: | AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisplayName
使用者的顯示名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-First
要傳回的物件數目上限。
| 類型: | UInt64 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-IncludeTotalCount
報告數據集中的物件數目。 目前，此參數不會執行任何動作。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
使用者郵件。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ObjectId
用戶的物件識別碼。
| 類型: | Guid |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Skip
忽略第一個 N 物件，然後取得其餘的物件。
| 類型: | UInt64 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-StartsWith
用來尋找開頭為所提供字串的使用者。
| 類型: | String |
| 別名: | SearchString |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-UserPrincipalName
使用者的UPN。
| 類型: | String |
| 別名: | UPN |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |