New-CMBaselineDeployment

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

ベースラインデプロイを作成します。

構文

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 コマンドレットを使用してベースラインを取得します。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 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

ベースライン デプロイのターゲットとしてコレクション オブジェクトを指定します。

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

-CollectionId

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

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

-CollectionName

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

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

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

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

-DisableWildcardHandling

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

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

-EnableEnforcement

の場合 $trueは、サポートされている場合は非準拠ルールを修復します。

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

-ForceWildcardHandling

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

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

-GenerateAlert

の場合 $trueは、アラートを生成します。

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

-Id

デプロイする構成基準の ID を指定します。

Type:Int32
Aliases:CIId, CI_ID, BaselineId
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

デプロイする構成基準オブジェクトを指定します。 Get-CMBaseline コマンドレットを使用してベースラインを取得します。

Type:IResultObject
Aliases:Baseline
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MonitoredByScom

の場合 $trueは、System Center Operations Manager アラートを生成します。

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

-Name

デプロイする構成基準の名前を指定します。

Type:String
Aliases:LocalizedDisplayName, BaselineName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OverrideServiceWindow

の場合 $trueは、クライアントがメンテナンス期間外にこのベースラインを修復できるようにします。

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

-ParameterValue

GenerateAlert パラメーターを使用する場合は、整数値をパーセンテージ (0 から 100) として指定します。 この構成基準の準拠がこの値を下回ると、サイトによってアラートが生成されます。

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

-PostponeDateTime

このパラメーターは、-GenerateAlert パラメーターを使用する場合の構成基準の日付と時刻のプロパティに対応します。

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

-Schedule

クライアントがこの構成基準を評価する場合の schedule オブジェクトを指定します。 New-CMSchedule コマンドレットを使用してスケジュールを作成します。

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

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object