New-RetentionCompliancePolicy

참조

모듈:: ExchangePowerShell

적용 대상:: Security & Compliance

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

New-RetentionCompliancePolicy cmdlet을 사용하여 Microsoft Purview 규정 준수 포털 새 보존 정책 및 새 보존 레이블 정책을 만듭니다. 새 정책을 만들려면 New-RetentionComplianceRule cmdlet도 사용해야 합니다.

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

구문

New-RetentionCompliancePolicy
   [-Name] <String>
   [-Applications <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-ExchangeLocationException <MultiValuedProperty>]
   [-Force]
   [-IsSimulation]
   [-ModernGroupLocation <MultiValuedProperty>]
   [-ModernGroupLocationException <MultiValuedProperty>]
   [-OneDriveLocation <MultiValuedProperty>]
   [-OneDriveLocationException <MultiValuedProperty>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-PriorityCleanup]
   [-PublicFolderLocation <MultiValuedProperty>]
   [-RestrictiveRetention <Boolean>]
   [-RetainCloudAttachment <Boolean>]
   [-SharePointLocation <MultiValuedProperty>]
   [-SharePointLocationException <MultiValuedProperty>]
   [-SkipPriorityCleanupConfirmation]
   [-SkypeLocation <MultiValuedProperty>]
   [-SkypeLocationException <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

New-RetentionCompliancePolicy
   [-Name] <String>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-Force]
   [-IsSimulation]
   [-PriorityCleanup]
   [-RestrictiveRetention <Boolean>]
   [-RetainCloudAttachment <Boolean>]
   [-SkipPriorityCleanupConfirmation]
   [-TeamsChannelLocation <MultiValuedProperty>]
   [-TeamsChannelLocationException <MultiValuedProperty>]
   [-TeamsChatLocation <MultiValuedProperty>]
   [-TeamsChatLocationException <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

New-RetentionCompliancePolicy
   [-Name] <String>
   -AdaptiveScopeLocation <MultiValuedProperty>
   [-Applications <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-Force]
   [-IsSimulation]
   [-PriorityCleanup]
   [-RestrictiveRetention <Boolean>]
   [-RetainCloudAttachment <Boolean>]
   [-SkipPriorityCleanupConfirmation]
   [-WhatIf]
   [<CommonParameters>]

Description

정책은 규칙이 추가되거나(보존 정책의 경우) 레이블이 추가될 때까지 유효하지 않습니다(보존 레이블 정책의 경우). 자세한 내용은 New-RetentionComplianceRule을 참조하세요. 또한 보존 정책 또는 보존 레이블 정책을 만들려면 하나 이상의 위치 매개 변수를 정의해야 합니다.

이 cmdlet을 사용하려면 보안 및 준수 PowerShell에서 사용 권한을 할당받아야 합니다. 자세한 내용은 [Microsoft Purview 규정 준수 포털 사용 권한]/purview/microsoft-365-compliance-center-permissions)를 참조하세요.

예제

예 1

New-RetentionCompliancePolicy -Name "Regulation 123 Compliance" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"

이 예제에서는 키티 피터슨과 스콧 나카무라의 사서함과 금융 SharePoint Online 사이트에 대해 "규정 123 규정 준수"라는 보존 정책을 만듭니다.

다음 단계는 New-RetentionComplianceRule cmdlet을 사용하여 보존 정책에 규칙을 추가하는 것입니다.

예 2

New-RetentionCompliancePolicy -Name "Marketing Department" -Enabled $true -SharePointLocation https://contoso.sharepoint.com -RetainCloudAttachment $true -Comment "Regulatory compliance for Marketing Dept."

이 예제에서는 지정된 세부 정보를 사용하여 마케팅 부서라는 클라우드 첨부 파일을 대상으로 하는 새로운 자동 적용 레이블 정책을 만듭니다.

다음 단계는 New-RetentionComplianceRule cmdlet을 사용하여 보존 레이블 정책에 보존 레이블을 추가하는 것입니다.

매개 변수

-AdaptiveScopeLocation

AdaptiveScopeLocation 매개 변수는 정책에 포함할 적응형 scope 위치를 지정합니다. New-AdaptiveScope cmdlet을 사용하여 적응형 범위를 만듭니다. 적응형 scope 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

이름
DN(고유 이름)
GUID

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-Applications

Applications 매개 변수는 Microsoft 365 그룹 정책에 포함될 때 대상을 지정합니다(ModernGroups 매개 변수가 설정됨). 유효한 값은 다음과 같습니다.

