New-CMSoftwareUpdateManualPhasedDeployment

Referenz

Modul:: ConfigurationManager

Erstellen sie eine phasenweise Bereitstellung für Softwareupdates.

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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine phasenweise Bereitstellung für Softwareupdates zu erstellen. Bevor Sie dieses Cmdlet verwenden, fügen Sie neue angepasste Bereitstellungsphasen mit dem Cmdlet New-CMSoftwareUpdatePhasehinzu.

Weitere Informationen finden Sie unter Erstellen von phasenweisen Bereitstellungen mit Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Erstellen einer Bereitstellung für Softwareupdates anhand des Namens

In diesem Beispiel wird eine zweistufige Bereitstellung namens "myPhaseDeployment" für zwei Softwareupdates erstellt.

$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)

Beispiel 2: Erstellen einer Bereitstellung für eine Softwareupdategruppe anhand des Namens

In diesem Beispiel wird eine zweistufige Bereitstellung namens "myPhaseDeploymentForGroup" für die Softwareupdategruppe "myGroup" erstellt.

$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)

Parameter

-AddPhases

Geben Sie ein Array von Phasen an. Verwenden Sie New-CMSoftwareUpdatePhase, um die Phasen zu erstellen.

Type:	Phase[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-Description

Geben Sie eine Beschreibung für die Phasenbereitstellung des Softwareupdates an.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-Name

Geben Sie einen Namen für die Phasenbereitstellung für Softwareupdates an.

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

-SoftwareUpdateGroup

Geben Sie ein Objekt für eine Softwareupdategruppe an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMSoftwareUpdateGroup".

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

-SoftwareUpdateGroupId

Geben Sie eine Softwareupdategruppe nach ID an.

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

-SoftwareUpdateGroupName

Geben Sie eine Softwareupdategruppe anhand des Namens an.

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

-SoftwareUpdateIds

Geben Sie ein Array von Softwareupdate-IDs an.

Type:	String[]
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareUpdateNames

Geben Sie ein Array von Softwareupdatenamen an.

Type:	String[]
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareUpdates

Geben Sie ein Array von Softwareupdateobjekten an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMSoftwareUpdate".

Type:	IResultObject[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Ausgaben

IResultObject

Hinweise

Das Rückgabeobjekt ist die SMS_PhasedDeployment Server-WMI-Klasse.