Edit

Share via


Publish-CMPrestageContent

Publishes files to a distribution point.

Syntax

SearchByValueMandatory_DeploymentPackage (Default)

Publish-CMPrestageContent
    -DeploymentPackage <IResultObject>
    -DistributionPointName <String>
    -FileName <String>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByValueMandatory_Application

Publish-CMPrestageContent
    -Application <IResultObject>
    -DistributionPointName <String>
    -FileName <String>
    [-Description <String>]
    [-DisableDependencyExport]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByIdMandatory_Application

Publish-CMPrestageContent
    -ApplicationId <String[]>
    -DistributionPointName <String>
    -FileName <String>
    [-Description <String>]
    [-DisableDependencyExport]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByNameMandatory_Application

Publish-CMPrestageContent
    -ApplicationName <String[]>
    -DistributionPointName <String>
    -FileName <String>
    [-Description <String>]
    [-DisableDependencyExport]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByValueMandatory_BootImage

Publish-CMPrestageContent
    -BootImage <IResultObject>
    -DistributionPointName <String>
    -FileName <String>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByIdMandatory_BootImage

Publish-CMPrestageContent
    -BootImageId <String[]>
    -DistributionPointName <String>
    -FileName <String>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByNameMandatory_BootImage

Publish-CMPrestageContent
    -BootImageName <String[]>
    -DistributionPointName <String>
    -FileName <String>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByIdMandatory_DeploymentPackage

Publish-CMPrestageContent
    -DeploymentPackageId <String[]>
    -DistributionPointName <String>
    -FileName <String>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByNameMandatory_DeploymentPackage

Publish-CMPrestageContent
    -DeploymentPackageName <String[]>
    -DistributionPointName <String>
    -FileName <String>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByIdMandatory_DriverPackage

Publish-CMPrestageContent
    -DistributionPointName <String>
    -DriverPackageId <String[]>
    -FileName <String>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByNameMandatory_DriverPackage

Publish-CMPrestageContent
    -DistributionPointName <String>
    -DriverPackageName <String[]>
    -FileName <String>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByValueMandatory_DriverPackage

Publish-CMPrestageContent
    -DistributionPointName <String>
    -DriverPackage <IResultObject>
    -FileName <String>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByIdMandatory_OperatingSystemImage

Publish-CMPrestageContent
    -DistributionPointName <String>
    -FileName <String>
    -OperatingSystemImageId <String[]>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByNameMandatory_OperatingSystemImage

Publish-CMPrestageContent
    -DistributionPointName <String>
    -FileName <String>
    -OperatingSystemImageName <String[]>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByValueMandatory_OperatingSystemImage

Publish-CMPrestageContent
    -DistributionPointName <String>
    -FileName <String>
    -OperatingSystemImage <IResultObject>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByIdMandatory_OperatingSystemInstaller

Publish-CMPrestageContent
    -DistributionPointName <String>
    -FileName <String>
    -OperatingSystemInstallerId <String[]>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByNameMandatory_OperatingSystemInstaller

Publish-CMPrestageContent
    -DistributionPointName <String>
    -FileName <String>
    -OperatingSystemInstallerName <String[]>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByValueMandatory_OperatingSystemInstaller

Publish-CMPrestageContent
    -DistributionPointName <String>
    -FileName <String>
    -OperatingSystemInstaller <IResultObject>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByIdMandatory_Package

Publish-CMPrestageContent
    -DistributionPointName <String>
    -FileName <String>
    -PackageId <String[]>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByNameMandatory_Package

Publish-CMPrestageContent
    -DistributionPointName <String>
    -FileName <String>
    -PackageName <String[]>
    [-Description <String>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SearchByValueMandatory_Package

Publish-CMPrestageContent
    -DistributionPointName <String>
    -FileName <String>
    -Package <IResultObject>
    [-Description <String>]
    [-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.

Parameter properties

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

Parameter sets

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

-ApplicationId

Specifies an array of IDs of applications.

Parameter properties

Type:

String[]

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

Parameter sets

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

-ApplicationName

Specifies an array of names of applications.

Parameter properties

Type:

String[]

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

Parameter sets

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

-BootImage

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

Parameter properties

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

Parameter sets

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

-BootImageId

Specifies an array of IDs of boot images.

Parameter properties

Type:

String[]

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

Parameter sets

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

-BootImageName

Specifies an array of names of boot images.

Parameter properties

Type:

String[]

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

Parameter sets

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

-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

-DeploymentPackage

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

Parameter properties

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

Parameter sets

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

-DeploymentPackageId

Specifies an array of IDs of deployment packages.

Parameter properties

Type:

String[]

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

Parameter sets

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

-DeploymentPackageName

Specifies an array of names of deployment packages.

Parameter properties

Type:

String[]

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

Parameter sets

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

-Description

Specifies a description for the content.

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

-DisableDependencyExport

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.

Parameter properties

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

Parameter sets

SearchByValueMandatory_Application
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
SearchByIdMandatory_Application
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
SearchByNameMandatory_Application
Position:Named
Mandatory:False
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

-DistributionPointName

Specifies a distribution point for the content.

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

-DriverPackage

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

Parameter properties

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

Parameter sets

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

-DriverPackageId

Specifies an array of IDs of driver packages.

Parameter properties

Type:

String[]

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

Parameter sets

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

-DriverPackageName

Specifies an array of names of driver packages.

Parameter properties

Type:

String[]

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

Parameter sets

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

-FileName

Specifies a file name for a .pkgx file.

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

-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

-OperatingSystemImage

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

Parameter properties

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

Parameter sets

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

-OperatingSystemImageId

Specifies an array of IDs of operating system images.

Parameter properties

Type:

String[]

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

Parameter sets

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

-OperatingSystemImageName

Specifies an array of names of operating system images.

Parameter properties

Type:

String[]

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

Parameter sets

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

-OperatingSystemInstaller

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

Parameter properties

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

Parameter sets

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

-OperatingSystemInstallerId

Specifies an array of IDs of operating system installers.

Parameter properties

Type:

String[]

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

Parameter sets

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

-OperatingSystemInstallerName

Specifies an array of names of operating system installers.

Parameter properties

Type:

String[]

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

Parameter sets

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

-Package

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

Parameter properties

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

Parameter sets

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

-PackageId

Specifies an array of IDs of packages.

Parameter properties

Type:

String[]

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

Parameter sets

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

-PackageName

Specifies an array of names of packages.

Parameter properties

Type:

String[]

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

Parameter sets

SearchByNameMandatory_Package
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

None

Outputs

System.Object