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:
- 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
| 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
Related Links
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for