Set-ManagementScope

模組:: Exchange PowerShell

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

使用 Set-ManagementScope 指令程式，可變更現有的管理範圍。

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

語法

DatabaseFilter

Set-ManagementScope
    [-Identity] <ManagementScopeIdParameter>
    -DatabaseRestrictionFilter <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

ServerFilter

Set-ManagementScope
    [-Identity] <ManagementScopeIdParameter>
    -ServerRestrictionFilter <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

RecipientFilter

Set-ManagementScope
    [-Identity] <ManagementScopeIdParameter>
    [-RecipientRestrictionFilter <String>]
    [-RecipientRoot <OrganizationalUnitIdParameter>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Name <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

如果您使用 New-ManagementRoleAssignment Cmdlet 變更與管理角色指派相關聯的範圍，更新的範圍會套用至所有相關聯的角色指派。如需變更範圍的詳細資訊，請參閱變更角色範圍。

如需一般和獨佔範圍的詳細資訊，請參閱瞭解管理角色範圍。

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

範例

範例 1

Set-ManagementScope "Seattle Mailboxes" -RecipientRestrictionFilter "City -eq 'Seattle' -and RecipientType -eq 'UserMailbox'"

本範例變更「西雅圖信箱」管理範圍的收件者限制篩選，以符合City信箱內容為西雅圖的所有信箱。

範例 2

Set-ManagementScope "Sales Recipients" -RecipientRoot contoso.com/Sales

本範例變更「銷售收件者」管理範圍的收件者根目錄，以僅符合 contoso.com/Sales OU 下包含的收件者物件。

範例 3

Set-ManagementScope "Vancouver Servers" -ServerRestrictionFilter "ServerSite -eq 'NA-CDN-Vancouver,CN=Sites,CN=Configuration,DC=contoso,DC=com"}'"

本範例會將溫哥華伺服器管理範圍之伺服器限制篩選器中使用的 Active Directory 網站變更為「NA-CDN-溫哥華，CN=Sites，CN=Configuration，DC=contoso，DC=com」。

參數

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。

破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。針對這些 Cmdlet，指定不帶值的 Confirm 參數會造成暫停，強制您在繼續之前先確認命令。

參數屬性

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

參數集

(All)

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

-DatabaseRestrictionFilter

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

DatabaseRestrictionFilter 參數使用 OPATH 篩選語法來指定範圍中包含的資料庫。語法為 "Property -ComparisonOperator 'Value'"。

以雙引號 “ ” 括住整個 OPATH 篩選器。如果篩選條件包含系統值 (例如 $true、 $false 或 $null)，請改為使用單引號 ' '。雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。
Property 是可篩選的屬性。如需可篩選資料庫內容的清單，請參閱瞭解管理角色範圍。
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 語法資訊。

您無法將此參數與 RecipientRestrictionFilter、ServerRestrictionFilter、RecipientRoot、DatabaseList 或 ServerList 參數搭配使用。

參數屬性

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

參數集

DatabaseFilter

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

-DomainController

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

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

參數屬性

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

參數集

(All)

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

-Force

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

強制開關會隱藏警告或確認訊息。您不需要使用此參數指定值。

在不適合提示系統管理員輸入的場合中，您可以使用此參數來利用程式設計方式執行工作。

參數屬性

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

參數集

(All)

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

-Identity

Identity 參數會指定要修改的管理範圍名稱。如果名稱包含空格，則必須使用引號 (") 括住它。

參數屬性

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

參數集

(All)

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

-Name

Name 參數會指定管理範圍的名稱。管理範圍名稱最多可以有 64 個字元。如果名稱包含空格，則必須使用引號 (") 括住它。

參數屬性

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

參數集

(All)

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

-RecipientRestrictionFilter

RecipientRestrictionFilter 參數使用 OPATH 篩選語法來指定範圍中包含的收件者。語法為 "Property -ComparisonOperator 'Value'"。

以雙引號 “ ” 括住整個 OPATH 篩選器。如果篩選條件包含系統值 (例如 $true、 $false 或 $null)，請改為使用單引號 ' '。雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。
屬性是可篩選的收件者屬性。如需可篩選的收件者屬性，請參閱 RecipientFilter 參數的可篩選屬性。
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 語法資訊。

您無法將此參數與 DatabaseRestrictionFilter、DatabaseList、ServerList 或 ServerRestrictionFilter 參數搭配使用。

參數屬性

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

參數集

RecipientFilter

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

-RecipientRoot

RecipientRoot 參數會指定組織單位 (OU)，以 RecipientRestrictionFilter 參數會指定的篩選器應在該 OU 下套用。此參數的有效輸入是由 Get-OrganizationalUnit Cmdlet 傳回的 OU 或網域。您可以使用唯一識別 OU 或網域的任何值。例如：

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

您無法將此參數與 ServerRestrictionFilter 或 DatabaseRestrictionFilter 參數搭配使用。

參數屬性

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

參數集

RecipientFilter

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

-ServerRestrictionFilter

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

ServerRestrictionFilter 參數使用 OPATH 篩選語法來指定範圍中包含的伺服器。語法為 "Property -ComparisonOperator 'Value'"。

以雙引號 “ ” 括住整個 OPATH 篩選器。如果篩選條件包含系統值 (例如 $true、 $false 或 $null)，請改為使用單引號 ' '。雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。
Property 是可篩選的屬性。如需可篩選伺服器內容的清單，請參閱瞭解管理角色範圍。
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 語法資訊。

您無法搭配 RecipientRestrictionFilter、RecipientRoot、DatabaseRestrictionFilter、DatabaseList 或 ServerList 參數使用此參數。

參數屬性

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

參數集

ServerFilter

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

-WhatIf

WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。您不需要使用此參數指定值。

參數屬性

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

參數集

(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

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

備註

在篩選中使用 ISO 3166-1 alpha-2) (的兩個字母的國家/地區代碼，而不是完整的國家/地區名稱。例如，用於 -RecipientRestrictionFilter "UsageLocation -eq 'FR'" 法國。

意見反應

此頁面對您有幫助嗎？