New-CMSettingDeployment

  • リファレンス
モジュール:
ConfigurationManager

設定ポリシー オブジェクトをコレクションに展開します。

構文

New-CMSettingDeployment
   [-CMSetting] <CMSettings>
   [-Schedule <IResultObject>]
   [-OverrideServiceWindows]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

説明

設定ポリシー オブジェクトをコレクションに展開します。 たとえば、BitLocker 管理ポリシーまたは Microsoft Defender アプリケーション制御ポリシーを展開します。 カスタム スケジュールを作成するには 、New-CMSchedule コマンドレットを使用 します。 コレクションを取得するには 、Get-CMCollection コマンドレットを使用 します。

例

例 1: すべてのデスクトップ およびサーバー クライアントに BitLocker 管理オブジェクトを展開する

この例では、BitLocker 管理設定オブジェクトを名前で取得し、そのオブジェクトを変数 $settingします。 次に、名前でコレクションを取得し、そのオブジェクトを変数$collectionします。 New-CMSettingDeploymentコマンドレットを使用して、BitLocker 管理設定オブジェクトをそのコレクションに展開します。

$setting = Get-CMBlmSetting -Name "My BitLocker settings"

$collection = Get-CMCollection -Name "All Desktop and Server Clients"

New-CMSettingDeployment -CMSetting $setting -CollectionName $collection.Name

例 2: カスタム スケジュールをWindows Defenderアプリケーションコントロール設定を展開する

この例では 、New-CMSchedule コマンドレットを使用してカスタム スケジュールも作成します。

$setting = Get-CMWdacSetting -Name "My App Control settings"

$collection = Get-CMCollection -Name "All Desktop and Server Clients"

$sched = New-CMSchedule -Start ((Get-Date).AddDays(-30)).ToString() -RecurCount 7 -RecurInterval Minutes

$dep = New-CMSettingDeployment -CMSetting $setting -Collection $collection -Schedule $sched

パラメーター

-CMSetting

展開する設定オブジェクトを指定します。

Type:CMSettings
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Collection

展開のターゲットとしてコレクション オブジェクトを指定します。 コレクションを取得するには 、Get-CMCollection コマンドレットを使用 します。

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionId

展開のターゲットとしてコレクションの ID を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

展開のターゲットとしてコレクションの名前を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-OverrideServiceWindows

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

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

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

入力

Microsoft.ConfigurationManagement.PowerShell.Cmdlets.EP.SimplifiedSettings.CMSettings

出力

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