New-OrganizationSegment

  • 參考
模組:
ExchangePowerShell
適用於:
Security & Compliance

此 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 比較運算子 (例如 -eq equals 和 -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