Group:Exchange Microsoft 365 그룹에 연결된 사서함의 경우
Group:SharePoint Microsoft 365 그룹에 연결된 SharePoint 사이트의 경우
"Group:Exchange,SharePoint" Microsoft 365 그룹에 연결된 사서함 및 SharePoint 사이트 둘 다에 대한 것입니다.
blank($null): 기본값이며 기능적으로 값 "Group:Exchange,SharePoint"과 동일합니다.

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-Comment

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

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-Confirm

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

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

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-Enabled

Enabled 매개 변수는 정책을 사용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 정책이 활성화되어 있습니다. 이 값은 기본값입니다.
$true: 이 정책은 사용하도록 설정되어 있습니다. 이 값은 기본값입니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-ExchangeLocation

ExchangeLocation 매개 변수는 정책에 포함할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.

ExchangeLocation 매개 변수는 정책에 포함할 사서함을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.
사서함
모든 사서함에 대한 모두 값입니다. 이 값 자체만 사용할 수 있습니다.

모든 사서함에 대해 값 All입니다. 이 값만 사용할 수 있습니다.

이름
이름
DN(고유 이름)
GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

지정된 사서함이 없는 경우 사서함이 보류되지 않습니다.

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-ExchangeLocationException

ExchangeLocationException 매개 변수는 ExchangeLocation 매개 변수에 All 값을 사용할 때 정책에서 제외할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.

All 매개 변수는 ExchangeLocation 값을 사용할 때 제외된 사서함 목록에서 제거할 사서함을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.
사서함

모든 사서함에 대해 값 All입니다. 이 값만 사용할 수 있습니다.

이름
이름
DN(고유 이름)
GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-Force

강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

관리 입력에 대한 확인 메시지를 표시하는 것이 부적절한 경우 이 스위치를 사용하여 작업을 프로그래밍 방식으로 실행할 수 있습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-IsSimulation

IsSimulation 스위치는 정책이 시뮬레이션 모드에서 생성됨을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

시뮬레이션 모드에 대한 자세한 내용은 시뮬레이션 모드에 대한 자세한 정보를 참조하세요.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-ModernGroupLocation

ModernGroupLocation 매개 변수는 정책에 포함할 Microsoft 365 그룹 지정합니다. 유효한 값은 다음과 같습니다.

Microsoft 365 그룹
모든 Microsoft 365 그룹 대한 모두 값입니다. 이 값 자체만 사용할 수 있습니다.

Microsoft 365 그룹을 식별하려면 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

이름
이름
DN(고유 이름)
GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-ModernGroupLocationException

ModernGroupLocationException 매개 변수는 ModernGroupLocation 매개 변수에 All 값을 사용할 때 정책에서 제외할 Microsoft 365 그룹 지정합니다.

Microsoft 365 그룹을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

이름
이름
DN(고유 이름)
GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-Name

Name 매개 변수는 보존 정책의 고유한 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표로 묶습니다.

형식:	String
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-OneDriveLocation

OneDriveLocation 매개 변수는 포함할 비즈니스용 OneDrive 사이트를 지정합니다. URL 값으로 사이트를 식별하거나 모든 사이트를 포함하기 위해 All 값을 사용할 수 있습니다.

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-OneDriveLocationException

이 매개 변수는 OneDriveLocation 매개 변수에 All 값을 사용할 때 제외할 비즈니스용 OneDrive 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-PolicyRBACScopes

PolicyRBACScopes 매개 변수는 정책에 할당할 관리 단위를 지정합니다. 유효한 값은 관리 단위의 Microsoft Entra ObjectID(GUID 값)입니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.

관리 단위는 Microsoft Entra ID P1 또는 P2에서만 사용할 수 있습니다. Microsoft Graph PowerShell에서 관리 단위를 만들고 관리합니다.

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-PolicyTemplateInfo

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

형식:	PswsHashtable
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-PriorityCleanup

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-PublicFolderLocation

PublicFolderLocation 매개 변수는 보존 정책에 모든 공용 폴더를 포함하도록 지정합니다. 이 매개 변수에는 All 값을 사용합니다.

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-RestrictiveRetention

RestrictiveRetention 매개 변수는 정책에 보존 잠금을 사용할 수 있는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 정책에 대해 보존 잠금을 사용할 수 있습니다. 관리자를 포함한 누구도 정책을 해제하거나 덜 제한적으로 만들 수 없습니다.
$false: 정책에 대해 보존 잠금을 사용할 수 없습니다. 이 값은 기본값입니다.

