Invoke-ComplianceSecurityFilterAction

모듈:: Exchange PowerShell

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

Invoke-ComplianceSecurityFilterAction cmdlet을 사용하여 클라우드 기반 조직의 Microsoft OneDrive 사이트에 대한 규정 준수 경계를 보고 설정할 수 있습니다.

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

구문

Default (기본값)

Invoke-ComplianceSecurityFilterAction
    [-Action] <String>
    [[-EmailAddress] <String>]
    [-PropertyName] <String>
    [[-PropertyValue] <String>]
    [-SiteUrl] <String>
    [-Confirm]
    [-WhatIf]
    [<CommonParameters>]

Description

이 cmdlet은 OneDrive 사이트가 떠난 사용자와 해당 비활성 사서함으로 인해 규정 준수 경계를 벗어난 시나리오에서 유용합니다.

보안 & 규정 준수 PowerShell에서 이 cmdlet을 사용하려면 규정 준수 관리자 역할 그룹의 구성원이어야 합니다. 자세한 내용은 Microsoft Purview 규정 준수 포털의 사용 권한을 참조하세요.

예제

예 1

PS C:\> Invoke-ComplianceSecurityFilterAction -Action GetStatus -PropertyName CustomAttribute1 -SiteUrl https://contoso-my.sharepoint.com/personal/lila_contoso_onmicrosoft_com/_layouts/15/onedrive.aspx

SiteUrlOrEmailAddress : https://contoso-my.sharepoint.com/personal/lila_contoso_onmicrosoft_com/_layouts/15/onedrive.aspx
BoundaryType          : UserMailbox
BoundaryInstruction   : Set via Set-Mailbox
BoundaryObjectId      : SPO_f82ace6e-817e-4752-8917-67164dabde98@SPO_775ea11f-a2af-7821-b04c-9848e903ce47
BoundaryStatus        : Success
BoundaryProperty      : CustomAttribute1
BoundaryPropertyValue :

이 예에서는 OneDrive 사이트의 상태를 반환하여 사용자 사서함에 연결되어 있으며 CustomAttribute1 속성이 현재 설정되지 않았음을 나타냅니다.

예 2

PS C:\> Invoke-ComplianceSecurityFi1terAction -Action GetStatus -PropertyName "CustomAttribute3" -EmailAddress "nina@contoso.onmicrosoft.com"

SiteUrlOrEmailAddress : nina@contoso.onmicrosoft.com
BoundaryType          : UserMailbox
BoundaryInstruction   : Set via Set-Mailbox
BoundaryObjectId      : nina@contoso.onmicrosoft.com
BoundaryStatus        : Success
BoundaryProperty      : CustomAttribute3
BoundaryPropertyVa1ue :

이 예제에서는 사서함의 상태를 반환하여 사서함이 비활성 상태이며 CustomAttribute3 속성이 현재 설정되어 있지 않음을 나타냅니다.

예 3

PS C:\> Invoke-ComplianceSecurityFi1terAction -Action GetStatus -PropertyName "CustomAttribute3" -EmailAddress "zhexuan@contoso.onmicrosoft.com"

SiteUrlOrEmailAddress : zhexuan@contoso.onmicrosoft.com
BoundaryType          : InactiveMailbox
BoundaryInstruction   : Set via Invoke-ComplianceSecurityFiIterAction -Set
BoundaryObjectId      : zhexuan@contoso.onmicrosoft.com
BoundaryStatus        : Success
BoundaryProperty      : CustomAttribute3
BoundaryPropertyVa1ue : test33

이 예에서는 사서함의 상태를 반환하여 사서함이 비활성 상태이며 CustomAttribute3 속성이 현재 test33으로 설정되어 있음을 나타냅니다.

예 4

Invoke-ComplianceSecurityFilterAction -Action Set -PropertyName CustomAttribute1 -PropertyValue "Research and Development" -SiteUrl https://contoso-my.sharepoint.com/personal/lila_contoso_onmicrosoft_com/_layouts/15/onedrive.aspx

이 예제에서는 퇴사한 사용자에 대해 지정된 OneDrive 사이트의 경계를 설정합니다.

예 5

PS C:\> Invoke-ComplianceSecurityFiIterAction -Action Set -PropertyName "CustomAttribute3" -PropertyValue "ProjectX" -EmailAddress "zhexuan@contoso.onmicrosoft.com"

Set action succeeded, please use GetStatus to check the result.

PS C:\> Invoke-ComplianceSecurityFiIterAction -Action GetStatus -PropertyName "CustomAttribute3" -EmailAddress "zhexuan@contoso.onmicrosoft.com"

SiteUrlOrEmailAddress : zhexuan@contoso.onmicrosoft.com
BoundaryType          : InactiveMailbox
BoundaryInstruction   : Set via Invoke-ComplianceSecurityFiIterAction -Set
BoundaryObjectId      : zhexuan@contoso.onmicrosoft.com
BoundaryStatus        : Success
BoundaryProperty      : CustomAttribute3
BoundaryPropertyVa1ue : ProjectX

이 예제에서는 지정된 OneDrive 사이트의 경계를 지정된 CustomAttribute3 속성 값으로 설정하고 다른 명령을 실행하여 결과를 검토합니다.

매개 변수

-Action

적용 대상: 보안 & 규정 준수

Action 매개 변수는 명령에 대한 동작을 지정합니다. 유효한 값은 다음과 같습니다.

상태 가져오기
Set

매개 변수 속성

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

매개 변수 집합

(All)

Position:	1
필수:	True
파이프라인의 값:	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

매개 변수 집합

(All)

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

-EmailAddress

적용 대상: 보안 & 규정 준수

EmailAddress 매개 변수는 영향을 받는 사용자 사서함을 지정합니다. 다음 값을 사용하여 사서함을 고유하게 식별할 수 있습니다.

이름
전자 메일 주소
별칭
ExchangeGUID

값에 공백이 포함되어 있으면 값을 큰따옴표로 묶습니다.

매개 변수 속성

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

매개 변수 집합

(All)

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

-PropertyName

적용 대상: 보안 & 규정 준수

PropertyName 매개 변수는 보거나 수정하려는 OneDrive 사이트의 규정 준수 경계 속성 이름을 지정합니다. 유효한 값은 다음과 같습니다.

CustomAttribute1 ~ CustomAttribute15

PropertyValue 매개 변수를 사용하여 규정 준수 경계를 설정합니다.

매개 변수 속성

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

매개 변수 집합

(All)

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

-PropertyValue

적용 대상: 보안 & 규정 준수

PropertyValue 매개 변수는 작업 매개 변수 값 집합을 사용하여 OneDrive 사이트의 규정 준수 경계를 설정할 때 PropertyName 값의 값을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

매개 변수 속성

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

매개 변수 집합

(All)

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

-SiteUrl

적용 대상: 보안 & 규정 준수

SiteUrl 매개 변수는 보거나 수정하려는 OneDrive 사이트를 지정합니다. 이 매개 변수는 https://<domain>-my.sharepoint.com/personal/<user>_<domain>_onmicrosoft_com/_layouts/15/onedrive.aspx 구문을 사용합니다. 예: https://contoso-my.sharepoint.com/personal/lila_contoso_onmicrosoft_com/_layouts/15/onedrive.aspx

매개 변수 속성

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

매개 변수 집합

(All)

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

-WhatIf

적용 대상: 보안 & 규정 준수

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

매개 변수 속성

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

매개 변수 집합

(All)

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

CommonParameters

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

피드백

이 페이지가 도움이 되었나요?