Start-CMContentDistribution

Copies content to distribution points.

Syntax

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

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

-Application

Specifies a Configuration Manager application object. To get a CMApplication object, use the Get-CMApplication cmdlet.

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

Specifies an array of application IDs.

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

Specifies an array of application names.

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

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

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

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

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

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

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

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

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

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

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

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

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

Specifies a task sequence object. To get a CMTaskSequence object, use the Get-CMTaskSequence cmdlet.

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

Indicates that wildcard handling is disabled.

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

Specifies the name of a distribution point group.

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

Indicates that wildcard handling is enabled.

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