정책을 잠그면 누구도 정책을 해제하거나 사용하지 않도록 설정할 수 없고 정책에서 콘텐츠를 제거할 수 없습니다. 또한 보존 기간 동안 정책의 적용을 받는 콘텐츠를 수정하거나 삭제할 수 없습니다. 콘텐츠를 추가하거나 기간을 확장해야만 보존 정책을 수정할 수 있습니다. 잠긴 정책은 늘리거나 확장할 수 있지만 축소, 비활성화 또는 해제할 수는 없습니다.

따라서 보존 정책을 잠그기 전에 organization 규정 준수 요구 사항을 이해하고 필요한 것이 확실할 때까지 정책을 잠그지 않는 것이 중요합니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-RetainCloudAttachment

참고: 이 매개 변수는 현재 미리 보기로 제공되며, 모든 조직에서 사용할 수 없으며 변경될 수 있습니다.

RetainCloudAttachment 매개 변수는 클라우드 첨부 파일 정책임을 지정합니다. 유효한 값은 다음과 같습니다.

$true: 정책은 클라우드 첨부 파일 정책입니다.
$false: 정책은 클라우드 첨부 파일 정책이 아닙니다. 이 값은 기본값입니다.

값 $true 경우 다음 위치 매개 변수만 사용할 수 있습니다.

SharePointLocation 및 SharePointLocationException
OneDriveLocation 및 OneDriveLocationException
ModernGroupLocation 및 ModernGroupLocationException

클라우드 첨부 파일 정책을 사용하여 규칙을 만드는 태그는 레코드 레이블 또는 규정 레이블일 수 있습니다. 클라우드 첨부 파일 정책에 게시 태그를 사용하여 규칙을 만들 수 없습니다. 적용 태그만 지원됩니다.

retainCloudAttachment 매개 변수는 Set-RetentionCompliancePolicy cmdlet에서 사용할 수 없습니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-SharePointLocation

SharePointLocation 매개 변수는 포함할 SharePoint Online 사이트를 지정합니다. URL 값으로 사이트를 식별하거나 모든 사이트를 포함하기 위해 All 값을 사용할 수 있습니다.

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

SharePoint Online 사이트는 인덱싱될 때까지 정책에 추가할 수 없습니다. 지정된 사이트가 없는 경우 사이트가 보류되지 않습니다.

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-SharePointLocationException

이 매개 변수는 SharePointLocation 매개 변수에 All 값을 사용할 때 제외할 SharePoint Online 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-SkipPriorityCleanupConfirmation

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-SkypeLocation

SkypeLocation 매개 변수는 정책에 포함할 비즈니스용 Skype Online 사용자를 지정합니다.

사용자를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

이름
이름
DN(고유 이름)
GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-SkypeLocationException

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-TeamsChannelLocation

TeamsChannelLocation 매개 변수는 정책에 포함할 Teams를 지정합니다.

팀을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

이름
전자 메일 주소
GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-TeamsChannelLocationException

TeamsChannelLocationException 매개 변수는 TeamsChannelLocation 매개 변수에 All 값을 사용할 때 제외할 Teams를 지정합니다. 팀을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

이름
전자 메일 주소
GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-TeamsChatLocation

TeamsChatLocation 매개 변수는 정책에 포함할 Teams 사용자를 지정합니다.

사용자를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

이름
이름
DN(고유 이름)
GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-TeamsChatLocationException

TeamsChatLocationException 매개 변수는 TeamsChatLocation 매개 변수에 All 값을 사용할 때 제외할 Teams 사용자를 지정합니다. 사용자를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

이름
이름
DN(고유 이름)
GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

형식:	MultiValuedProperty
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

-WhatIf

WhatIf 스위치는 보안 및 준수 PowerShell에서 작동하지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False
적용 대상:	Security & Compliance

다음을 통해 공유

New-RetentionCompliancePolicy

구문

Description

예제

예 1

예 2

매개 변수

-AdaptiveScopeLocation

-Applications

-Comment

-Confirm

-Enabled

-ExchangeLocation

-ExchangeLocationException

-Force

-IsSimulation

-ModernGroupLocation

-ModernGroupLocationException

-Name

-OneDriveLocation

-OneDriveLocationException

-PolicyRBACScopes

-PolicyTemplateInfo

-PriorityCleanup

-PublicFolderLocation

-RestrictiveRetention

-RetainCloudAttachment

-SharePointLocation

-SharePointLocationException

-SkipPriorityCleanupConfirmation

-SkypeLocation

-SkypeLocationException

-TeamsChannelLocation

-TeamsChannelLocationException

-TeamsChatLocation

-TeamsChatLocationException

-WhatIf

피드백

추가 리소스