アイテム保持ポリシーと保持ラベルの PowerShell コマンドレット
次のセクションを使用して、大規模な構成、自動化されたスクリプト、または高度な構成シナリオに必要な保持ポリシーと保持ラベルに使用できるメイン 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 グループ メールボックスと Microsoft 365 グループ サイト |
Get-ComplianceTag New-ComplianceTag Remove-ComplianceTag Set-ComplianceTag |
保持ラベルの表示、作成、削除、構成 | Exchange メールボックス SharePoint サイト (または SharePoint クラシック サイトとコミュニケーション サイト) OneDrive アカウント Microsoft 365 グループ メールボックスと Microsoft 365 グループ サイト |
Get-RecordReviewNotificationTemplateConfig Set-RecordReviewNotificationTemplateConfig |
廃棄レビューの通知とアラームの設定を表示または構成する | Exchange メールボックス SharePoint サイト (または SharePoint クラシック サイトとコミュニケーション サイト) OneDrive アカウント Microsoft 365 グループ メールボックスと Microsoft 365 グループ サイト |
Get-RetentionCompliancePolicy New-RetentionCompliancePolicy Remove-RetentionCompliancePolicy Set-RetentionCompliancePolicy |
アイテム保持ポリシーとアイテム保持ラベル ポリシーを表示、作成、削除、構成する | Exchange メール SharePoint サイト (または SharePoint クラシック サイトとコミュニケーション サイト) OneDrive アカウント Microsoft 365 グループ メールボックスと Microsoft 365 グループ サイト Skype for Business Exchange パブリック フォルダー Teams のチャット メッセージ チームのチャネル メッセージ |
Get-RetentionComplianceRule New-RetentionComplianceRule Set-RetentionComplianceRule Remove-RetentionComplianceRule |
アイテム保持ポリシーと保持ラベルの設定 (ルール) を表示、作成、構成、削除する | Exchange メール SharePoint サイト (または SharePoint クラシック サイトとコミュニケーション サイト) OneDrive アカウント Microsoft 365 グループ メールボックスと 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 を使用して保持ラベルを作成して発行する」を参照してください。