Edit

Share via

Save-CMSoftwareUpdate

Module:
ConfigurationManager Module

Save software updates to update groups and packages.

Syntax

SearchByNameMandatory (Default) 

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

SearchByIdMandatory_UpdateGroup 

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

SearchByNameMandatory_UpdateGroup 

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

SearchByValueMandatory_UpdateGroup 

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

SearchByIdMandatory 

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

SearchByValueMandatory 

Save-CMSoftwareUpdate
    -DeploymentPackageName <String>
    -SoftwareUpdate <IResultObject>
    [-Location <String>]
    [-RetryCount <UInt32>]
    [-RetryDelaySec <UInt32>]
    [-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.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DeploymentPackageName

Specify the name of a deployment package.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableWildcardHandling

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ForceWildcardHandling

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Location

Specify a download source ___location for software updates.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RetryCount

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

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RetryDelaySec

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

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SoftwareUpdate

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

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SearchByValueMandatory
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-SoftwareUpdateGroup

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

Parameter properties

Type:IResultObject
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SearchByValueMandatory_UpdateGroup
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-SoftwareUpdateGroupId

Specify an array of IDs of software update groups.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SearchByIdMandatory_UpdateGroup
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SoftwareUpdateGroupName

Specify an array of names of software update groups.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SearchByNameMandatory_UpdateGroup
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SoftwareUpdateId

Specify an array of IDs of software updates.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

SearchByIdMandatory
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SoftwareUpdateLanguage

Specify an array of software update languages.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SoftwareUpdateName

Specify an array of software update names.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:LocalizedDisplayName

Parameter sets

SearchByNameMandatory
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object