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

在 OneDrive 網站因為離職的使用者和對應的非作用中信箱而脫離合規性界限的情況下，此 Cmdlet 非常有用。

若要在安全性 & 合規性 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 參數會指定命令的動作。有效值為：

GetStatus
Set

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

適用：安全性 & 合規性

Confirm 參數會指定要顯示或隱藏確認提示。這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EmailAddress

適用：安全性 & 合規性

EmailAddress 參數會指定受影響的使用者信箱。您可以使用下列值來唯一識別信箱：

名稱
電子郵件地址
別名
ExchangeGUID

如果值包含空格，請使用引號括住值。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	2
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PropertyName

適用：安全性 & 合規性

PropertyName 參數會指定您要檢視或修改之 OneDrive 網站的合規性界限屬性名稱。有效值為：

CustomAttribute1 到 CustomAttribute15

使用 PropertyValue 參數來設定合規性界限。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	3
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PropertyValue

適用：安全性 & 合規性

當您使用 Action 參數值 Set 來設定 OneDrive 網站的合規性界限時，PropertyValue 參數會指定 PropertyName 值的值。如果值包含空格，請使用引號 (") 括住值。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	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
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	5
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

適用：安全性 & 合規性

WhatIf 開關無法在安全性與合規性 PowerShell 中使用。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

意見反應

此頁面對您有幫助嗎？

共用方式為

Invoke-ComplianceSecurityFilterAction

語法

Default (預設值)

Description

範例

範例 1

範例 2

範例 3

範例 4

範例 5

參數

-Action

參數屬性

參數集

-Confirm

參數屬性

參數集

-EmailAddress

參數屬性

參數集

-PropertyName

參數屬性

參數集

-PropertyValue

參數屬性

參數集

-SiteUrl

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

意見反應