Get-RetentionCompliancePolicy

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Security & Compliance

このコマンドレットは、セキュリティ & コンプライアンス PowerShell でのみ使用できます。詳細については、「セキュリティ & コンプライアンス PowerShell」を参照してください。

Get-RetentionCompliancePolicyを使用して、Microsoft Purview コンプライアンスポータル内の既存のアイテム保持ポリシーを表示します。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Get-RetentionCompliancePolicy
   [[-Identity] <PolicyIdParameter>]
   [-DistributionDetail]
   [-ErrorPolicyOnly]
   [-ExcludeTeamsPolicy]
   [-IncludeTestModeResults]
   [-RetentionRuleTypes]
   [-TeamsPolicyOnly]
   [<CommonParameters>]

説明

この一覧では、既定で表示されるプロパティについて説明します。

Name: ポリシーの一意の名前。
ワークロード: 現時点では、すべてのワークロード (Exchange、SharePoint、OneDriveForBusiness、Skype、ModernGroup) が表示され、ポリシーが適用されている実際のワークロードは表示されません。
Enabled: 値 True はポリシーが有効であることを意味します。
Mode:ポリシーの現在の運用モード。使用可能な値は、テスト (コンテンツはテストされますが、ルールは適用されません)、AuditAndNotify (コンテンツがポリシーで指定された条件と一致する場合、ルールは適用されませんが、通知メールは送信されます)、または強制 (ポリシーのすべての側面が有効および適用されます) です。

セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。詳細については、「Microsoft Purview コンプライアンスセンターのアクセス許可」を参照してください。

例

例 1

Get-RetentionCompliancePolicy

この例では、組織内のすべてのアイテム保持ポリシーに関する概要情報を表示します。

例 2

Get-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -DistributionDetail | Format-List

この例では、「Regulation 123 Compliance」という名前のポリシーについて、DistributionStatus プロパティと *Location プロパティの正確な値を含め、詳しい情報を表示します。

パラメーター

-DistributionDetail

DistributionDetail スイッチは、DistributionResults プロパティで詳細なポリシー配布情報を返します。このスイッチで値を指定する必要はありません。

このスイッチを使用しない場合、DistributionStatus プロパティと *Location プロパティの値は不正確なものになります。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ErrorPolicyOnly

ErrorPolicyOnly スイッチは、結果に分散エラーがあるポリシーのみを表示するかどうかを指定します。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ExcludeTeamsPolicy

ExcludeTeamsPolicy スイッチは、結果から Teams ポリシーを除外するかどうかを指定します。このスイッチで値を指定する必要はありません。

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:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Security & Compliance

-IncludeTestModeResults

IncludeTestModeResults スイッチは、ポリシーの詳細にテストモードの状態を含めるかどうかを指定します。このスイッチで値を指定する必要はありません。

シミュレーションモードの詳細については、「シミュレーションモードについて」を参照してください。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetentionRuleTypes

RetentionRuleTypes スイッチは、結果で RetentionRuleTypes プロパティの値を返すかどうかを指定します。このスイッチで値を指定する必要はありません。

RetentionRuleTypes プロパティを参照するには、このコマンドを書式設定コマンドレットにパイプします。たとえば、「 Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes 」のように入力します。 RetentionRuleTypes スイッチを使用しない場合、値は空白になります。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-TeamsPolicyOnly

TeamsPolicyOnly スイッチは、結果に Teams ポリシーのみを表示するかどうかを指定します。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance