Save-CMSoftwareUpdate

Module:

ConfigurationManager

Save software updates to update groups and packages.

Syntax

Save-CMSoftwareUpdate
    -DeploymentPackageName <String>
    [-Location <String>]
    [-RetryCount <UInt32>]
    [-RetryDelaySec <UInt32>]
    [-SoftwareUpdateLanguage <String[]>]
    -SoftwareUpdateName <String[]>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-CMSoftwareUpdate
    -DeploymentPackageName <String>
    [-Location <String>]
    [-RetryCount <UInt32>]
    [-RetryDelaySec <UInt32>]
    -SoftwareUpdateGroupId <String[]>
    [-SoftwareUpdateLanguage <String[]>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-CMSoftwareUpdate
    -DeploymentPackageName <String>
    [-Location <String>]
    [-RetryCount <UInt32>]
    [-RetryDelaySec <UInt32>]
    -SoftwareUpdateGroupName <String[]>
    [-SoftwareUpdateLanguage <String[]>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-CMSoftwareUpdate
    -DeploymentPackageName <String>
    [-Location <String>]
    [-RetryCount <UInt32>]
    [-RetryDelaySec <UInt32>]
    -SoftwareUpdateGroup <IResultObject>
    [-SoftwareUpdateLanguage <String[]>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-CMSoftwareUpdate
    -DeploymentPackageName <String>
    [-Location <String>]
    [-RetryCount <UInt32>]
    [-RetryDelaySec <UInt32>]
    -SoftwareUpdateId <String[]>
    [-SoftwareUpdateLanguage <String[]>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-CMSoftwareUpdate
    -DeploymentPackageName <String>
    [-Location <String>]
    [-RetryCount <UInt32>]
    [-RetryDelaySec <UInt32>]
    -SoftwareUpdate <IResultObject>
    [-SoftwareUpdateLanguage <String[]>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Use this cmdlet to save one or more software updates to update groups and deployment packages.

You can specify one or more software updates associated with deployment packages. You can also specify the download source location of updates and the language of the software updates. Languages determine which summary details a software update synchronizes and the file languages to be downloaded for software updates.

Note

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

Examples

Example 1: Save a software update and add a language to it

This command saves the software update named Cumulative Update for Windows 10 (KB3095020) for the deployment package named Package01. It also adds English to its array of languages.

Save-CMSoftwareUpdate -SoftwareUpdateName "Cumulative Update for Windows 10 (KB3095020)" -DeploymentPackageName "Package01" -SoftwareUpdateLanguage "English"

Example 2: Save a software update from a software update group

This command gets the software update group object named TestSUgroup10 and uses the pipeline operator to pass the object to Save-CMSoftwareUpdate, which saves the software update with the package name Package01.

Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Save-CMSoftwareUpdate -DeploymentPackageName "Package01"

Example 3: Save a software update from a software update group and specify a source location to download from

This command gets the software update group object named TestSUgroup10 and uses the pipeline operator to pass the object to Save-CMSoftwareUpdate, which saves the software update from the file share Updates on Server01 with the package name Package01.

Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" Save-CMSoftwareUpdate -Location "\\Server01\Updates" -DeploymentPackageName "Package01"

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-DeploymentPackageName

Specify the name of a deployment package.

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

-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

-Location

Specify a download source location for software updates.

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

-RetryCount

Specify an integer value for the number of times to retry downloading the update.

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

-RetryDelaySec

Specify an integer value for the number of seconds to wait before retrying.

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

-SoftwareUpdate

Specify a software update object to save. To get this object, use the Get-CMSoftwareUpdate cmdlet.

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

-SoftwareUpdateGroup

Specify a software update group object. To get this object, use the Get-CMSoftwareUpdateGroup cmdlet.

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

-SoftwareUpdateGroupId

Specify an array of IDs of software update groups.

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

-SoftwareUpdateGroupName

Specify an array of names of software update groups.

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

-SoftwareUpdateId

Specify an array of IDs of software updates.

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

-SoftwareUpdateLanguage

Specify an array of software update languages.

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

-SoftwareUpdateName

Specify an array of software update names.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

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

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object

Related Links

• Get-CMSoftwareUpdate
• Get-CMSoftwareUpdateGroup
• Set-CMSoftwareUpdate
• Sync-CMSoftwareUpdate
• Remove-CMSoftwareUpdateFromPackage