Update-CMDistributionPoint
Update content on a distribution point.
Syntax
Update-CMDistributionPoint
-InputObject <IResultObject>
[-ReloadBootImage]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-ApplicationName <String>
-DeploymentTypeName <String>
[-ManifestPath <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-BootImageId <String>
[-ReloadBootImage]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-BootImageName <String>
[-ReloadBootImage]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-DriverPackageId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-DriverPackageName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-OperatingSystemImageId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-OperatingSystemImageName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-OperatingSystemInstallerId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-OperatingSystemInstallerName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-PackageId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-PackageName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-SoftwareUpdateDeploymentPackageId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-CMDistributionPoint
-SoftwareUpdateDeploymentPackageName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Use this cmdlet to update distribution points with the latest content for clients to download.
If you manually update a distribution point, it doesn't interfere with a recurring update schedule.
For more information, see Deploy and manage content in 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: Update distribution points by package name
This command updates all distribution points that have the package named Package01.
Update-CMDistributionPoint -PackageName "Package01"Parameters
-ApplicationName
Specify the name of an application, and use the DeploymentTypeName parameter to specify the name of the deployment type with the content to update.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BootImageId
Specify the ID of a boot image to update. For example, "XYZ00015".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BootImageName
Specify the name of a boot image to update.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-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 |
-DeploymentTypeName
Specify the name of an application deployment type to update its content. Use the ApplicationName parameter to specify the application.
| 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 |
-DriverPackageId
Specify the ID of a driver package to update. For example, "XYZ00017".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriverPackageName
Specify the name of a driver package to update.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-InputObject
Specify an object type to update. To get these objects, use one of the following cmdlets:
- Get-CMPackage for a legacy package
- Get-CMBootImage for a boot image
- Get-CMDeploymentPackage for a software update deployment package
- Get-CMDriverPackage for a driver package
- Get-CMOperatingSystemImage for an OS image
- Get-CMOperatingSystemInstaller for an OS upgrade package
| Type: | IResultObject |
| Aliases: | BootImage, DriverPackage, OperatingSystemImage, OperatingSystemInstaller, Package, SoftwareUpdateDeploymentPackage |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ManifestPath
Specify the UNC path of a Microsoft App-V virtual application's XML manifest file.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatingSystemImageId
Specify the ID of an OS image to update. For example, "XYZ00018".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatingSystemImageName
Specify the name of an OS image to update.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatingSystemInstallerId
Specify the ID of an OS upgrade package to update. For example, "XYZ00019".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatingSystemInstallerName
Specify the name of an OS upgrade package to update.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageId
Specify the ID of a legacy package to update. For example, "XYZ00020".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageName
Specify the name of a legacy package to update.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReloadBootImage
When you update a boot image, add this parameter to reload it with the current Windows PE version from the Windows ADK. For more information, see Manage boot images in Configuration Manager.
| Type: | SwitchParameter |
| Aliases: | Reload |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftwareUpdateDeploymentPackageId
Specify the ID of a software update deployment package to update. For example, "XYZ00016".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftwareUpdateDeploymentPackageName
Specify the name of a software update deployment package to update.
| Type: | String |
| 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-CMDistributionPoint
- Set-CMDistributionPoint
- Remove-CMDistributionPoint
- Get-CMDistributionPointGroup
- Get-CMBootImage
- Get-CMDriverPackage
- Get-CMOperatingSystemImage
- Get-CMOperatingSystemInstaller
- Get-CMPackage
- Get-CMSoftwareUpdateDeploymentPackage
- Invoke-CMContentValidation
- Remove-CMContentDistribution
- Start-CMContentDistribution
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for