다음을 통해 공유


Set-RetentionCompliancePolicy

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

Set-RetentionCompliancePolicy cmdlet을 사용하여 Microsoft Purview 규정 준수 포털 기존 보존 정책을 수정합니다.

참고: 이 cmdlet을 실행하면 organization 전체 동기화가 수행되며 이는 중요한 작업입니다. 여러 정책을 업데이트해야 하는 경우 정책 배포가 성공할 때까지 기다렸다가 cmdlet을 다시 실행하여 다음 정책을 실행합니다. 배포 상태 대한 자세한 내용은 Get-RetentionCompliancePolicy를 참조하세요.

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

구문

Identity

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddExchangeLocation <MultiValuedProperty>]
    [-AddExchangeLocationException <MultiValuedProperty>]
    [-AddModernGroupLocation <MultiValuedProperty>]
    [-AddModernGroupLocationException <MultiValuedProperty>]
    [-AddOneDriveLocation <MultiValuedProperty>]
    [-AddOneDriveLocationException <MultiValuedProperty>]
    [-AddPublicFolderLocation <MultiValuedProperty>]
    [-AddSharePointLocation <MultiValuedProperty>]
    [-AddSharePointLocationException <MultiValuedProperty>]
    [-AddSkypeLocation <MultiValuedProperty>]
    [-AddSkypeLocationException <MultiValuedProperty>]
    [-Applications <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-EnforceSimulationPolicy <Boolean>]
    [-Force]
    [-PolicyTemplateInfo <PswsHashtable>]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-PriorityCleanup]
    [-RemoveExchangeLocation <MultiValuedProperty>]
    [-RemoveExchangeLocationException <MultiValuedProperty>]
    [-RemoveModernGroupLocation <MultiValuedProperty>]
    [-RemoveModernGroupLocationException <MultiValuedProperty>]
    [-RemoveOneDriveLocation <MultiValuedProperty>]
    [-RemoveOneDriveLocationException <MultiValuedProperty>]
    [-RemovePublicFolderLocation <MultiValuedProperty>]
    [-RemoveSharePointLocation <MultiValuedProperty>]
    [-RemoveSharePointLocationException <MultiValuedProperty>]
    [-RemoveSkypeLocation <MultiValuedProperty>]
    [-RemoveSkypeLocationException <MultiValuedProperty>]
    [-RestrictiveRetention <Boolean>]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

AdaptiveScopeLocation

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddAdaptiveScopeLocation <MultiValuedProperty>]
    [-Applications <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-EnforceSimulationPolicy <Boolean>]
    [-Force]
    [-PriorityCleanup]
    [-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

RetryDistribution

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-RetryDistribution]
    [-Confirm]
    [-DeletedResources <String>]
    [-EnforceSimulationPolicy <Boolean>]
    [-PriorityCleanup]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

TeamLocation

