Set-OrganizationSegment
此 Cmdlet 僅適用於安全性與合規性 PowerShell。 如需詳細資訊，請參閱 安全性與合規性 PowerShell。
使用 Set-OrganizationSegment Cmdlet 修改Microsoft Purview 合規性入口網站中的組織區隔。 在 您套用資訊屏障原則之前，組織區段不會生效。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Set-OrganizationSegment
[-Identity] <PolicyIdParameter>
[-UserGroupFilter <String>]
[<CommonParameters>]
Description
區段是使用 Microsoft Entra ID 中的特定屬性來定義。
若要在安全性與合規性 PowerShell 中使用此 Cmdlet，您必須獲得指派權限。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
Set-OrganizationSegment -Identity c96e0837-c232-4a8a-841e-ef45787d8fcd -UserGroupFilter "Department -eq 'HRDept'"
在此範例中，針對具有 GUID c96e0837-c232-4a8a-841e-ef45787d8fcd 的區段，我們將部門名稱更新為 “HRDept”。
參數
-Identity
適用對象：安全性 & 合規性
Identity 參數會指定您要修改的組織區段。 您可以使用唯一識別區段的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
參數屬性
| 類型: | PolicyIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-UserGroupFilter
適用對象：安全性 & 合規性
UserGroupFilter 參數使用 OPATH 篩選語法來指定組織區段的成員。 例如，"MemberOf -eq 'Engineering Department'"語法為 "Property -ComparisonOperator 'Value'" (或 "ExtensionAttribute1 -eq 'DayTrader'") 。
- 以雙引號 “ ” 括住整個 OPATH 篩選器。 如果篩選條件包含系統值 (例如
$true、$false或$null)，請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。 - Property 是可篩選的屬性。 如需詳細資訊，請參閱 資訊屏障原則的屬性。
- ComparisonOperator 是一種 OPATH 比較運算子 (例如
-eq，用於等號和-like字串比較) 。 如需比較運算子的詳細資訊，請參閱 about_Comparison_Operators。 - Value 是要搜尋的屬性值。 以單引號括住文字值和變數 (
'Value'或'$Variable')。 如果變數值包含單引號，您必須識別 (逸出) 單引號，以正確展開變數。 例如，使用'$($User -Replace "'","''")'，而不是'$User'。 請勿用引號括住整數或系統值 (例如，使用500、$true$false，或$null改為使用) 。
對所有區段使用相同的屬性，並確認區段不會重疊， (使用者只能指派給一個區段) 。
參數屬性
| 類型: | 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。