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 オブジェクトを指定します。
- BitLocker 管理の場合は、 Get-CMBlmSetting コマンドレットまたは New-CMBlmSetting コマンドレットを 使用します。
- Microsoft Defender アプリケーション制御の場合は、 Get-CMWdacSetting コマンドレットまたは New-CMWdacSetting コマンドレットを 使用します。
型: | 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