アイテム保持ポリシーと保持ラベルの PowerShell コマンドレット

セキュリティとコンプライアンスのための Microsoft 365 ライセンス ガイダンス。

次のセクションを使用して、大規模な構成、自動スクリプト、または高度な構成シナリオに必要な保持ポリシーと保持ラベルに使用できる主要な PowerShell コマンドレットを特定します。 コマンドレットの完全な一覧については、PowerShell ドキュメントの ポリシーとコンプライアンスのリテンション期間の一覧 を参照してください。

これらのコマンドレットを使用する前に、まず Security & Compliance PowerShell に接続する必要があります。

以降の説明では、保持ポリシーは、アイテム保持ポリシー (ラベルなし) またはアイテム保持ラベル ポリシーを参照できます。 各ポリシーは、静的かアダプティブかを定義し、ポリシーを適用する場所を定義します。

アイテム保持ポリシーを使用する場合、ポリシーでは、1 つのルールで構成を完了する必要があります。たとえば、保持設定を定義するルール (たとえば、5 年間保持してから削除する) が必要です。

保持ラベルを使用すると、保持設定が含まれており、ポリシーにはさまざまなルールが必要です。

• 発行する保持ラベル ポリシーには、アプリに表示するラベルを定義するルールが必要です。
• 自動適用の保持ラベル ポリシーには、適用するラベルとラベルを適用するための条件を定義するルールが必要です。

ヒント

E5 のお客様でない場合は、90 日間の Microsoft Purview ソリューション試用版を使用して、Purview の追加機能が組織のデータ セキュリティとコンプライアンスのニーズの管理にどのように役立つかを確認してください。 Microsoft Purview コンプライアンス ポータルのトライアル ハブで今すぐ開始してください。 サインアップと試用期間の詳細については、こちらをご覧ください。

ほとんどの場所の保持コマンドレット

場所が Exchange メールボックス、 SharePoint サイト、または SharePointクラシックおよびコミュニケーション サイト、 OneDrive アカウント、 Microsoft 365 グループ メールボックス & サイト、 Skype for Business、 Exchange パブリック フォルダー、 Teams チャット メッセージ、または Teams チャネル メッセージである場合は、次の表のコマンドレットを使用します。

場所が Teams プライベート チャネル メッセージ、Viva Engage ユーザー メッセージ、Viva Engage コミュニティ メッセージの場合は、これらのコマンドレットを使用しないでください。 これらの場所には、 次のセクションで識別される代替コマンドレットがあります。

コマンドレット	説明	該当する場所
Enable-ComplianceTagStorage Get-ComplianceTagStorage	ストレージを作成するか、保持ラベルのストレージを表示する 1 回限りの操作	Exchange メールボックス SharePoint サイト (または SharePoint クラシック サイトとコミュニケーション サイト) OneDrive アカウント Microsoft 365 グループ メールボックス & サイト
Get-ComplianceTag New-ComplianceTag Remove-ComplianceTag Set-ComplianceTag	保持ラベルの表示、作成、削除、構成	Exchange メールボックス SharePoint サイト (または SharePoint クラシック サイトとコミュニケーション サイト) OneDrive アカウント Microsoft 365 グループ メールボックス & サイト
Get-RecordReviewNotificationTemplateConfig Set-RecordReviewNotificationTemplateConfig	廃棄レビューの通知とアラームの設定を表示または構成する	Exchange メールボックス SharePoint サイト (または SharePoint クラシック サイトとコミュニケーション サイト) OneDrive アカウント Microsoft 365 グループ メールボックス & サイト
Get-RetentionCompliancePolicy New-RetentionCompliancePolicy Remove-RetentionCompliancePolicy Set-RetentionCompliancePolicy	アイテム保持ポリシーとアイテム保持ラベル ポリシーを表示、作成、削除、構成する	Exchange メール SharePoint サイト (または SharePoint クラシック サイトとコミュニケーション サイト) OneDrive アカウント Microsoft 365 グループ メールボックス & サイト Skype for Business Exchange パブリック フォルダー Teams のチャット メッセージ チームのチャネル メッセージ
Get-RetentionComplianceRule New-RetentionComplianceRule Set-RetentionComplianceRule Remove-RetentionComplianceRule	アイテム保持ポリシーと保持ラベルの設定 (ルール) を表示、作成、構成、削除する	Exchange メール SharePoint サイト (または SharePoint クラシック サイトとコミュニケーション サイト) OneDrive アカウント Microsoft 365 グループ メールボックス & サイト Skype for Business Exchange パブリック フォルダー Teams のチャット メッセージ チームのチャネル メッセージ

Teams プライベート チャネルと Viva Engage に固有の保持コマンドレット

場所が Teams プライベート チャネル メッセージ、Viva Engage ユーザー メッセージ、Viva Engage コミュニティ メッセージの場合は、次のコマンドレットを使用します。

場所が Teams チャット メッセージ、Teams チャネル メッセージ、Exchange メール、SharePoint サイト (または SharePoint クラシックおよびコミュニケーション サイト)、OneDrive アカウント、Microsoft 365 グループ メールボックス & サイト、Skype for Business、または Exchange パブリック フォルダーの場合は、 前のセクションに記載されているコマンドレットを使用します。

コマンドレット	説明	該当する場所
Get-AppRetentionCompliancePolicy New-AppRetentionCompliancePolicy Remove-AppRetentionCompliancePolicy Set-AppRetentionCompliancePolicy	アイテム保持ポリシーの表示、作成、削除、構成	Teams の非公開チャネル メッセージ Viva Engage ユーザー メッセージ Viva Engage コミュニティ メッセージ
Get-AppRetentionComplianceRule New-AppRetentionComplianceRule Remove-AppRetentionComplianceRule Set-AppRetentionComplianceRule	アイテム保持ポリシーの設定 (ルール) を表示、作成、構成、削除する	Teams の非公開チャネル メッセージ Viva Engage ユーザー メッセージ Viva Engage コミュニティ メッセージ

構成ガイダンス

詳細な情報と例については、各コマンドレットに関連付けられているヘルプ ページを使用します。

保持ラベルを作成して発行するためのガイド付きヘルプについては、「 PowerShell を使用して保持ラベルを作成して発行する」を参照してください。