Start-CMContentDistribution

Copies content to distribution points.

Syntax

Start-CMContentDistribution
     -ApplicationId <String[]>
     [-CollectionName <String[]>]
     [-DisableContentDependencyDetection]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     -ApplicationName <String[]>
     [-CollectionName <String[]>]
     [-DisableContentDependencyDetection]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     -BootImageId <String[]>
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     -BootImageName <String[]>
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     -DeploymentPackageId <String[]>
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     -DeploymentPackageName <String[]>
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DisableContentDependencyDetection]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -DriverPackageId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -DriverPackageName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     -InputObject <IResultObject>
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -OperatingSystemImage <IResultObject>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -OperatingSystemImageId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -OperatingSystemImageName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -OperatingSystemInstallerId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -OperatingSystemInstallerName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -PackageId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -PackageName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -TaskSequenceId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -TaskSequenceName <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

The Start-CMContentDistribution cmdlet copies content from the content library on a site server to the content library on the distribution points.

You can use this cmdlet to distribute several types of content, including application deployment types, packages, deployment packages, driver packages, operating system images, operating system installers, boot images, and task sequences. You can distribute the content to distribution points, distribution point groups, or collections associated with distribution point groups.

Examples

Example 1: Distribute a boot image

PS C:\> Start-CMContentDistribution -BootImageId "CM200004" -CollectionName "All Systems" -DistributionPointName "CMDIV-TSQA04.CORP.CONTOSO.COM" -DistributionPointGroupName "DistPtGroup02"

This command distributes the boot image that has the ID CM200004. The command distributes the boot image to the collection named All Systems, the distribution point named CMDIV-TSQA04.CORP.CONTOSO.COM, and the distribution point group named DistPtGroup02.

Example 2: Distribute a task sequence

PS C:\> Start-CMContentDistribution -TaskSequenceId "CM200007" -CollectionName "All Systems" -DistributionPointName "CMDIV-TSQA04.CORP.CONTOSO.COM"

This command distributes the task sequence that has the ID CM200007 to the collection named All Systems and the distribution point named CMDIV-TSQA04.CORP.CONTOSO.COM.

Example 3: Distribute an application

PS C:\> Start-CMContentDistribution -ApplicationName "Dict.app" -CollectionName "All Systems" -DistributionPointName "CMDIV-TSQA04.CORP.CONTOSO.COM" -DistributionPointGroupName "DistPtGroup02"

This command distributes the application named Dict.app. The command distributes the application to the collection named All Systems, the distribution point named CMDIV-TSQA04.CORP.CONTOSO.COM, and the distribution point group named DistPtGroup02.

Example 4: Distribute a package

PS C:\> Start-CMContentDistribution -PackageId "CM200001" -CollectionName "All Systems" -DistributionPointName "CMDIV-TSQA04.CORP.CONTOSO.COM" -DistributionPointGroupName "DistPtGroup02"

This command distributes the package that has the ID CM200001. The command distributes the package to the collection named All Systems, the distribution point named CMDIV-TSQA04.CORP.CONTOSO.COM, and the distribution point group named DistPtGroup02.

Example 5: Distribute a deployment package

PS C:\> Start-CMContentDistribution -DeploymentPackageName "DivDeployPkg01" -CollectionName "All Systems" -DistributionPointName "CMDIV-TSQA04.CORP.CONTOSO.COM" -DistributionPointGroupName "DistPtGroup02"

This command distributes the deployment package named DivDeployPkg01. The command distributes the deployment package to the collection named All Systems, the distribution point named CMDIV-TSQA04.CORP.CONTOSO.COM, and the distribution point group named DistPtGroup02.

Example 6: Distribute a driver package

PS C:\> Start-CMContentDistribution -DriverPackageName "DrvPkg02" -CollectionName "All Systems" -DistributionPointName "CMDIV-TSQA04.CORP.CONTOSO.COM" -DistributionPointGroupName "DistPtGroup02"

This command distributes the driver package named DrvPkg02. The command distributes the driver package to the collection named All Systems, the distribution point named CMDIV-TSQA04.CORP.CONTOSO.COM, and the distribution point group named DistPtGroup02.

Example 7: Distribute an operating system image

PS C:\> Start-CMContentDistribution -OperatingSystemImageId "CM200013" -CollectionName "All Systems" -DistributionPointName "CMDIV-TSQA04.CORP.CONTOSO.COM -DistributionPointGroupName "DistPtGroup02"

This command distributes the operating system image that has the ID CM200013. The command distributes the operating system image to the collection named All Systems, the distribution point named CMDIV-TSQA04.CORP.CONTOSO.COM, and the distribution point group named DistPtGroup02.

Example 8: Distribute an operating system installer

PS C:\> Start-CMContentDistribution -OperatingSystemInstallerId "CM200017" -CollectionName "All Systems" -DistributionPointName CMDIV- TSQA04.CORP.CONTOSO.COM -DistributionPointGroupName "DistPtGroup02"

This command distributes the operating system installer that has the ID CM200017. The command distributes the operating system installer to the collection named All Systems, the distribution point named CMDIV-TSQA04.CORP.CONTOSO.COM, and the distribution point group named DistPtGroup02.

Required Parameters

-ApplicationId

Specifies an array of application IDs.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ApplicationName

Specifies an array of application names.

Type:String[]
Position:Named
Default value:None
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
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
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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
-InputObject
Type:IResultObject
Aliases:Application, Package, BootImage, DeploymentPackage, SoftwareUpdatePackage, DriverPackage, ImagePackage, OperatingSystemInstaller, TaskSequence
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-OperatingSystemImage

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

Type:IResultObject
Position:Named
Default value:None
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
-OperatingSystemInstallerName

Specifies an array of names of operating system installers.

Type:String[]
Aliases:OperatingSystemImageInstallerNames
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
-TaskSequenceId

Specifies an array of IDs of task sequences.

Type:String[]
Aliases:TaskSequenceIds
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-TaskSequenceName

Specifies an array of names of task sequences.

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

Optional Parameters

-CollectionName

Specifies the name of a Configuration Manager collection.

Type:String[]
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
-DisableContentDependencyDetection
Type:SwitchParameter
Aliases:DisableDetectAssociatedContentDependencies
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributionPointGroupName

Specifies the name of a distribution point group.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributionPointName

Specifies the name of a distribution point that is associated with the deployment package.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False