Get-DynamicDistributionGroup

模組:: Exchange PowerShell

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

使用 Get-DynamicDistributionGroup Cmdlet 來檢視現有的動態通訊群組。

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

語法

AnrSet

Get-DynamicDistributionGroup
    [-Anr <String>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-IncludeAcceptMessagesOnlyFromDLMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeManagedByWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeSystemObjects]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

Identity

Get-DynamicDistributionGroup
    [[-Identity] <DynamicGroupIdParameter>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-IncludeAcceptMessagesOnlyFromDLMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeManagedByWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeSystemObjects]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

ManagedBySet

Get-DynamicDistributionGroup
    [-ManagedBy <GeneralRecipientIdParameter>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-IncludeAcceptMessagesOnlyFromDLMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeManagedByWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeSystemObjects]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

Description

動態通訊群組會查詢已啟用郵件功能的物件，並根據結果建立群組成員資格。每當電子郵件訊息傳送至群組時，群組成員資格就會重新計算。

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

範例

範例 1

Get-DynamicDistributionGroup

此範例會傳回組織中所有動態通訊群組的摘要清單。

範例 2

Get-DynamicDistributionGroup -Identity "Marketing Department" | Format-List

這個範例會傳回名為 Marketing Department 之動態通訊群組的詳細資訊。

範例 3

Get-DynamicDistributionGroup -Anr *research* | Format-Table Name, ManagedBy -Auto

此範例會傳回名稱包含字串 “research” 的所有動態通訊群組，並顯示群組擁有者。

範例 4

$FTE = Get-DynamicDistributionGroup "Full Time Employees"

Get-Recipient -RecipientPreviewFilter $FTE.RecipientFilter -OrganizationalUnit $FTE.RecipientContainer

這個範例會傳回名為 Full Time Employees 的動態通訊群組的成員。第一個命令會將動態通訊群組物件儲存在變數$FTE中。第二個命令使用 Get-Recipient Cmdlet 列出符合動態通訊群組定義準則的收件者。

參數

-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 Online、內部部署的內建安全性附加元件信箱

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。

參數屬性

類型:	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)
標準 DN
GUID

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

參數屬性

類型:	DynamicGroupIdParameter
預設值:	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

-IncludeAcceptMessagesOnlyFromDLMembersWithDisplayNames

適用：Exchange Online、內部部署信箱的內建安全性附加元件

此參數只能在雲端式服務中使用。

IncludeAcceptMessagesOnlyFromDLMembersWithDisplayNames 參數會指定是否在 AcceptMessagesOnlyFromDLMembersWithDisplayNames 屬性中傳回 AcceptMessagesOnlyFromDLMembers 收件者的 SMTP 位址和顯示名稱。您不需要使用此參數指定值。

引進此參數是為了還原 cmdlet 結果中人類看得懂的識別碼。如果您未使用此參數，AcceptMessagesOnlyFromDLMembers 收件者會顯示為 GUID，且 AcceptMessagesOnlyFromDLMembersWithDisplayNames 屬性為空。

參數屬性

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

參數集

(All)

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

-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames

適用：Exchange Online、內部部署信箱的內建安全性附加元件

此參數只能在雲端式服務中使用。

IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames 參數會指定是否在 AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames 屬性中傳回 AcceptMessagesOnlyFromSendersOrMembers 收件者的 SMTP 位址和顯示名稱。您不需要使用此參數指定值。

引進此參數是為了還原 cmdlet 結果中人類看得懂的識別碼。如果您未使用此參數，AcceptMessagesOnlyFromSendersOrMembers 收件者會顯示為 GUID，且 AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames 屬性為空。

參數屬性

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

參數集

(All)

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

-IncludeAcceptMessagesOnlyFromWithDisplayNames

適用：Exchange Online、內部部署信箱的內建安全性附加元件

此參數只能在雲端式服務中使用。

IncludeAcceptMessagesOnlyFromWithDisplayNames 參數會指定是否要傳回 AcceptMessagesOnlyFromWithDisplayNames 屬性中 AcceptMessagesOnlyFrom 收件者的 SMTP 位址和顯示名稱。您不需要使用此參數指定值。

引進此參數是為了還原 cmdlet 結果中人類看得懂的識別碼。如果您未使用此參數，AcceptMessagesOnlyFrom 收件者會顯示為 GUID，且 AcceptMessagesOnlyFromWithDisplayNames 屬性為空。

參數屬性

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

參數集

(All)

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

-IncludeBypassModerationFromSendersOrMembersWithDisplayNames

適用：Exchange Online、內部部署信箱的內建安全性附加元件

此參數只能在雲端式服務中使用。

IncludeBypassModerationFromSendersOrMembersWithDisplayNames 參數會指定是否在 BypassModerationFromSendersOrMembersWithDisplayNames 屬性中傳回 BypassModerationFromSendersOrMembers 收件者的 SMTP 位址和顯示名稱。您不需要使用此參數指定值。

引進此參數是為了還原 cmdlet 結果中人類看得懂的識別碼。如果不使用此參數，BypassModerationFromSendersOrMembers 收件者會顯示為 GUID，且 BypassModerationFromSendersOrMembersWithDisplayNames 屬性是空的。

參數屬性

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

參數集

(All)

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

-IncludeGrantSendOnBehalfToWithDisplayNames

適用：Exchange Online、內部部署信箱的內建安全性附加元件

此參數只能在雲端式服務中使用。

IncludeGrantSendOnBehalfToWithDisplayNames 參數會指定是否在 GrantSendOnBehalfToWithDisplayNames 屬性中傳回 GrantSendOnBehalfTo 收件者的 SMTP 位址和顯示名稱。您不需要使用此參數指定值。

引進此參數是為了還原 cmdlet 結果中人類看得懂的識別碼。如果您未使用此參數，GrantSendOnBehalfTo 收件者會顯示為 GUID，且 GrantSendOnBehalfToWithDisplayNames 屬性為空。

參數屬性

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

參數集

(All)

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

-IncludeManagedByWithDisplayNames

適用：Exchange Online、內部部署信箱的內建安全性附加元件

此參數只能在雲端式服務中使用。

IncludeManagedByWithDisplayNames 參數會指定是否要傳回 ManagedByWithDisplayNames 屬性中群組擁有者的 SMTP 位址和顯示名稱。您不需要使用此參數指定值。

引進此參數是為了還原 cmdlet 結果中人類看得懂的識別碼。如果不使用此參數，則 ManagedByWithDisplayNames 屬性是空的。

參數屬性

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

參數集

(All)

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

-IncludeModeratedByWithDisplayNames

適用：Exchange Online、內部部署信箱的內建安全性附加元件

此參數只能在雲端式服務中使用。

IncludeModeratedByWithDisplayNames 參數可指定是否在 ModeratedByWithDisplayNames 屬性中傳回 ModeratedBy 收件者的 SMTP 位址和顯示名稱。您不需要使用此參數指定值。

引進此參數是為了還原 cmdlet 結果中人類看得懂的識別碼。如果您未使用此參數，ModeratedBy 收件者會顯示為 GUID，且 ModeratedByWithDisplayNames 屬性為空。

參數屬性

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

參數集

(All)

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

-IncludeSystemObjects

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

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

將保留此參數供 Microsoft 內部使用。

參數屬性

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

參數集

(All)

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

-ManagedBy

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

ManagedBy 參數會依群組擁有者篩選結果。您可以使用唯一識別擁有者的任何值。例如：

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

參數屬性

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

參數集

ManagedBySet

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

-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

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

意見反應

此頁面對您有幫助嗎？