Start-CMContentDistribution
Distribute content to distribution points.
Syntax
SearchByValueMandatory_Application (Default)
Start-CMContentDistribution
[-CollectionName <String[]>]
[-DisableContentDependencyDetection]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByIdMandatory_Application
Start-CMContentDistribution
-ApplicationId <String[]>
[-CollectionName <String[]>]
[-DisableContentDependencyDetection]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByNameMandatory_Application
Start-CMContentDistribution
-ApplicationName <String[]>
[-CollectionName <String[]>]
[-DisableContentDependencyDetection]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByIdMandatory_BootImage
Start-CMContentDistribution
-BootImageId <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByNameMandatory_BootImage
Start-CMContentDistribution
-BootImageName <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByIdMandatory_DeploymentPackage
Start-CMContentDistribution
-DeploymentPackageId <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByNameMandatory_DeploymentPackage
Start-CMContentDistribution
-DeploymentPackageName <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByIdMandatory_DriverPackage
Start-CMContentDistribution
-DriverPackageId <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByNameMandatory_DriverPackage
Start-CMContentDistribution
-DriverPackageName <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByValueMandatory
Start-CMContentDistribution
-InputObject <IResultObject>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByValueMandatory_OperatingSystemImage
Start-CMContentDistribution
-OperatingSystemImage <IResultObject>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByIdMandatory_OperatingSystemImage
Start-CMContentDistribution
-OperatingSystemImageId <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByNameMandatory_OperatingSystemImage
Start-CMContentDistribution
-OperatingSystemImageName <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByIdMandatory_OperatingSystemInstaller
Start-CMContentDistribution
-OperatingSystemInstallerId <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByNameMandatory_OperatingSystemInstaller
Start-CMContentDistribution
-OperatingSystemInstallerName <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByIdMandatory_Package
Start-CMContentDistribution
-PackageId <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByNameMandatory_Package
Start-CMContentDistribution
-PackageName <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByIdMandatory_TaskSequence
Start-CMContentDistribution
-TaskSequenceId <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SearchByNameMandatory_TaskSequence
Start-CMContentDistribution
-TaskSequenceName <String[]>
[-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>]
[-DistributionPointName <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.
Parameter properties
Type: | String[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
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
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.
Parameter properties
Type: | String[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
SearchByNameMandatory_Application
Position: | Named |
Mandatory: | True |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-BootImageId
Specify an array of boot image IDs to distribute. For example, "XYZ00015"
.
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
Specify an array of boot image names to distribute.
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 |
-CollectionName
Specify an array of Configuration Manager collection names. Use this collection to target the distribution points to which to distribute 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 |
-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 |
-DeploymentPackageId
Specify an array of software update deployment package IDs to distribute. For example, "XYZ00016"
.
Parameter properties
Type: | String[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | DeploymentPackageIds, SoftwareUpdatesPackageId, SoftwareUpdatesPackageIds |
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
Specify an array of software update deployment package names to distribute.
Parameter properties
Type: | String[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | DeploymentPackageNames, SoftwareUpdatesPackageName, SoftwareUpdatesPackageNames |
Parameter sets
SearchByNameMandatory_DeploymentPackage
Position: | Named |
Mandatory: | True |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-DisableContentDependencyDetection
Add this parameter to not automatically distribute content for dependent apps.
Parameter properties
Type: | SwitchParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | DisableDetectAssociatedContentDependencies |
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 |
-DistributionPointGroupName
Specify an array of distribution point group names to which to distribute 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 |
-DistributionPointName
Specify an array of distribution point names to which to distribute 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 |
-DriverPackageId
Specify an array of driver package IDs to distribute. For example, "XYZ00017"
.
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
Specify an array of driver package names to distribute.
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 |
-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 |
-InputObject
Specify an object type to distribute. To get these objects, use one of the following cmdlets:
- Get-CMApplication for an application
- Get-CMPackage for a legacy package
- Get-CMBootImage for a boot image
- Get-CMDeploymentPackage for a software update deployment package
- Get-CMSoftwareUpdateGroup for the content in a software update group
- Get-CMDriverPackage for a driver package
- Get-CMOperatingSystemImage for an OS image
- Get-CMOperatingSystemInstaller for an OS upgrade package
- Get-CMTaskSequence for the content referenced by a task sequence
Parameter properties
Type: | IResultObject |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | Application, Package, BootImage, DeploymentPackage, SoftwareUpdatePackage, DriverPackage, ImagePackage, OperatingSystemInstaller, TaskSequence |
Parameter sets
SearchByValueMandatory
Position: | Named |
Mandatory: | True |
Value from pipeline: | True |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-OperatingSystemImage
Specify an OS image object to distribute. To get this 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
Specify an array of OS image IDs to distribute. For example, "XYZ00018"
.
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
Specify an array of OS image names to distribute.
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 |
-OperatingSystemInstallerId
Specify an array of OS upgrade package IDs to distribute. For example, "XYZ00019"
.
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
Specify an array of OS upgrade package names to distribute.
Parameter properties
Type: | String[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | OperatingSystemImageInstallerNames |
Parameter sets
SearchByNameMandatory_OperatingSystemInstaller
Position: | Named |
Mandatory: | True |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-PackageId
Specify an array of legacy package IDs to distribute. For example, "XYZ00020"
.
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
Specify an array of legacy package names to distribute.
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 |
-TaskSequenceId
Specify an array of task sequence IDs to distribute referenced content. For example, "XYZ00021"
.
Parameter properties
Type: | String[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | TaskSequenceIds |
Parameter sets
SearchByIdMandatory_TaskSequence
Position: | Named |
Mandatory: | True |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-TaskSequenceName
Specify an array of task sequence names to distribute referenced content.
Parameter properties
Type: | String[] |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Aliases: | TaskSequenceNames |
Parameter sets
SearchByNameMandatory_TaskSequence
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.