Get-AzADGroup

模組:: Az.Resources Module

列出群組中的實體，或依索引鍵從群組取得實體

語法

EmptyParameterSet (預設值)

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

DisplayNameParameterSet

Get-AzADGroup
    -DisplayName <String>
    [-Expand <String[]>]
    [-Select <String[]>]
    [-ConsistencyLevel <String>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SearchStringParameterSet

Get-AzADGroup
    -DisplayNameStartsWith <String>
    [-Expand <String[]>]
    [-Select <String[]>]
    [-ConsistencyLevel <String>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ObjectIdParameterSet

Get-AzADGroup
    -ObjectId <Guid>
    [-Expand <String[]>]
    [-Select <String[]>]
    [-ConsistencyLevel <String>]
    [-AppendSelected]
    [-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'、'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
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ConsistencyLevel

指出要求的一致性層級。文件網址： https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Count

包括項目計數

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

EmptyParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CountVariable

指定集合中項目總數的計數。預設情況下，此變數將在全域範圍內設定。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

EmptyParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:	PSObject
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DisplayName

群組的顯示名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

DisplayNameParameterSet

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-DisplayNameStartsWith

用來尋找以所提供字串開頭的群組。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	搜尋字串

參數集

SearchStringParameterSet

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Expand

展開相關實體

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Filter

按屬性值過濾項目，有關過濾器查詢的更多詳細信息，請參閱： https://learn.microsoft.com/en-us/graph/filter-query-parameter

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

EmptyParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-First

只取得第一個『n』物件。

參數屬性

類型:	UInt64
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

EmptyParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DisplayNameParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

SearchStringParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ObjectId

key：群組的ID

參數屬性

類型:	Guid
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ObjectIdParameterSet

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Orderby

依屬性值排序專案

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

EmptyParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Search

依搜尋片語搜尋項目

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

EmptyParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Select

選取要傳回的屬性

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Skip

忽略第一個 'n' 對象，然後取得其餘的物件。

參數屬性

類型:	UInt64
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

EmptyParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

DisplayNameParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

SearchStringParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸出

IMicrosoftGraphGroup

意見反應

此頁面對您有幫助嗎？

共用方式為

Get-AzADGroup

語法

EmptyParameterSet (預設值)

DisplayNameParameterSet

SearchStringParameterSet

ObjectIdParameterSet

Description

範例

範例 1：依顯示名稱取得群組

範例 2：清單群組

範例 3：依物件識別碼取得群組

範例 4：取得具有篩選器的群組

範例 5：將 OdataCount 指派給變數

參數

-AppendSelected

參數屬性

參數集

-ConsistencyLevel

參數屬性

參數集

-Count

參數屬性

參數集

-CountVariable

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-DisplayName

參數屬性

參數集

-DisplayNameStartsWith

參數屬性

參數集

-Expand

參數屬性

參數集

-Filter

參數屬性

參數集

-First

參數屬性

參數集

-ObjectId

參數屬性

參數集

-Orderby

參數屬性

參數集

-Search

參數屬性

參數集

-Select

參數屬性

參數集

-Skip

參數屬性

參數集

CommonParameters

輸出

IMicrosoftGraphGroup

意見反應