Set-AppRetentionCompliancePolicy
이 cmdlet은 보안 & 준수 PowerShell에서만 사용할 수 있습니다. 자세한 내용은 보안 & 준수 PowerShell을 참조하세요.
Set-AppRetentionCompliancePolicy 사용하여 앱 보존 규정 준수 정책을 수정합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddExchangeLocationException <MultiValuedProperty>]
[-AddModernGroupLocation <MultiValuedProperty>]
[-AddModernGroupLocationException <MultiValuedProperty>]
[-Applications <String[]>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-PolicyRBACScopes <MultiValuedProperty>]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemoveExchangeLocationException <MultiValuedProperty>]
[-RemoveModernGroupLocation <MultiValuedProperty>]
[-RemoveModernGroupLocationException <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddAdaptiveScopeLocation <MultiValuedProperty>]
[-Applications <String[]>]
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-Force]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-Force]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-WhatIf]
[<CommonParameters>] Set-AppRetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-Confirm]
[-RetryDistribution]
[-WhatIf]
[<CommonParameters>] Description
보안 & 준수 PowerShell에서 이 cmdlet을 사용하려면 권한이 할당되어야 합니다. 자세한 내용은 Microsoft Purview 규정 준수 포털의 사용 권한을 참조하세요.
예제
예 1
Set-AppRetentionCompliancePolicy Identity "Regulation 563 Marketing" -Applications "User:MicrosoftTeams","Group:MicrosoftTeams,Yammer" -AddExchangeLocation "Scott Smith" -Comment "Added new counsel, 9/9/21"다음은 Teams 프라이빗 채널 메시지에 대해 설정된 규정 563 Marketing이라는 기존 정적 범위 보존 정책에 새 사용자를 추가하는 예제입니다.
매개 변수
-AddAdaptiveScopeLocation
AddAdaptiveScopeLocation 매개 변수는 정책에 추가할 적응 범위 위치를 지정합니다. New-AdaptiveScope cmdlet을 사용하여 적응형 범위를 만듭니다. 적응 범위를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- DN(고유 이름)
- GUID
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddExchangeLocation
AddExchangeLocation 매개 변수는 ExchangeLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사서함 목록에 추가할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.
- ExchangeLocation 매개 변수는 정책에 포함할 사서함을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.
- 사서함
모든 사서함에 대해 값 All입니다. 이 값만 사용할 수 있습니다.
- 이름
- 이름
- DN(고유 이름)
- GUID
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddExchangeLocationException
AddExchangeLocationException 매개 변수는 ExchangeLocation 매개 변수에 All 값을 사용할 때 제외된 사서함 목록에 추가할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.
- All 매개 변수는 ExchangeLocation 값을 사용할 때 제외된 사서함 목록에서 제거할 사서함을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.
- 사서함
모든 사서함에 대해 값 All입니다. 이 값만 사용할 수 있습니다.
- 이름
- 이름
- DN(고유 이름)
- GUID
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddModernGroupLocation
AddModernGroupLocation 매개 변수는 ModernGroupLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 Microsoft 365 그룹 목록에 추가할 Microsoft 365 그룹 지정합니다.
Microsoft 365 그룹을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- 이름
- DN(고유 이름)
- GUID
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddModernGroupLocationException
AddModernGroupLocationException 매개 변수는 ModernGroupLocation 매개 변수에 All 값을 사용할 때 제외된 Microsoft 365 그룹 목록에 추가할 Microsoft 365 그룹 지정합니다.
Microsoft 365 그룹을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- 이름
- DN(고유 이름)
- GUID
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Applications
Applications 매개 변수는 포함할 애플리케이션을 지정하며 다음 위치 매개 변수에만 관련됩니다.
- ExchangeLocation
- ModernGroupLocation
- AdaptiveScopeLocation
이 매개 변수는 다음 구문을 "LocationtType:App1,LocationType:App2,...LocationType:AppN 사용합니다. 여기서 LocationType은 User 또는 Group입니다. 예를 들어 "User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint" 또는 "User:MicrosoftTeams","User:Yammer"입니다.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Comment
Comment 매개 변수는 설명(선택 사항)을 지정합니다. 공백이 포함된 값을 지정하는 경우 값을 큰따옴표(")로 묶어야 합니다(예: “이는 관리자 정보입니다”).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-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 |
-Enabled
Enabled 매개 변수는 정책을 사용하거나 사용하지 않도록 설정합니다. 유효한 값은 다음과 같습니다.
- $true: 정책이 활성화되어 있습니다. 이 값은 기본값입니다.
- $true: 이 정책은 사용하도록 설정되어 있습니다. 이 값은 기본값입니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Force
강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
관리 입력에 대한 확인 메시지를 표시하는 것이 부적절한 경우 이 스위치를 사용하여 작업을 프로그래밍 방식으로 실행할 수 있습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Identity
Identity 매개 변수는 수정하려는 앱 보존 규정 준수 정책을 지정합니다. 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.
- 이름
- DN(고유 이름)
- GUID
| Type: | PolicyIdParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-PolicyRBACScopes
{{ Fill PolicyRBACScopes Description }}
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveAdaptiveScopeLocation
RemoveAdaptiveScopeLocation 매개 변수는 정책에서 제거할 적응 범위 위치를 지정합니다. New-AdaptiveScope cmdlet을 사용하여 적응형 범위를 만듭니다. 적응 범위를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- DN(고유 이름)
- GUID
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveExchangeLocation
RemoveExchangeLocation 매개 변수는 ExchangeLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사서함 목록에서 제거할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.
- All 매개 변수는 ExchangeLocation 값을 사용할 때 제외된 사서함 목록에서 제거할 사서함을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.
- 사서함
모든 사서함에 대해 값 All입니다. 이 값만 사용할 수 있습니다.
- 이름
- 이름
- DN(고유 이름)
- GUID
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveExchangeLocationException
RemoveExchangeLocationException 매개 변수는 ExchangeLocation 매개 변수에 All 값을 사용할 때 제외된 사서함 목록에서 제거할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.
- All 매개 변수는 ExchangeLocation 값을 사용할 때 제외된 사서함 목록에서 제거할 사서함을 지정합니다. 사용할 수 있는 값은 다음과 같습니다.
- 사서함
모든 사서함에 대해 값 All입니다. 이 값만 사용할 수 있습니다.
- 이름
- 이름
- DN(고유 이름)
- GUID
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveModernGroupLocation
RemoveModernGroupLocation 매개 변수는 ModernGroupLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 그룹 목록에서 제거할 Microsoft 365 그룹 지정합니다.
Microsoft 365 그룹을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- 이름
- DN(고유 이름)
- GUID
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveModernGroupLocationException
RemoveModernGroupLocationException 매개 변수는 ModernGroupLocation 매개 변수에 All 값을 사용할 때 제외된 그룹 목록에서 제거할 Microsoft 365 그룹 지정합니다.
Microsoft 365 그룹을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- 이름
- DN(고유 이름)
- GUID
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RestrictiveRetention
RestrictiveRetention 매개 변수는 정책에 보존 잠금을 사용할 수 있는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 정책에 대해 보존 잠금을 사용할 수 있습니다. 관리자를 포함한 누구도 정책을 해제하거나 덜 제한적으로 만들 수 없습니다.
- $false: 정책에 대해 보존 잠금을 사용할 수 없습니다. 이 값은 기본값입니다.
정책이 잠긴 후에는 아무도 정책을 해제하거나 사용하지 않도록 설정하거나 정책에서 앱을 제거할 수 없습니다. 정책을 수정할 수 있는 유일한 방법은 앱을 추가하거나 기간을 연장하는 것입니다. 잠긴 정책은 늘리거나 확장할 수 있지만 축소, 비활성화 또는 해제할 수는 없습니다.
따라서 정책을 잠그기 전에 조직의 규정 준수 요구 사항을 이해하고 필요한 것이 확실할 때까지 정책을 잠그지 않는 것이 중요합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetryDistribution
RetryDistribution 스위치는 정책을 모든 위치에 재배포할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
초기 배포가 성공적으로 수행된 위치는 다시 시도에 포함되지 않습니다. 이 스위치를 사용하는 경우 정책 배포 오류가 보고됩니다.
참고: 배포를 다시 시도하는 프로세스는 중요한 작업이므로 필요한 경우에만 한 번에 하나의 정책에 대해 실행합니다. 정책을 업데이트할 때마다 실행되지 않습니다. 여러 정책을 업데이트하는 스크립트를 실행하는 경우 정책 배포가 성공할 때까지 기다렸다가 명령을 다시 실행하여 다음 정책을 실행합니다.
| Type: | SwitchParameter |
| 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 |