Update-CMDistributionPoint
Update-CMDistributionPoint
Updates distribution points with the latest content.
Syntax
Parameter Set: SearchByBootImage
Update-CMDistributionPoint -BootImage <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByBootImageId
Update-CMDistributionPoint -BootImageId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByBootImageName
Update-CMDistributionPoint -BootImageName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByDriverPackage
Update-CMDistributionPoint -DriverPackage <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByDriverPackageId
Update-CMDistributionPoint -DriverPackageId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByDriverPackageName
Update-CMDistributionPoint -DriverPackageName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSImage
Update-CMDistributionPoint -OperatingSystemImage <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSImageId
Update-CMDistributionPoint -OperatingSystemImageId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSImageName
Update-CMDistributionPoint -OperatingSystemImageName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSInstaller
Update-CMDistributionPoint -OperatingSystemInstaller <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSInstallerId
Update-CMDistributionPoint -OperatingSystemInstallerId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByOSInstallerName
Update-CMDistributionPoint -OperatingSystemInstallerName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByPackage
Update-CMDistributionPoint -Package <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByPackageId
Update-CMDistributionPoint -PackageId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByPackageName
Update-CMDistributionPoint -PackageName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchBySoftwareUpdateDeploymentPackage
Update-CMDistributionPoint -SoftwareUpdateDeploymentPackage <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchBySoftwareUpdateDeploymentPackageId
Update-CMDistributionPoint -SoftwareUpdateDeploymentPackageId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchBySoftwareUpdateDeploymentPackageName
Update-CMDistributionPoint -SoftwareUpdateDeploymentPackageName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: UpdateByDeploymentTypeName
Update-CMDistributionPoint -ApplicationName <String> -DeploymentTypeName <String> [-ManifestPath <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Update-CMDistributionPoint cmdlet updates distribution points with the latest content for clients to download. You can update the distribution points for application content, software packages, software updates, operating system images, and boot images. It does not interfere with the recurring update schedule if you manually update the distribution points.
Parameters
-ApplicationName<String>
Specifies the name of an application that is associated with the deployment type.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BootImage<IResultObject>
Specifies a CMBootImage object. To obtain a CMBootImage object, use the Get-CMBootImage cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BootImageId<String>
Specifies the ID of a boot image.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BootImageName<String>
Specifies the name of a boot image.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeploymentTypeName<String>
Specifies the name of a deployment type. A deployment type is contained within an application and contains the information that Configuration Manager requires to install software. A deployment type also contains rules that specify if and how Configuration Manager deploys the software.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DriverPackage<IResultObject>
Specifies a CMDriverPackage object. To obtain a CMDriverPackage object, use the Get-CMDriverPackage cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DriverPackageId<String>
Specifies the ID of a driver package.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DriverPackageName<String>
Specifies the name of a driver package.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ManifestPath<String>
Specifies the Universal Naming Convention (UNC) path of the virtual application’s XML manifest file. Specify the manifest path if you specify Microsoft Application Virtualization for the DeploymentTypeName parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OperatingSystemImage<IResultObject>
Specifies a CMOperatingSystemImage object. To obtain a CMOperatingSystemImage object, use the Get-CMOperatingSystemImage cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OperatingSystemImageId<String>
Specifies the ID of an operating system image.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OperatingSystemImageName<String>
Specifies the name of an operating system image.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OperatingSystemInstaller<IResultObject>
Specifies a CMOperatingSystemInstaller object. To obtain a CMOperatingSystemInstaller object, use the Get-CMOperatingSystemInstaller cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OperatingSystemInstallerId<String>
Specifies the ID of an operating system installer.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OperatingSystemInstallerName<String>
Specifies the name of an operating system installer.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Package<IResultObject>
Specifies a CMPackage object. To obtain a CMPackage object, use the Get-CMPackage cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-PackageId<String>
Specifies the ID of a package.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-PackageName<String>
Specifies the name of a package.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SoftwareUpdateDeploymentPackage<IResultObject>
Specifies a CMSoftwareUpdateDeploymentPackage object. To obtain a CMSoftwareUpdateDeploymentPackage object, use the Get-CMSoftwareUpdateDeploymentPackage cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SoftwareUpdateDeploymentPackageId<String>
Specifies the ID of a software update deployment.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SoftwareUpdateDeploymentPackageName<String>
Specifies the name of a software update deployment.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Update the distribution points for a deployment type
This command updates the distribution points for the deployment type named 7Zip - Microsoft Application Virtualization 5. The command specifies that the Microsoft Application Virtualization manifest for the deployment type is contained in 7Zip.appv.
PS C:\> Update-CMDistributionPoint -DeploymentTypeName "7Zip - Microsoft Application Virtualization 5" -ManifestPath "\\Contoso01\DeployType\7Zip\7Zip.appv"