다음을 통해 공유


New-FeatureConfiguration

이 cmdlet은 보안 및 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 및 준수 PowerShell을 참조하세요.

참고

이 cmdlet은 현재 공개 미리 보기에서 사용할 수 있으며, 모든 조직에서 사용할 수 없으며 변경될 수 있습니다.

New-FeatureConfiguration cmdlet을 사용하여 다음을 포함하여 organization 내에서 Microsoft Purview 기능 구성을 만듭니다.

  • 컬렉션 정책.
  • 고급 레이블 기반 보호.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

구문

Default (기본값)

New-FeatureConfiguration
    [-Name] <String>
    -Mode <PolicyMode>
    -FeatureScenario <PolicyScenario>
    -ScenarioConfig <String>
    [-Comment <String>]
    [-Confirm]
    [-Locations <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

이 cmdlet을 사용하려면 보안 및 준수 PowerShell에서 사용 권한을 할당받아야 합니다. 자세한 내용은 보안 & 규정 준수의 사용 권한을 참조하세요.

예제

예 1

New-FeatureConfiguration -Name "Collection policy for supported Copilots" -FeatureScenario KnowYourData -Mode Enable -ScenarioConfig '{"Activities":["UploadText","DownloadText"],"EnforcementPlanes":["CopilotExperiences","Browser"],"SensitiveTypeIds":["All"],"IsIngestionEnabled":true}' –Locations '[{"Workload":"Applications","Location":"52655","LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}]},{"Workload":"Applications","Location":"49baeafd-1a6b-4c58-be55-75ae6d1dff6a","LocationSource":"PurviewConfig","LocationType":"Group","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}]}]'

이 예제에서는 다음과 같은 "지원되는 Copilot에 대한 컬렉션 정책"이라는 사용 가능한 컬렉션 정책을 만듭니다.

  • 지원되는 모든 분류자용 UploadText & DownloadText 작업 포함
  • 모든 AI 프롬프트 캡처
  • 모든 사용자 & 그룹으로 범위가 지정된 Microsoft Copilot & Copilot 환경 위치를 포함합니다.

예 2

New-FeatureConfiguration -Name "Scoped browser collection policy for Microsoft Copilot" -FeatureScenario KnowYourData -Mode Enable -ScenarioConfig '{"Activities":["UploadText"],"EnforcementPlanes":["Browser"],"SensitiveTypeIds":["All"],"ExcludedSensitiveTypeIds":["50b8b56b-4ef8-44c2-a924-03374f5831ce","8548332d-6d71-41f8-97db-cc3b5fa544e6"],"IsIngestionEnabled":false}' –Locations '[{"Workload":"Applications","Location":"52655","LocationDisplayName":null,"LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}],"Exclusions":[{"Type":"Group","Identity":"db458ddb-4f56-4d88-a4f7-e29545560839","DisplayName":"Contoso Executives","Name":"Executives@contoso.com"}]}]'

이 예제에서는 다음과 같은 "Microsoft Copilot 대한 범위가 지정된 브라우저 컬렉션 정책"이라는 사용 가능한 컬렉션 정책을 만듭니다.

  • "모든 전체 이름" 및 "모든 실제 주소"를 제외한 지원되는 모든 분류자용 UploadText 활동을 포함합니다.
  • "Contoso 임원 그룹"을 제외한 모든 사용자 & 그룹에 대한 Microsoft Copilot 위치 포함

예 3

New-FeatureConfiguration -Name "Scoped collection policies for browser and devices" -FeatureScenario KnowYourData -Mode Disable -ScenarioConfig '{"Activities":["UploadText","filecreated","filedeleted","filemodified"],"EnforcementPlanes":["Devices","Browser"],"SensitiveTypeIds":["a44669fe-0d48-453d-a9b1-2cc83f2cba77","cb353f78-2b72-4c3c-8827-92ebe4f69fdf"],"FileExtensions":["pdf"],"IsIngestionEnabled":false}' –Locations '[{"Workload":"EndpointDevices","Location":"","Inclusions":[{"Type":"Group","Identity":"db458ddb-4f56-4d88-a4f7-e29545560839","DisplayName":"All Company","Name":"allcompany@contoso.com"}],"Exclusions":[{"Type":"IndividualResource","Identity":"a828f25a-cede-4d0e-97e6-b0b0c913732a","DisplayName":"Alex Wilber","Name":"alex@contoso.com"}]},{"Workload":"Applications","Location":"52655","LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"IndividualResource","Identity":"84f9af2e-b224-4cb8-b9cd-bc531bb07a48","DisplayName":"Adele Vance","Name":"adele@contoso.com"}]}]'

이 예제에서는 다음과 같은 "브라우저 및 디바이스에 대한 범위가 지정된 컬렉션 정책"이라는 비활성화된 컬렉션 정책을 만듭니다.

  • UploadText(브라우저용) 및 filecreated, filedeleted 및 파일 수정된 활동(디바이스용)을 포함합니다.
  • "미국 SSN(사회 보장 번호)" 및 "ABA 라우팅 번호" 분류자만 포함
  • "pdf" 파일 확장자만 있는 디바이스에서 파일을 검색합니다.
  • "Alex Wilber" 사용자를 제외한 "모든 회사" 그룹으로 범위가 지정된 디바이스 위치를 포함합니다.
  • 사용자 "Adele Vance"로만 범위가 지정된 Microsoft Copilot 위치를 포함합니다.

매개 변수

-Comment

적용 가능: 보안 & 규정 준수

Comment 매개 변수는 설명(선택 사항)을 지정합니다. 공백이 포함된 값을 지정하는 경우 값을 큰따옴표(")로 묶어야 합니다(예: “이는 관리자 정보입니다”).

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Confirm

적용 가능: 보안 & 규정 준수

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

  • 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
  • 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-FeatureScenario

적용 가능: 보안 & 규정 준수

FeatureScenario 매개 변수는 기능 구성에 대한 시나리오를 지정합니다. 현재 유효한 값은 다음과 같습니다.

  • KnowYourData 컬렉션 정책의 경우
  • TrustContainer 엔드포인트 DLP 트러스트 컨테이너용

매개 변수 속성

형식:PolicyScenario
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Locations

적용 가능: 보안 & 규정 준수

locations 매개 변수는 기능 구성이 적용되는 위치를 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Mode

적용 가능: 보안 & 규정 준수

Mode 매개 변수는 기능 구성 모드를 지정합니다. 유효한 값은 다음과 같습니다.

  • 사용: 기능 구성이 사용하도록 설정됩니다.
  • 사용 안 함: 기능 구성을 사용할 수 없습니다.

매개 변수 속성

형식:PolicyMode
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

적용 가능: 보안 & 규정 준수

Name 매개 변수는 기능 구성의 고유한 이름을 지정합니다. 최대 길이는 64자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ScenarioConfig

적용 가능: 보안 & 규정 준수

ScenarioConfig 매개 변수는 기능 구성에 대한 추가 정보를 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

적용 가능: 보안 & 규정 준수

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.