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>] Description
部署設定基準。 使用 Get-CMBaseline Cmdlet 取得基準。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：將基準部署至具有相同具名前置詞的集合
此範例會使用 Get-CMBaseline 來取得設定基準，並將它儲存到變數 $BaselineName。 然後，它會使用 Get-CMCollection 取得名稱開頭為 「Collection_Name」 的所有集合清單，並將它們儲存至變數 $DeployToCollections。 接下來，它會使用 New-CMSchedule Cmdlet 建立部署的排程。 儲存所有必要信息之後，此範例會迴圈查看每個集合，並使用 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：將基準部署到一個集合
首先，此範例會建立簡單的排程。 然後，它會將基準 MY_Baseline 部署至標識符 PS1000023的集合。
$BaselineSchedule = New-CMSchedule -DurationInterval Days -DurationCount 0 -RecurInterval Days -RecurCount 1
New-CMBaselineDeployment -Name "MY_Baseline" -CollectionID "PS1000023" -Schedule $BaselineSchedule參數
-Collection
指定集合對象作為基準部署的目標。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionId
指定集合的識別碼做為部署的目標。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionName
指定集合的名稱做為部署的目標。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EnableEnforcement
如果 $true為 ，則在支援時補救不符合規範的規則。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-GenerateAlert
如果 $true為 ，則產生警示。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Id
指定要部署之組態基準的標識碼。
| 類型: | Int32 |
| 別名: | CIId, CI_ID, BaselineId |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定要部署的設定基準物件。 使用 Get-CMBaseline Cmdlet 取得基準。
| 類型: | IResultObject |
| 別名: | Baseline |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-MonitoredByScom
如果 $true為 ，則產生 System Center Operations Manager 警示。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定要部署的組態基準名稱。
| 類型: | String |
| 別名: | LocalizedDisplayName, BaselineName |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OverrideServiceWindow
如果 $true為 ，則允許客戶端在維護期間以外補救此基準。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ParameterValue
如果您使用 -GenerateAlert 參數，請將整數值指定為 0-100) (百分比。 當此設定基準的合規性低於此值時，月臺會產生警示。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PostponeDateTime
當您使用 -GenerateAlert 參數時，此參數會對應至組態基準的 Date 和 time 屬性。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Schedule
指定客戶端評估此設定基準時的排程物件。 使用 New-CMSchedule Cmdlet 建立排程。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object