Set-RetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddTeamsChannelLocation <MultiValuedProperty>]
    [-AddTeamsChannelLocationException <MultiValuedProperty>]
    [-AddTeamsChatLocation <MultiValuedProperty>]
    [-AddTeamsChatLocationException <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-EnforceSimulationPolicy <Boolean>]
    [-Force]
    [-PriorityCleanup]
    [-RemoveTeamsChannelLocation <MultiValuedProperty>]
    [-RemoveTeamsChannelLocationException <MultiValuedProperty>]
    [-RemoveTeamsChatLocation <MultiValuedProperty>]
    [-RemoveTeamsChatLocationException <MultiValuedProperty>]
    [-StartSimulation <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Description

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

참고: scope 위치를 "Value1","Value2",..."ValueN" | Foreach-Object {Set-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}추가하거나 제거할 때는 파이프된 Foreach-Object 명령을 사용하지 마세요.

예제

예 1

Set-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -AddExchangeLocation "Kitty Petersen" -AddSharePointLocation "https://contoso.sharepoint.com/sites/teams/finance" -RemovePublicFolderLocation All -Comment "Added new counsel, 9/9/14"

이 예에서는 "Regulation 123 Compliance"라는 기존 보존 정책을 다음과 같이 변경합니다.

  • Kitty Petersen 사용자의 사서함에 추가합니다.
  • SharePoint 사이트 https://contoso.sharepoint.com/sites/teams/finance를 추가합니다.
  • 공용 폴더를 제거합니다.
  • 메모를 업데이트합니다.

예 2

$stringJson = @"
[{
     'EmailAddress': 'USSales@contoso.onmicrosoft.com',
     'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson

이 예제에서는 지정된 정책에서 삭제된 Microsoft 365 그룹 및 사이트를 제거합니다. Microsoft 365 그룹 전자 메일 주소 및 관련 사이트 ID를 사용하여 삭제된 리소스를 식별합니다.

중요: 이 명령을 실행하기 전에 중복된 SMTP 주소에 대한 DeletedResources 매개 변수 에 대한 주의 정보를 읽어야 합니다.

예 3

$stringJson = @"
[{
     'EmailAddress': 'USSales@contoso.onmicrosoft.com',
     'SiteId': '8b2a8345-b9ec-3b6a-bf31-6eaa83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Tenant Level Policy" -AddModernGroupLocationException "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJson

이 예제에서는 지정된 테넌트 수준 정책에서 삭제된 Microsoft 365 그룹 및 사이트를 제외합니다. Microsoft 365 그룹 전자 메일 주소 및 관련 사이트 ID를 사용하여 삭제된 리소스를 식별합니다.

중요: 이 명령을 실행하기 전에 중복된 SMTP 주소에 대한 DeletedResources 매개 변수 에 대한 주의 정보를 읽어야 합니다.

예 4

$stringJson = @"
[{
     'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
     'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
 },
{
     'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
     'SiteId': '4afb7116-b9ec-4b2c-bf31-4abb83697c4b'
}]
"@

Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales2@contoso.onmicrosoft.com" -DeletedResources $stringJson

이 예제는 여러 개의 삭제된 리소스가 지정된 것을 제외하고 예제 2와 비슷합니다.

중요: 이 명령을 실행하기 전에 중복된 SMTP 주소에 대한 DeletedResources 매개 변수 에 대한 주의 정보를 읽어야 합니다.

예 5

$stringJson = @"
[{
     'EmailAddress': 'SalesUser@contoso.onmicrosoft.com'
}]
"@

Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson

다음은 언급된 Teams 보존 정책에서 지정된 일시 삭제된 사서함 또는 메일 사용자를 제외하는 예제입니다. 사서함 또는 메일 사용자의 전자 메일 주소를 사용하여 삭제된 리소스를 식별할 수 있습니다.

중요: 이 명령을 실행하기 전에 중복된 SMTP 주소에 대한 DeletedResources 매개 변수 에 대한 주의 정보를 읽어야 합니다.

예 6

$stringJson = @"
[{
     'EmailAddress': 'SalesUser1@contoso.onmicrosoft.com'
},
{
     'EmailAddress': 'SalesUser2@contoso.onmicrosoft.com'
}]
"@

Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser1@contoso.onmicrosoft.com", "SalesUser2@contoso.onmicrosoft.com" -DeletedResources $stringJson

이 예제는 여러 개의 삭제된 리소스가 지정된 것을 제외하고 예제 5와 비슷합니다.

중요: 이 명령을 실행하기 전에 중복된 SMTP 주소에 대한 DeletedResources 매개 변수 에 대한 주의 정보를 읽어야 합니다.

정책 제외는 보존 정책에 대해 지원되는 한도 내에서 유지되어야 합니다. Microsoft 365 보존 정책 및 보존 레이블 정책에 대한 제한

매개 변수

-AddAdaptiveScopeLocation

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

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-AddExchangeLocation

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

AddExchangeLocation 매개 변수는 ExchangeLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사서함 목록에 추가할 사서함을 지정합니다. 유효한 값은 다음과 같습니다.

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

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-AddExchangeLocationException

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

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

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

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-AddModernGroupLocation

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

AddModernGroupLocation 매개 변수는 ModernGroupLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 Microsoft 365 그룹 목록에 추가할 Microsoft 365 그룹 지정합니다.

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-AddModernGroupLocationException

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

AddModernGroupLocationException 매개 변수는 ModernGroupLocation 매개 변수에 All 값을 사용할 때 제외된 Microsoft 365 그룹 목록에 추가할 Microsoft 365 그룹 지정합니다.

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-AddOneDriveLocation

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

AddOneDriveLocation 매개 변수는 OneDriveLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사이트 목록에 추가할 OneDrive 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

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

매개 변수 속성

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

매개 변수 집합

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

-AddOneDriveLocationException

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

이 매개 변수는 OneDriveLocation 매개 변수에 All 값을 사용할 때 제외된 사이트 목록에 추가할 OneDrive 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

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

매개 변수 속성

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

매개 변수 집합

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

-AddPublicFolderLocation

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

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

매개 변수 속성

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

매개 변수 집합

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

-AddSharePointLocation

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

AddSharePointLocation 매개 변수는 SharePointLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사이트 목록에 추가할 SharePoint 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

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

SharePoint 사이트는 인덱싱될 때까지 정책에 추가할 수 없습니다.

매개 변수 속성

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

매개 변수 집합

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

-AddSharePointLocationException

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-AddSkypeLocation

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

AddSkypeLocation 매개 변수는 포함된 비즈니스용 Skype Online 사용자 목록에서 추가할 비즈니스용 Skype Online 사용자를 지정합니다.

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-AddSkypeLocationException

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

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

매개 변수 속성

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

매개 변수 집합

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

-AddTeamsChannelLocation

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

AddTeamsChannelLocation 매개 변수는 정책에 추가할 Teams를 지정합니다.

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

  • 이름
  • 전자 메일 주소
  • GUID

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

매개 변수 속성

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

매개 변수 집합

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

-AddTeamsChannelLocationException

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

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

  • 이름
  • 전자 메일 주소
  • GUID

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

매개 변수 속성

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

매개 변수 집합

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

-AddTeamsChatLocation

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

AddTeamsChatLocation 매개 변수는 정책에 추가할 Teams 사용자를 지정합니다.

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-AddTeamsChatLocationException

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

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

  • 이름
  • 전자 메일 주소
  • GUID

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

매개 변수 속성

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

매개 변수 집합

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

-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"과 동일합니다. 선택한 Microsoft 365 그룹이 사서함과 SharePoint 사이트의 기본값으로 돌아가기 위해 "Group:Exchange,SharePoint"를 지정하세요.

매개 변수 속성

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

매개 변수 집합

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

-Comment

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

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

매개 변수 속성

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

매개 변수 집합

Identity
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
TeamLocation
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

-DeletedResources

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

DeletedResources 매개 변수는 삭제된 Microsoft 365 그룹, 사서함 또는 메일 사용자를 제거하거나 해당 위치 목록에 제외로 추가하도록 지정합니다. 삭제된 Microsoft 365 그룹 대한 AddModernGroupLocationException 및 RemoveModernGroupLocation 매개 변수 또는 삭제된 사서함 또는 메일 사용자의 경우 AddTeamsChatLocationException 매개 변수와 함께 이 매개 변수를 사용합니다.

유효한 값은 JSON 문자열입니다. 이 매개 변수의 구문 및 사용 예제는 예제 섹션을 참조하세요.

주의: 이 매개 변수와 함께 SMTP 주소를 사용하는 경우 다른 사서함 또는 메일 사용자에게도 동일한 주소가 사용 중일 수 있습니다. 동일한 SMTP 주소를 가진 추가 사서함 또는 메일 사용자를 검사 하려면 다음 명령을 user@contoso.com 사용하고 를 SMTP 주소로 바꿔 검사.Get-Recipient -IncludeSoftDeletedRecipients user@contoso.com | Select-Object DisplayName, EmailAddresses, Description, Alias, RecipientTypeDetails, WhenSoftDeleted

SMTP 주소가 동일한 활성 사서함 또는 메일 사용자가 제외되지 않도록 하려면 DeletedResources 매개 변수를 사용하여 명령을 실행하기 전에 사서함을 소송 보존 에 배치합니다.

삭제된 Microsoft 365 그룹 시나리오에 대한 자세한 내용은 보존 보류 중인 최신 그룹 삭제에 대한 자세한 내용을 참조하세요.

비활성 사서함 시나리오에 대한 자세한 내용은 비활성 사서함에 대해 알아보기를 참조하세요.

매개 변수 속성

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

매개 변수 집합

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

-Enabled

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-EnforceSimulationPolicy

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

EnforceSimulationPolicy 매개 변수는 시뮬레이션 정책을 활성 정책으로 적용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 시뮬레이션 정책을 활성 정책으로 적용합니다.
  • $false: 시뮬레이션 정책을 활성 정책으로 적용하지 마세요. 이 값은 기본값입니다.

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

매개 변수 속성

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

매개 변수 집합

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

-Force

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-Identity

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

Identity 매개 변수는 수정할 보존 정책을 지정합니다. 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

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

매개 변수 속성

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

매개 변수 집합

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

-PolicyRBACScopes

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

참고: 관리 단위는 현재 지원되지 않으므로 이 매개 변수가 작동하지 않습니다. 여기에 제공된 정보는 관리 단위에 대한 지원이 릴리스될 때 정보 제공을 위한 것입니다.

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

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

매개 변수 속성

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

매개 변수 집합

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

-PolicyTemplateInfo

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

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

매개 변수 속성

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

매개 변수 집합

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

-PriorityCleanup

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

PriorityCleanup 스위치는 우선 순위 정리 정책을 업데이트할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

우선 순위 정리 정책은 기존 보존 설정 또는 eDiscovery 보류를 재정의하여 중요한 콘텐츠의 삭제를 신속하게 처리합니다. 자세한 내용은 우선 순위 정리를 참조하세요.

매개 변수 속성

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

매개 변수 집합

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

-RemoveAdaptiveScopeLocation

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

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveExchangeLocation

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

RemoveExchangeLocation 매개 변수는 ExchangeLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사서함 목록에서 제거할 사서함을 지정합니다.

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveExchangeLocationException

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

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

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveModernGroupLocation

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

RemoveModernGroupLocation 매개 변수는 ModernGroupLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 그룹 목록에서 제거할 Microsoft 365 그룹 지정합니다.

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveModernGroupLocationException

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

RemoveModernGroupLocationException 매개 변수는 ModernGroupLocation 매개 변수에 All 값을 사용할 때 제외된 그룹 목록에서 제거할 Microsoft 365 그룹 지정합니다.

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveOneDriveLocation

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

RemoveOneDriveLocation 매개 변수는 OneDriveLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사이트 목록에서 제거할 OneDrive 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveOneDriveLocationException

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

이 매개 변수는 OneDriveLocation 매개 변수에 All 값을 사용할 때 제외된 사이트 목록에서 제거할 OneDrive 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

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

매개 변수 속성

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

매개 변수 집합

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

-RemovePublicFolderLocation

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

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveSharePointLocation

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

RemoveSharePointLocation 매개 변수는 SharePointLocation 매개 변수에 All 값을 사용하지 않을 때 포함된 사이트 목록에서 제거할 SharePoint 사이트를 지정합니다. URL 값으로 사이트를 식별합니다.

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveSharePointLocationException

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveSkypeLocation

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

RemoveSkypeLocation 매개 변수는 포함된 비즈니스용 Skype Online 사용자 목록에서 제거할 비즈니스용 Skype Online 사용자를 지정합니다.

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveSkypeLocationException

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

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveTeamsChannelLocation

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

RemoveTeamsChannelLocation 매개 변수는 정책에서 제거할 Teams를 지정합니다.

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

  • 이름
  • 전자 메일 주소
  • GUID

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveTeamsChannelLocationException

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

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

  • 이름
  • 전자 메일 주소
  • GUID

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveTeamsChatLocation

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

RemoveTeamsChatLocation 매개 변수는 정책에서 제거할 Teams 사용자를 지정합니다.

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

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

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

매개 변수 속성

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

매개 변수 집합

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

-RemoveTeamsChatLocationException

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

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

  • 이름
  • 전자 메일 주소
  • GUID

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

매개 변수 속성

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

매개 변수 집합

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

-RestrictiveRetention

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

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

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

정책이 잠긴 후에는 아무도 정책을 해제하거나 사용하지 않도록 설정하거나 정책에서 콘텐츠를 제거할 수 없습니다. 또한 보존 기간 동안 정책의 적용을 받는 콘텐츠를 수정하거나 삭제할 수 없습니다. 보존 정책을 수정할 수 있는 유일한 방법은 콘텐츠를 추가하거나 기간을 연장하는 것입니다. 잠긴 정책은 늘리거나 확장할 수 있지만 축소, 비활성화 또는 해제할 수는 없습니다.

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

매개 변수 속성

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

매개 변수 집합

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

-RetryDistribution

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

RetryDistribution 스위치는 정책을 모든 Exchange Online 및 SharePoint 위치에 재배포할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

초기 배포가 성공적으로 수행된 위치는 다시 시도에 포함되지 않습니다. 이 스위치를 사용하는 경우 정책 배포 오류가 보고됩니다.

매개 변수 속성

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

매개 변수 집합

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

-StartSimulation

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

StartSimulation 매개 변수는 시뮬레이션 모드에서 만든 정책에 대한 시뮬레이션을 시작할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 시뮬레이션을 시작합니다.
  • $false: 시뮬레이션을 시작하지 마세요. 이 값은 기본값입니다.

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

매개 변수 속성

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

매개 변수 집합

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

-WhatIf

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

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

매개 변수 속성

형식: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를 참조하세요.