Publish-CMPrestageContent

Publishes files to a distribution point.

Syntax

Publish-CMPrestageContent
       -DeploymentPackage <IResultObject>
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       -Application <IResultObject>
       [-Description <String>]
       [-DisableDependencyExport]
       -DistributionPointName <String>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       -ApplicationId <String[]>
       [-Description <String>]
       [-DisableDependencyExport]
       -DistributionPointName <String>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       -ApplicationName <String[]>
       [-Description <String>]
       [-DisableDependencyExport]
       -DistributionPointName <String>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       -BootImage <IResultObject>
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       -BootImageId <String[]>
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       -BootImageName <String[]>
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       -DeploymentPackageId <String[]>
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       -DeploymentPackageName <String[]>
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -DriverPackageId <String[]>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -DriverPackageName <String[]>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -DriverPackage <IResultObject>
       -FileName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       -OperatingSystemImageId <String[]>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       -OperatingSystemImageName <String[]>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       -OperatingSystemImage <IResultObject>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       -OperatingSystemInstallerId <String[]>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       -OperatingSystemInstallerName <String[]>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       -OperatingSystemInstaller <IResultObject>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       -PackageId <String[]>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       -PackageName <String[]>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-CMPrestageContent
       [-Description <String>]
       -DistributionPointName <String>
       -FileName <String>
       -Package <IResultObject>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

The Publish-CMPrestageContent cmdlet publishes files for applications, images, packages, or operating system installers to a distribution point without using the Configuration Manager distribution process.

Specify the distribution site, the file name, and the item to publish.

You can specify any of the following to publish to a distribution point:

  • Application
  • BootImage
  • DeploymentPackage
  • DriverPackage
  • OperatingSystemImage
  • OperatingSystemInstaller
  • Package

You can specify the item to be published by name or ID, or use another cmdlet to get the desired item.

Note

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

Examples

Example 1: Publish a package

PS XYZ:\>Publish-CMPrestageContent -PackageId "CM200001" -DistributionPointName "FileDist02.Western.Contoso.com" -FileName "C:\Users\admin\Documents\Package.pkgx"

This command publishes the package that has the ID CM200001 to the specified distribution point as the specified .pkgx file.

Example 2: Publish a boot image

PS XYZ:\>Publish-CMPrestageContent -BootImageId "CM200005" -DistributionPointName "FileDist02.Western.Contoso.com" -FileName "C:\Users\admin\Documents\BootImage.pkgx"

This command publishes the boot image that has the ID CM200005 to the specified distribution point as the specified .pkgx file.

Example 3: Publish a driver package

PS XYZ:\>Publish-CMPrestageContent -DriverPackageId "CM20000F" -DistributionPointName "FileDist02.Western.Contoso.com" -FileName "C:\Users\admin\Documents\DriverPackage.pkgx"

This command publishes the driver package that has the ID CM20000F to the specified distribution point as the specified .pkgx file.

Example 4: Publish an operating system image

PS XYZ:\>Publish-CMPrestageContent -OperatingSystemImageId "CM200006" -DistributionPointName "FileDist02.Western.Contoso.com" -FileName "C:\Users\admin\Documents\OSImage.pkgx"

This command publishes the operating system image that has the ID CM200006 to the specified distribution point as the specified .pkgx file.

Example 5: Publish an operating system installer

PS XYZ:\>Publish-CMPrestageContent -OperatingSystemInstallerId "CM200017" -DistributionPointName "FileDist02.Western.Contoso.com" -FileName "C:\Users\admin\Documents\OSInstaller.pkgx"

This command publishes the operating system installer that has the ID CM200017 to the specified distribution point as the specified .pkgx file.

Parameters

-Application

Specifies an application object. To obtain an application object, use the Get-CMApplication cmdlet.

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

-ApplicationId

Specifies an array of IDs of applications.

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

-ApplicationName

Specifies an array of names of applications.

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

-BootImage

Specifies a boot image object. To obtain a boot image object, use the Get-CMBootImage cmdlet.

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

-BootImageId

Specifies an array of IDs of boot images.

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

-BootImageName

Specifies an array of names of boot images.

Type:String[]
Aliases:BootImageNames
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

-DeploymentPackage

Specifies a deployment package object. To obtain a deployment package object, use the Get-CMDeploymentPackage cmdlet.

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

-DeploymentPackageId

Specifies an array of IDs of deployment packages.

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

-DeploymentPackageName

Specifies an array of names of deployment packages.

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

-Description

Specifies a description for the content.

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

-DisableDependencyExport

Type:SwitchParameter
Aliases:DisableExportAllDependencies
Position:Named
Default value:None
Required:False
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

-DistributionPointName

Specifies a distribution point for the content.

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

-DriverPackage

Specifies a driver package object. To obtain a driver package object, use the Get-CMDriverPackage cmdlet.

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

-DriverPackageId

Specifies an array of IDs of driver packages.

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

-DriverPackageName

Specifies an array of names of driver packages.

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

-FileName

Specifies a file name for a .pkgx file.

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

-OperatingSystemImage

Specifies an operating system image object. To obtain an operating system image object, use the Get-CMOperatingSystemImage cmdlet.

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

-OperatingSystemImageId

Specifies an array of IDs of operating system images.

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

-OperatingSystemImageName

Specifies an array of names of operating system images.

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

-OperatingSystemInstaller

Specifies an operating system installer object. To obtain an operating system installer object, use the Get-CMOperatingSystemInstaller cmdlet.

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

-OperatingSystemInstallerId

Specifies an array of IDs of operating system installers.

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

-OperatingSystemInstallerName

Specifies an array of names of operating system installers.

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

-Package

Specifies a package object. To obtain a package object, use the Get-CMPackage cmdlet.

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

-PackageId

Specifies an array of IDs of packages.

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

-PackageName

Specifies an array of names of packages.

Type:String[]
Aliases:PackageNames
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

None

Outputs

System.Object