New-CMBaselineDeployment
ベースラインデプロイを作成します。
構文
New-CMBaselineDeployment
[-EnableEnforcement <Boolean>]
[-GenerateAlert <Boolean>]
[-InputObject] <IResultObject>
[-MonitoredByScom <Boolean>]
[-OverrideServiceWindow <Boolean>]
[-ParameterValue <Int32>]
[-PostponeDateTime <DateTime>]
[-Schedule <IResultObject>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMBaselineDeployment
[-EnableEnforcement <Boolean>]
[-GenerateAlert <Boolean>]
[-Id] <Int32>
[-MonitoredByScom <Boolean>]
[-OverrideServiceWindow <Boolean>]
[-ParameterValue <Int32>]
[-PostponeDateTime <DateTime>]
[-Schedule <IResultObject>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMBaselineDeployment
[-EnableEnforcement <Boolean>]
[-GenerateAlert <Boolean>]
[-MonitoredByScom <Boolean>]
[-Name] <String>
[-OverrideServiceWindow <Boolean>]
[-ParameterValue <Int32>]
[-PostponeDateTime <DateTime>]
[-Schedule <IResultObject>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
構成基準をデプロイします。 Get-CMBaseline コマンドレットを使用してベースラインを取得します。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 同じ名前付きプレフィックスを持つコレクションにベースラインをデプロイする
この例では 、Get-CMBaseline を使用して構成基準を取得し、変数 $BaselineNameに格納します。 次に 、Get-CMCollection を使用して、名前が "Collection_Name" で始まるすべてのコレクションの一覧を取得し、変数 $DeployToCollectionsに格納します。 次に、 New-CMSchedule コマンドレットを使用してデプロイのスケジュールを作成します。 必要なすべての情報が格納されると、この例では各コレクションをループし、 New-CMBaselineDeployment を使用してベースラインをデプロイします。
$BaselineName = Get-CMBaseline -Name 'ConfigMgr Baseline'
$DeployToCollections = Get-CMCollection -Name 'Collection_Name*' | Sort-Object -Property "Name"
$BaselineSchedule = New-CMSchedule -DurationInterval Days -DurationCount 0 -RecurInterval Days -RecurCount 1
foreach ($Collection in $DeployToCollection)
{
New-CMBaselineDeployment -InputObject $BaselineName -CollectionID $Collection.CollectionId -Schedule $BaselineSchedule
Write-Output "Created Deployment for $($BaselineName.LocalizedDisplayName) on $($Collection.Name)"
}例 2: 1 つのコレクションにベースラインをデプロイする
最初に、この例では単純なスケジュールを作成します。 次に、ID PS1000023を 使用 して、ベースライン MY_Baselineをコレクションにデプロイします。
$BaselineSchedule = New-CMSchedule -DurationInterval Days -DurationCount 0 -RecurInterval Days -RecurCount 1
New-CMBaselineDeployment -Name "MY_Baseline" -CollectionID "PS1000023" -Schedule $BaselineScheduleパラメーター
-Collection
ベースライン デプロイのターゲットとしてコレクション オブジェクトを指定します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CollectionId
デプロイのターゲットとして、コレクションの ID を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CollectionName
展開のターゲットとして、コレクションの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | True |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableEnforcement
$true場合は、サポートされている場合は非準拠ルールを修復します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-GenerateAlert
$true場合は、アラートを生成します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Id
デプロイする構成基準の ID を指定します。
| 型: | Int32 |
| Aliases: | CIId, CI_ID, BaselineId |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
デプロイする構成基準オブジェクトを指定します。 Get-CMBaseline コマンドレットを使用してベースラインを取得します。
| 型: | IResultObject |
| Aliases: | Baseline |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-MonitoredByScom
$true場合は、System Center Operations Manager アラートを生成します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
デプロイする構成基準の名前を指定します。
| 型: | String |
| Aliases: | LocalizedDisplayName, BaselineName |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OverrideServiceWindow
$true場合は、クライアントがメンテナンス期間外にこのベースラインを修復できるようにします。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ParameterValue
GenerateAlert パラメーターを使用する場合は、整数値をパーセンテージ (0 から 100) として指定します。 この構成基準の準拠がこの値を下回ると、サイトによってアラートが生成されます。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PostponeDateTime
このパラメーターは、-GenerateAlert パラメーターを使用する場合の構成基準の日付と時刻のプロパティに対応します。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Schedule
クライアントがこの構成基準を評価する場合の schedule オブジェクトを指定します。 New-CMSchedule コマンドレットを使用してスケジュールを作成します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object