New-CMSettingDeployment

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

構文

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

デプロイする settings オブジェクトを指定します。

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

-Collection

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

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

-CollectionId

デプロイのターゲットとして、コレクションの ID を指定します。

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

-CollectionName

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-OverrideServiceWindows

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

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

-Schedule

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

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

入力

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

出力

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