New-CMSoftwareUpdateManualPhasedDeployment
建立軟體更新的分階段部署。
Syntax
New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdateGroup] <IResultObject>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdateGroupId] <String>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdateGroupName] <String>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdateIds] <String[]>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdateNames] <String[]>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateManualPhasedDeployment
[-SoftwareUpdates] <IResultObject[]>
-AddPhases <Phase[]>
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 來建立軟體更新的分階段部署。 使用此 Cmdlet 之前,請使用 Cmdlet new-CMSoftwareUpdatePhase新增自訂的部署階段。
如需詳細資訊,請參閱 使用 Configuration Manager 建立階段性部署。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請參閱 快速入門。
範例
範例1:依名稱建立軟體更新的部署
此範例會為兩個軟體更新建立名為 myPhaseDeployment 的兩階段部署。
$phase1 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotificationOption DisplaySoftwareCenterOnly
$phase2 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateNames ("myUpdateA", "myUpdateB") -Name "myPhaseDeployment" -AddPhases ($phase1, $phase2)
範例2:建立軟體更新群組的部署(依名稱)
此範例會為軟體更新群組mygroup 同時建立名為myPhaseDeploymentForGroup的兩階段部署。
$phase3 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotificationOption DisplaySoftwareCenterOnly
$phase4 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateGroupName "myGroup" -Name "myPhaseDeploymentForGroup" -AddPhases ($phase3, $phase4)
參數
-AddPhases
指定階段的陣列。 使用 CMSoftwareUpdatePhase 來建立階段。
Type: | Phase[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
指定軟體更新階段性部署的描述。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元,而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateGroup
指定軟體更新群組的物件。 若要取得此物件,請使用 CMSoftwareUpdateGroup Cmdlet。
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SoftwareUpdateGroupId
依識別碼指定軟體更新群組。
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateGroupName
依名稱指定軟體更新群組。
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateIds
指定軟體更新 IDs 陣列。
Type: | String[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateNames
指定軟體更新名稱的陣列。
Type: | String[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdates
指定軟體更新物件的陣列。 若要取得此物件,請使用 CMSoftwareUpdate Cmdlet。
Type: | IResultObject[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-名稱
指定軟體更新階段性部署的名稱。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
ConfigurationManagement IResultObject
ConfigurationManagement [ManagementProvider]
輸出
IResultObject
備註
傳回物件是 SMS_PhasedDeployment 伺服器 WMI 類別。