New-AppRetentionCompliancePolicy
このコマンドレットは、セキュリティ/コンプライアンス PowerShell でのみ使用できます。 詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。
New-AppRetentionCompliancePolicy を使用して、アプリ保持コンプライアンス ポリシーを作成します。 アプリの保持 & ラベル付けポリシーは、ポリシーの範囲指定と管理を行う新しい方法を対象としています。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
AdaptiveScopeLocation
New-AppRetentionCompliancePolicy
[-Name] <String>
-AdaptiveScopeLocation <MultiValuedProperty>
-Applications <String[]>
[-Confirm]
[-Comment <String>]
[-Enabled <Boolean>]
[-Force]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>]
Default
New-AppRetentionCompliancePolicy
[-Name] <String>
-Applications <String[]>
[-Comment <String>]
[-Confirm]
[-Enabled <Boolean>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeLocationException <MultiValuedProperty>]
[-Force]
[-ModernGroupLocation <MultiValuedProperty>]
[-ModernGroupLocationException <MultiValuedProperty>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-WhatIf]
[<CommonParameters>]
説明
*-AppRetentionCompliance* コマンドレットは、アダプティブ ポリシー スコープを持つポリシーと、「 新しい場所向けの保持コマンドレット」で説明されている場所のすべての静的ポリシーに使用されます。 含まれるすべてのワークロードについて、含めるスコープまたは除外するスコープの一覧のみを設定できます。つまり、多くの場合、ワークロードごとに 1 つのポリシーを作成する必要があります。
*-RetentionCompliance* コマンドレットは、 主に「古い場所の保持コマンドレット」で説明されている場所を引き続きサポートします。
セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
例
例 1
New-AppRetentionCompliancePolicy -Name "Regulation 567 Compliance" -Applications "User:MicrosoftTeams","Group:MicrosoftTeams" -ExchangeLocation "Jennifer Petersen","Kitty Nakamura"
この例では、Jennifer Petersen と Kitty Nakamura の Viva Engage ユーザー メッセージの規則 567 コンプライアンスという名前の静的スコープ保持ポリシーを作成します。
アイテム保持ポリシーを作成したら、New-AppRetentionComplianceRule コマンドレットを使用してアイテム保持ルールを作成し、これにアイテム保持ポリシーを割り当てます。
パラメーター
-AdaptiveScopeLocation
適用対象: セキュリティ & コンプライアンス
AdaptiveScopeLocation パラメーターは、ポリシーに含めるアダプティブ スコープの場所を指定します。 適応型スコープを作成するには、New-AdaptiveScope コマンドレットを使用します。 適応型スコープを一意に識別する任意の値を使用できます。 例:
- 名前
- 識別名 (DN)
- GUID
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AdaptiveScopeLocation
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Applications
適用対象: セキュリティ & コンプライアンス
アプリケーション パラメーターは、ポリシーに含めるアプリケーションを指定します。
このパラメーターでは、次の構文が使用されます: "LocationType:App1,LocationType:App2,...LocationType:AppN:
LocationType はユーザーまたはグループです。
App は、次の例で示すようにサポートされている値です。
Microsoft 365 アプリ: 次に例を示します。
"User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint"または"User:MicrosoftTeams" or "User:Yammer"または"User:MicrosoftTeamsCallLog"Microsoft Copilot エクスペリエンス: 現在プレビュー段階です。 次の すべての 値を同時に使用する必要があります。
"User:M365Copilot,CopilotForSecurity,CopilotinFabricPowerBI,CopilotStudio,CopilotinBusinessApplicationplatformsSales,SQLCopilot"注:
CopilotinBusinessApplicationplatformsSalesとSQLCopilotを使用する必要がありますが、これらの値は現時点では関係ありません。エンタープライズ AI アプリ: 現在プレビュー段階です。 次の すべての 値を同時に使用する必要があります。
"User:Entrabased3PAIApps,ChatGPTEnterprise,AzureAIServices"その他の AI アプリ: 現在プレビュー中。 次の すべての 値を同時に使用する必要があります。
"User:CloudAIAppChatGPTConsumer,CloudAIAppGoogleGemini,BingConsumer,DeepSeek"
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Comment
適用対象: セキュリティ & コンプライアンス
Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: セキュリティ & コンプライアンス
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Enabled
適用対象: セキュリティ & コンプライアンス
Enabled パラメーターは、ポリシーを有効または無効にします。 有効な値は次のとおりです。
- $true: ポリシーを有効にします。 この値が既定値です。
- $false: ポリシーを無効にします。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExchangeLocation
適用対象: セキュリティ & コンプライアンス
ExchangeLocation パラメーターは、ポリシーに含めるメールボックスを指定します。 有効な値は次のとおりです。
- ExchangeLocation パラメーターは、ポリシーに含めるメールボックスを指定します。有効な値は次のとおりです。
- メールボックス。
- すべてのメールボックスの値 All。 この値は単体でのみ使用できます。
すべてのメールボックスに対する値 All。 この値のみ、それ自体で使用できます。
- 名前
- 名前
- 識別名 (DN)
- GUID
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExchangeLocationException
適用対象: セキュリティ & コンプライアンス
ExchangeLocationException パラメーターは、ExchangeLocation パラメーターに値 All を使用するときに、ポリシーから除外するメールボックスを指定します。 有効な値は次のとおりです。
- このパラメーターは、ExchangeLocation パラメーターに値 All を使用するときに、除外する一覧から削除するメールボックスを指定します。有効な値は次のとおりです。
- メールボックス。
すべてのメールボックスに対する値 All。 この値のみ、それ自体で使用できます。
- 名前
- 名前
- 識別名 (DN)
- GUID
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
適用対象: セキュリティ & コンプライアンス
[強制] スイッチは、警告または確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ModernGroupLocation
適用対象: セキュリティ & コンプライアンス
ModernGroupLocation パラメーターは、ポリシーに含める Microsoft 365 グループを指定します。 有効な値は次のとおりです。
- A Microsoft 365 グループ
- すべての Microsoft 365 グループの値 All この値は単体でのみ使用できます。
Microsoft 365 グループを識別するには、グループを一意に識別する任意の値を使用できます。 例:
- 名前
- 名前
- 識別名 (DN)
- GUID
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ModernGroupLocationException
適用対象: セキュリティ & コンプライアンス
ModernGroupLocationException パラメーターは、値 All を ModernGroupLocation に使用するときにポリシーから除外する Microsoft 365 グループを指定します。
Microsoft 365 グループを一意に識別する任意の値を使用できます。 例:
- 名前
- 名前
- 識別名 (DN)
- GUID
Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: セキュリティ & コンプライアンス
Name パラメーターは、アプリ保持コンプライアンス ポリシーの一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PolicyRBACScopes
適用対象: セキュリティ & コンプライアンス
注: 管理単位は現在サポートされていないため、このパラメーターは機能しません。 ここに示されている情報は、管理ユニットのサポートがリリースされたときに関する情報提供を目的としています。
PolicyRBACScopes パラメーターは、ポリシーに割り当てる管理単位を指定します。 有効な値は、管理単位の Microsoft Entra ObjectID (GUID 値) です。 複数の値をコンマで区切って指定できます。
管理単位は、Microsoft Entra ID P1 または P2 でのみ使用できます。 管理単位は、Microsoft Graph PowerShell で作成および管理します。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RestrictiveRetention
適用対象: セキュリティ & コンプライアンス
RestrictiveRetention パラメーターは、ポリシーの保持ロックが有効になっているかどうかを指定します。 有効な値は次のとおりです。
- $true: ポリシーの保持ロックが有効になっています。 管理者を含む誰も、ポリシーをオフにしたり、制限を緩めたりすることはできません。
- $false: ポリシーでアイテム保持ロックが有効になっていません。 この値が既定値です。
ポリシーがロックされた後は、誰もポリシーをオフまたは無効にしたり、ポリシーからアプリを削除したりすることはできません。 ポリシーを変更する唯一の方法は、アプリを追加するか、ポリシーの期間を延長することです。 ロックされたポリシーは増加または拡張できますが、削減、無効化、またはオフにすることはできません。
したがって、ポリシーをロックする前に、organization のコンプライアンス要件を理解し、必要なものであることが確実になるまでポリシーをロックしないことが重要です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: セキュリティ & コンプライアンス
WhatIf スイッチは、セキュリティ/コンプライアンス PowerShell では機能しません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。