Set-CMSettingDeployment

既存の設定ポリシーの展開を構成します。

構文

Set-CMSettingDeployment
   [-CMSettingsDeployment] <SettingsDeployment>
   [-Schedule <IResultObject>]
   [-OverrideServiceWindows <Boolean>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

説明

既存の設定ポリシーの展開を構成します。 たとえば、BitLocker 管理ポリシーまたは Microsoft Defender アプリケーション制御ポリシーの展開を構成します。

例 1: BitLocker 管理ポリシーの展開のスケジュールを変更する

この例では、名前で BitLocker 管理ポリシー設定オブジェクトを取得します。 その後、パイプ演算子を使用して、そのポリシー オブジェクトのデプロイを取得します。 パイプ 演算子を使用して、デプロイのスケジュールを変更します。

Get-CMBlmSetting -Name "My BitLocker setting" | Get-CMSettingDeployment | Set-CMSettingDeployment -Schedule (New-CMSchedule -Start ((Get-Date).AddDays(-30)).ToString() -RecurCount 7 -RecurInterval Minutes)

例 2: Microsoft Defender アプリケーション制御ポリシーの展開を構成する

この例では、アプリケーション制御ポリシー オブジェクトを名前で取得します。 その後、パイプ演算子を使用して、そのポリシー オブジェクトのデプロイを取得します。 パイプ オペレーターを使用してデプロイを変更し、クライアントがメンテナンス期間外のポリシーを修復できるようにします。

Get-CMWdacSetting -Name "My App Control setting"  | Get-CMSettingDeployment | Set-CMSettingDeployment -OverrideServiceWindows

パラメーター

-CMSettingsDeployment

構成する設定デプロイ オブジェクトを指定します。 デプロイ オブジェクトを取得するには、 Get-CMSettingDeployment コマンドレットを 使用します。

型:SettingsDeployment
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OverrideServiceWindows

このパラメーターを追加すると、クライアントはメンテナンス期間外の設定を修復できます。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

作業中のアイテムを表す オブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Schedule

デプロイに適用する schedule オブジェクトを指定します。 カスタム スケジュールを作成するには、 New-CMSchedule コマンドレットを 使用します。

型:IResultObject
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment

出力

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.Deployments.SettingsDeployment.SettingsDeployment