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을 사용하여 정의됩니다.

예 2

New-OrganizationSegment -Name "NotSales" -UserGroupFilter "Department -ne 'Sales'"

이 예제에서는 Sales에 없는 모든 사용자를 포함하는 NotSales라는 세그먼트를 정의했습니다. 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의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
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 필터 구문을 사용하여 조직 세그먼트의 멤버를 지정합니다. 구문은 (예: "MemberOf -eq 'Engineering Department'" 또는 "ExtensionAttribute1 -eq 'DayTrader'")입니다 "Property -ComparisonOperator 'Value'" .

  • 전체 OPATH 필터를 큰따옴표 " "로 묶습니다. 필터에 시스템 값(예 $true: , $false또는 $null)이 포함된 경우 대신 작은따옴표 ' 를 사용합니다. 이 매개 변수는 문자열(시스템 블록이 아님)이지만 중괄호 { }를 사용할 수도 있지만 필터에 변수가 없는 경우에만 사용할 수 있습니다.
  • 속성은 필터링 가능한 속성입니다. 자세한 내용은 정보 장벽 정책에 대한 특성을 참조하세요.
  • ComparisonOperator는 OPATH 비교 연산자입니다(예 -eq : 같음 및 -like 문자열 비교의 경우). 비교 연산자에 대한 자세한 내용은 about_Comparison_Operators 참조하세요.
  • 값은 검색할 속성 값입니다. 텍스트 값과 변수를 작은따옴표('Value' 또는 '$Variable')로 묶습니다. 변수 값에 작은따옴표가 포함된 경우 변수를 올바르게 확장하려면 작은따옴표를 식별(이스케이프)해야 합니다. 예를 들어 대신 를 '$User'사용합니다 '$($User -Replace "'","''")'. 정수 또는 시스템 값을 따옴표로 묶지 마세요(예: , , $true$false또는 $null 를 대신 사용500).

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