New-OrganizationSegment
此 Cmdlet 僅適用于安全 & 性合規性 PowerShell。 如需詳細資訊，請參閱 安全 & 性合規性 PowerShell。
使用 New-OrganizationSegment Cmdlet 建立組織區段，以搭配Microsoft Purview 合規性入口網站中的資訊屏障原則使用。 在您 套用資訊屏障原則之前，組織區段不會生效。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
New-OrganizationSegment
[-Name] <String>
-UserGroupFilter <String>
[-Confirm]
[-WhatIf]
[<CommonParameters>] Description
如需可用來定義區段之可篩選屬性的詳細資訊，請參閱 資訊屏障原則的屬性。
若要在安全 & 性合規性 PowerShell 中使用此 Cmdlet，您必須獲指派許可權。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
New-OrganizationSegment -Name "HR" -UserGroupFilter "Department -eq 'HR'"在此範例中，名為 HR 的區段是使用 HR 來定義，這是 Department 屬性中的值。
範例 2
New-OrganizationSegment -Name "NotSales" -UserGroupFilter "Department -ne 'Sales'"在此範例中，我們定義了名為 NotSales 的區段，其中包含不在 Sales 中的每個人。 Cmdlet 的 「-ne」 部分是指「不等於」。
範例 3
New-OrganizationSegment -Name "LocalFTE" -UserGroupFilter "Location -eq 'Local' -and Position -ne 'Temporary'"在此範例中，我們定義了稱為 LocalFTE 的區段，其中包含位於本機且其位置未列為暫存的人員。
參數
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Name
Name 參數會指定組織區段的唯一名稱。 最大長度為 64 個字元。 如果值包含空格，請使用引號 (") 括住值。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-UserGroupFilter
UserGroupFilter 參數會使用 OPATH 篩選語法來指定組織區段的成員。 例如，語法 ("Property -ComparisonOperator 'Value'" 或 "MemberOf -eq 'Engineering Department'""ExtensionAttribute1 -eq 'DayTrader'") 。
- 以雙引號 「」 括住整個 OPATH 篩選準則。 如果篩選條件包含系統值 (例如
$true、$false或$null)，請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。 - Property 是可篩選的屬性。 如需詳細資訊，請參閱 資訊屏障原則的屬性。
- ComparisonOperator 是 OPATH 比較運算子 (例如
-eqequals 和-like字串比較) 。 如需比較運算子的詳細資訊，請參閱 about_Comparison_Operators。 - Value 是要搜尋的屬性值。 以單引號括住文字值和變數 (
'Value'或'$Variable')。 如果變數值包含單引號，您必須識別 (逸出) 單引號，以正確展開變數。 例如，使用'$($User -Replace "'","''")'，而不是'$User'。 請勿以引號括住整數或系統值 (例如，請改用500、$true、$false或$null) 。
如需 Exchange 中 OPATH 篩選的詳細資訊，請參閱 其他 OPATH 語法資訊。
針對所有區段使用相同的屬性，並確認您的區段未重迭 (使用者必須只指派給一個區段) 。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-WhatIf
WhatIf 參數無法在安全 & 性合規性 PowerShell 中運作。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |