New-AdaptiveScope
이 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 매개 변수는 설명(선택 사항)을 지정합니다. 공백이 포함된 값을 지정하는 경우 값을 큰따옴표(")로 묶어야 합니다(예: “이는 관리자 정보입니다”).
| 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 특성입니다. 예를 들어 "('Country or region'이 '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 |