Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
Start-CMContentDistribution
- Module:
- ConfigurationManager Module
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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
-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
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.
Inputs
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Outputs
System.Object
Related Links
Feedback
Was this page helpful?