New-AdaptiveScope

參考

模組:: ExchangePowerShell

適用於:: Security & Compliance

此 Cmdlet 僅適用于安全 & 性合規性 PowerShell。如需詳細資訊，請參閱安全 & 性合規性 PowerShell。

使用 New-AdaptiveScope Cmdlet 在組織中建立調適型範圍。 ) (或靜態範圍的調適型範圍會用於保留原則和保留標籤原則中。

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

Syntax

New-AdaptiveScope
   -Name <String>
   -FilterConditions <PswsHashtable>
   -LocationType <DynamicBoundaryLocationType>
   [-Comment <String>]
   [<CommonParameters>]

New-AdaptiveScope
   -Name <String>
   -LocationType <DynamicBoundaryLocationType>
   -RawQuery <String>
   [-Comment <String>]
   [<CommonParameters>]

Description

如需要在調適型範圍中使用之屬性的詳細資訊，請參閱調適型範圍的組態資訊。

若要在安全 & 性合規性 PowerShell 中使用此 Cmdlet，您必須獲指派許可權。如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。

範例

範例 1

New-AdaptiveScope -Name "Project X" -LocationType User -FilterConditions @{"Conditions" = @(@{"Conditions" = @(@{"Value" = "US"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}, @{"Value" = "Canada"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}); "Conjunction" = "Or"}, @{"Value" = "Finance"; "Operator" = "Equals"; "Name" = "Department"}); "Conjunction" = "And"}

此範例會使用下列詳細資料建立名為 Project X 的調適型查詢範圍：

範圍：使用者
查詢：「 ('Country or region' 等於 'US' 或 'Canada') ，而 'Department' 等於 'Finance'」。

參數

-Comment

Comment 參數會指定選擇性註解。如果指定的值含有空格，則必須以雙引號 (") 括住值，例如︰"This is an admin note"。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-FilterConditions

FilterConditions 參數會指定動態界限中包含的條件。有效的語法和值取決於 LocationType 參數的值：

使用者或群組：Active Directory 屬性。例如，針對「 ('國家或地區' 等於 'US' 或 'Canada') 且 'Department' 等於 'Finance' 的條件，請使用下列語法： @{"Conditions" = @(@{"Conditions" = @(@{"Value" = "US"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}, @{"Value" = "Canada"; "Operator" = "Equals"; "Name" = "CountryOrRegion"}); "Conjunction" = "Or"}, @{"Value" = "Finance"; "Operator" = "Equals"; "Name" = "Department"}); "Conjunction" = "And"}
月臺：已編制索引的自訂屬性。例如，針對條件「'Refinable string 0' 等於 'Human Resources'，請使用下列語法： @{"Conditions" = @{"Value" = "Human Resources"; "Operator" = "Equals"; "Name" = "RefinableString00"}; "Conjunction" = "And"}

您無法搭配 RawQuery 參數使用此參數。

Type:	PswsHashtable
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-LocationType

LocationType 參數會指定自適性範圍篩選的定義位置。有效值為：

使用者
Microsoft 365 群組 (群組)
網站

Type:	DynamicBoundaryLocationType
Accepted values:	Unknown, User, Group, Site
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Name

Name 參數會指定調適型範圍的唯一名稱。最大長度為 64 個字元。如果值包含空格，請使用引號 (") 括住值。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RawQuery

RawQuery 參數會將範圍切換為進階查詢模式。您可以針對進階查詢模式使用 OPATH 篩選語法。

您無法搭配 FilterConditions 參數使用此參數。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

共用方式為