Get-Group

模組:: Exchange PowerShell

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。某些參數和設定可能僅限於一個環境或另一個環境。

使用 Get-Group 指令程式來檢視您組織中現有的群組物件。在所有環境中，此 Cmdlet 會傳回啟用郵件的安全性群組、通訊群組、角色群組和會議室清單。如需內部部署 Exchange 環境中其他支援的群組類型的詳細資訊，請參閱 RecipientTypeDetails 參數描述。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

語法

AnrSet

Get-Group
    [-Anr <String>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ReadFromDomainController]
    [-RecipientTypeDetails <RecipientTypeDetails[]>]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

Identity

Get-Group
    [[-Identity] <GroupIdParameter>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ReadFromDomainController]
    [-RecipientTypeDetails <RecipientTypeDetails[]>]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

Description

Get-Group 指令程式不會傳回通訊群組或擁有郵件功能之安全性群組的任何郵件相關內容，也不會傳回角色群組的角色群組相關內容。若要檢視群組的物件特定內容，您需要使用以物件類型 (例如 Get-DistributionGroup 或 Get-RoleGroup) 為基礎的對應指令程式。

您必須已獲指派權限，才能執行此指令程式。雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-Group

此範例會傳回您組織中所有群組的摘要清單。

範例 2

Get-Group -Identity "Marketing Reports" | Format-List

本範例會傳回名為 Marketing Reports 之群組的詳細資訊。

範例 3

Get-Group -Anr Mar*

此範例會使用 Anr 參數傳回「Mar」開頭的所有群組。

參數

-Anr

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

Anr 參數會指定用來執行模糊名稱解析 (ANR) 搜尋的字串。您可以指定部分字串，然後搜尋屬性符合該字串的物件。搜尋的預設屬性如下：

CommonName (CN)
DisplayName
FirstName
LastName
別名

參數屬性

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

參數集

AnrSet

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

-Credential

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此參數僅適用於內部部署 Exchange。

Credential 參數會指定要用來執行此命令的使用者名稱和密碼。通常您會在指令碼中使用此參數，或在您必須提供具有必要權限的其他認證時使用此參數。

此參數的值需要使用 Get-Credential Cmdlet。若要暫停此命令並收到輸入認證的提示，請使用值 (Get-Credential)。或者，在您執行此命令之前，將認證儲存在變數中 (例如，$cred = Get-Credential)，然後將變數名稱 ($cred) 用於此參數。如需詳細資訊，請參閱 Get-Credential。

參數屬性

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

參數集

(All)

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

-DomainController

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。例如，dc01.contoso.com。

Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。

參數屬性

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

參數集

(All)

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

-Filter

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

Filter 參數使用 OPATH 語法，依指定的屬性和值來篩選結果。搜尋準則使用語法 "Property -ComparisonOperator 'Value'"。

以雙引號 “ ” 括住整個 OPATH 篩選器。如果篩選條件包含系統值 (例如 $true、 $false 或 $null)，請改為使用單引號 ' '。雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。
Property 是可篩選的屬性。如需可篩選屬性的詳細資訊，請參閱 Filter 參數的可篩選屬性。
ComparisonOperator 是一種 OPATH 比較運算子 (例如 -eq ，用於等號和 -like 字串比較) 。如需比較運算子的詳細資訊，請參閱 about_Comparison_Operators。
Value 是要搜尋的屬性值。以單引號括住文字值和變數 ('Value' 或 '$Variable')。如果變數值包含單引號，您必須識別 (逸出) 單引號，以正確展開變數。例如，使用 '$($User -Replace "'","''")'，而不是 '$User'。請勿用引號括住整數或系統值 (例如，使用 500、 $true$false，或$null改為使用) 。

您可以使用邏輯運算子 -and 和 -or 將多個搜尋準則鏈結在一起。例如，"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。

如需有關 Exchange 中 OPATH 篩選的詳細資訊，請參閱其他 OPATH 語法資訊。

參數屬性

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

參數集

(All)

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

-Identity

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全性和合規性 & 內建安全性內部部署信箱的附加元件

Identity 參數會指定您要檢視的群組物件。您可以使用唯一識別群組的任何值。例如：

名稱
辨別名稱 (DN)
辨別名稱 (DN)
GUID

警告： Identity 參數的值 $null 或不存在的值會傳回所有物件，就像您在執行 Get- 命令而不使用Identity 參數一樣。請確認 Identity 參數的任何值清單均正確無誤，且不包含不存在的$null值。

參數屬性

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

參數集

Identity

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

-IgnoreDefaultScope

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此參數僅適用於內部部署 Exchange。

IgnoreDefaultScope 參數會告知命令忽略 Exchange PowerShell 工作階段的預設收件者範圍設定，並使用整個樹系作為範圍。您不需要使用此參數指定值。

此參數可讓命令存取預設範圍中目前不可用的 Active Directory 物件，但也會引進下列限制：

您不能使用 DomainController 參數。此命令會自動使用適當的通用類別目錄伺服器。
您不能使用 DomainController 參數。此命令會自動使用適當的通用類別目錄伺服器。

參數屬性

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

參數集

(All)

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

-OrganizationalUnit

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

OrganizationalUnit 參數會根據物件在 Active Directory 中的位置來篩選結果。系統只會傳回存在於指定位置的物件。此參數的有效輸入是 Get-OrganizationalUnit Cmdlet 傳回的組織單位 (OU) 或網域。您可以使用唯一識別 OU 或網域的任何值。例如：

名稱
名稱
辨別名稱 (DN)
GUID

參數屬性

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

參數集

(All)

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

-ReadFromDomainController

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此參數僅適用於內部部署 Exchange。

ReadFromDomainController 參數會指定應從使用者網域的網域控制站讀取的資訊。您不需要使用此參數指定值。

命令： Set-AdServerSettings -ViewEntireForest $true 若要包含樹系中的所有物件，需要 ReadFromDomainController 切換。否則，命令可能會使用包含過時資訊的通用類別目錄。此外，您可能需要使用 ReadFromDomainController 參數執行命令的多次反覆運算，才能取得資訊。

預設情況下，收件者範圍設定為裝載 Exchange 伺服器的網域。

參數屬性

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

參數集

(All)

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

-RecipientTypeDetails

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全性和合規性 & 內建安全性內部部署信箱的附加元件

RecipientTypeDetails 參數會依指定的群組子類型篩選結果。有效值為：

MailNonUniversalGroup
MailUniversalDistributionGroup
MailUniversalSecurityGroup
NonUniversalGroup (內部部署Exchange Server僅限)
RoomList
UniversalDistributionGroup (僅限內部部署Exchange Server)
UniversalSecurityGroup (僅限內部部署Exchange Server)

您可以指定多個以逗號分隔的值。

參數屬性

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

參數集

(All)

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

-ResultSize

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全性和合規性 & 內建安全性內部部署信箱的附加元件

ResultSize 參數會指定傳回的結果筆數上限。若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。預設值為 1000。

參數屬性

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

參數集

(All)

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

-SortBy

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全性和合規性 & 內建安全性內部部署信箱的附加元件

SortBy 參數會指定排序結果依據的屬性。您一次只能依據一個屬性進行排序。結果會以遞增順序排序。

如果預設檢視不包含您要當做排序依據的屬性，您可以在命令上附加 | Format-Table -Auto Property1,Property2,...PropertyX。以建立包含您要查看之所有屬性的新檢視。支援在屬性名稱中使用萬用字元 (*)。

您可以依下列內容排序：

名稱
DisplayName

參數屬性

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

參數集

(All)

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

CommonParameters

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

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。

意見反應

此頁面對您有幫助嗎？