Start-CMContentDistribution

Distribute content to distribution points.

Syntax

Start-CMContentDistribution
     [-CollectionName <String[]>]
     [-DisableContentDependencyDetection]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
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[]>]
     [-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
     [-CollectionName <String[]>]
     [-DistributionPointGroupName <String[]>]
     [-DistributionPointName <String[]>]
     -InputObject <IResultObject>
     [-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

Use this cmdlet to distribute content from the content library on the site server to distribution points.

You can use this cmdlet to distribute content for the following deployable objects:

  • Applications
  • Legacy packages
  • Software update deployment packages
  • Driver packages
  • OS images
  • OS upgrade packages
  • Boot images
  • Content referenced by task sequences

You can distribute the content to distribution points, distribution point groups, or collections associated with distribution point groups.

For more information, see Deploy and manage content in Configuration Manager.

Note

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

Examples

Example 1: Distribute a boot image

This command distributes the boot image with ID CM200004 to the distribution point named CMDIV-TSQA04.CORP.CONTOSO.COM.

Start-CMContentDistribution -BootImageId "CM200004" -DistributionPointName "CMDIV-TSQA04.CORP.CONTOSO.COM"

Parameters

-ApplicationId

Specify an array of application IDs to distribute. These IDs are GUIDs as strings.

By default, Configuration Manager also distributes the content for dependent applications. To disable this behavior, use the DisableContentDependencyDetection parameter.

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

-ApplicationName

Specify an array of application names to distribute.

By default, Configuration Manager also distributes the content for dependent applications. To disable this behavior, use the DisableContentDependencyDetection parameter.

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

-BootImageId

Specify an array of boot image IDs to distribute. For example, "XYZ00015".

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

-BootImageName

Specify an array of boot image names to distribute.

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

-CollectionName

Specify an array of Configuration Manager collection names. Use this collection to target the distribution points to which to distribute the content.

Type:String[]
Position:Named
Default value:None
Required:False
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

-DeploymentPackageId

Specify an array of software update deployment package IDs to distribute. For example, "XYZ00016".

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

-DeploymentPackageName

Specify an array of software update deployment package names to distribute.

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

-DisableContentDependencyDetection

Add this parameter to not automatically distribute content for dependent apps.

Type:SwitchParameter
Aliases:DisableDetectAssociatedContentDependencies
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

-DistributionPointGroupName

Specify an array of distribution point group names to which to distribute the content.

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

-DistributionPointName

Specify an array of distribution point names to which to distribute the content.

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

-DriverPackageId

Specify an array of driver package IDs to distribute. For example, "XYZ00017".

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

-DriverPackageName

Specify an array of driver package names to distribute.

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

-InputObject

Specify an object type to distribute. To get these objects, use one of the following cmdlets:

Type:IResultObject
Aliases:Application, Package, BootImage, DeploymentPackage, SoftwareUpdatePackage, DriverPackage, ImagePackage, OperatingSystemInstaller, TaskSequence
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-OperatingSystemImage

Specify an OS image object to distribute. To get this object, use the Get-CMOperatingSystemImage cmdlet.

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

-OperatingSystemImageId

Specify an array of OS image IDs to distribute. For example, "XYZ00018".

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

-OperatingSystemImageName

Specify an array of OS image names to distribute.

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

-OperatingSystemInstallerId

Specify an array of OS upgrade package IDs to distribute. For example, "XYZ00019".

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

-OperatingSystemInstallerName

Specify an array of OS upgrade package names to distribute.

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

-PackageId

Specify an array of legacy package IDs to distribute. For example, "XYZ00020".

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

-PackageName

Specify an array of legacy package names to distribute.

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

-TaskSequenceId

Specify an array of task sequence IDs to distribute referenced content. For example, "XYZ00021".

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

-TaskSequenceName

Specify an array of task sequence names to distribute referenced content.

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object