Get-CMSoftwareUpdatePhasedDeployment

Module:

ConfigurationManager

Get the phased deployment for software updates.

Syntax

Get-CMSoftwareUpdatePhasedDeployment
   -SoftwareUpdate <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdatePhasedDeployment
   -SoftwareUpdateGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdatePhasedDeployment
   -SoftwareUpdateGroupId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdatePhasedDeployment
   -SoftwareUpdateGroupName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdatePhasedDeployment
   -SoftwareUpdateId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdatePhasedDeployment
   -SoftwareUpdateName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdatePhasedDeployment
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdatePhasedDeployment
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use this cmdlet to get the phased deployment for software updates.

For more information, see Create phased deployments with Configuration Manager.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Get deployment by name

This example gets the software update phased deployment by its name.

Get-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeploymentName"

Example 2: Get deployment by software update name

This example gets the software update phased deployment by the name of the software update.

Get-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateName "myUpdateName"

Parameters

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-Id

Specify the ID of the phased deployment.

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

-Name

Specify the name of the phased deployment.

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

-SoftwareUpdate

Specify a software update object.

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

-SoftwareUpdateGroup

Specify a software update group object.

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

-SoftwareUpdateGroupId

Specify the ID of a software update group.

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

-SoftwareUpdateGroupName

Specify the name of a software update group.

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

-SoftwareUpdateId

Specify the ID of a software update.

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

-SoftwareUpdateName

Specify the name of a software update.

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

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

IResultObject

IResultObject[]

Notes

The return object is the SMS_PhasedDeployment server WMI class.

Related Links

• New-CMSoftwareUpdateAutoPhasedDeployment
• Remove-CMSoftwareUpdatePhasedDeployment
• Set-CMSoftwareUpdatePhasedDeployment
• Get-CMPhasedDeploymentStatus
• Move-CMPhasedDeploymentToNext
• Resume-CMPhasedDeployment
• Suspend-CMPhasedDeployment
• Create phased deployments with Configuration Manager