Get-AzADGroup
列出群組中的實體,或依索引鍵從群組取得實體
語法
Get-AzADGroup
[-Count]
[-Expand <String[]>]
[-Select <String[]>]
[-Filter <String>]
[-Orderby <String[]>]
[-Search <String>]
[-ConsistencyLevel <String>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[-CountVariable <String>]
[<CommonParameters>]
Get-AzADGroup
[-Expand <String[]>]
[-Select <String[]>]
[-ConsistencyLevel <String>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
-DisplayName <String>
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzADGroup
[-Expand <String[]>]
[-Select <String[]>]
[-ConsistencyLevel <String>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
-DisplayNameStartsWith <String>
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get-AzADGroup
[-Expand <String[]>]
[-Select <String[]>]
[-ConsistencyLevel <String>]
[-AppendSelected]
-ObjectId <Guid>
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Description
列出群組中的實體,或依索引鍵從群組取得實體
範例
範例 1:依顯示名稱取得群組
Get-AzADGroup -DisplayName $gname
依顯示名稱取得群組
範例 2:清單群組
Get-AzADGroup -First 10
列出前10個群組
範例 3:依物件標識碼取得群組
Get-AzADGroup -ObjectId $id -Select groupTypes -AppendSelected
依對象標識碼取得群組,並在默認屬性之後附加屬性 'groupTypes': 'DisplayName', 'Id', 'DeletedDateTime', 'SecurityEnabled', 'MailEnabled', 'MailEnabled', 'MailNickname', 'Description'
範例 4:使用篩選取得群組
Get-AzADGroup -Filter "startsWith(DisplayName,'some-name')"
使用篩選取得群組
範例 5:將 OdataCount 指派給變數
Get-AzADGroup -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result
將 OdataCount 指派給變數
參數
-AppendSelected
在開啟此參數時,附加以預設屬性選取的屬性,僅適用於參數 '-Select'。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ConsistencyLevel
表示要求的一致性層級。 檔案 URL: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Count
包含項目計數
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-CountVariable
指定集合中項目總數的計數。 根據預設,此變數會在全域範圍中設定。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | PSObject |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisplayName
群組的顯示名稱。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-DisplayNameStartsWith
用來尋找開頭為所提供字串的群組。
類型: | String |
別名: | SearchString |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Expand
展開相關實體
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Filter
依屬性值篩選專案,如需篩選查詢的詳細資訊,請參閱: https://learn.microsoft.com/en-us/graph/filter-query-parameter
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-First
只取得第一個 『n』 物件。
類型: | UInt64 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ObjectId
機碼:群組的標識碼
類型: | Guid |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Orderby
依屬性值排序專案
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Search
依搜尋片語搜尋專案
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Select
選取要傳回的屬性
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Skip
忽略第一個 'n' 對象,然後取得其餘的物件。
類型: | UInt64 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸出
備註
別名