Start-CMContentDistribution

模块:

ConfigurationManager

将内容分发到分发点。

语法

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>]

说明

使用此 cmdlet 可将内容从站点服务器上的内容库分发到分发点。

可以使用此 cmdlet 分发以下可部署对象的内容：

• 应用程序
• 旧包
• 软件更新部署包
• 驱动程序包
• OS 映像
• OS 升级包
• 启动映像
• 任务序列引用的内容

可以将内容分发到分发点、分发点组或与分发点组关联的集合。

有关详细信息，请参阅 在 Configuration Manager 中部署和管理内容。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1：分发启动映像

此命令将 ID 为 CM200004 的启动映像分发到名为 CMDIV-TSQA04.CORP.CONTOSO.COM 的分发点。

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

参数

-ApplicationId

指定要分发的应用程序 ID 的数组。 这些 ID 是字符串格式的 GUID。

默认情况下，Configuration Manager 还会分发相关应用程序的内容。 若要禁用此行为，请使用 DisableContentDependencyDetection 参数。

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ApplicationName

指定要分发的应用程序名称的数组。

默认情况下，Configuration Manager 还会分发相关应用程序的内容。 若要禁用此行为，请使用 DisableContentDependencyDetection 参数。

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-BootImageId

指定要分发的启动映像 ID 的数组。 例如，"XYZ00015"。

类型:	String[]
别名:	BootImageIds
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-BootImageName

指定要分发的启动映像名称的数组。

类型:	String[]
别名:	BootImageNames
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-CollectionName

指定 Configuration Manager 集合名称的数组。 使用此集合将内容分发到的分发点为目标。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-DeploymentPackageId

指定要分发的软件更新部署包 ID 的数组。 例如，"XYZ00016"。

类型:	String[]
别名:	DeploymentPackageIds, SoftwareUpdatesPackageId, SoftwareUpdatesPackageIds
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DeploymentPackageName

指定要分发的软件更新部署包名称的数组。

类型:	String[]
别名:	DeploymentPackageNames, SoftwareUpdatesPackageName, SoftwareUpdatesPackageNames
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DisableContentDependencyDetection

添加此参数以不自动分发相关应用的内容。

类型:	SwitchParameter
别名:	DisableDetectAssociatedContentDependencies
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DistributionPointGroupName

指定要将内容分发到的分发点组名称数组。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DistributionPointName

指定要将内容分发到的分发点名称数组。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DriverPackageId

指定要分发的驱动程序包 ID 的数组。 例如，"XYZ00017"。

类型:	String[]
别名:	DriverPackageIds
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DriverPackageName

指定要分发的驱动程序包名称的数组。

类型:	String[]
别名:	DriverPackageNames
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

指定要分布的对象类型。 若要获取这些对象，请使用以下 cmdlet 之一：

• 应用程序的 Get-CMApplication
• 旧包的 Get-CMPackage
• 启动映像的 Get-CMBootImage
• 软件更新部署包的 Get-CMDeploymentPackage
• 软件更新组中内容的 Get-CMSoftwareUpdateGroup
• 驱动程序包的 Get-CMDriverPackage
• OS 映像的 Get-CMOperatingSystemImage
• 适用于 OS 升级包的 Get-CMOperatingSystemInstaller
• 任务序列引用的内容的 Get-CMTaskSequence

类型:	IResultObject
别名:	Application, Package, BootImage, DeploymentPackage, SoftwareUpdatePackage, DriverPackage, ImagePackage, OperatingSystemInstaller, TaskSequence
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-OperatingSystemImage

指定要分发的 OS 映像对象。 若要获取此对象，请使用 Get-CMOperatingSystemImage cmdlet。

类型:	IResultObject
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OperatingSystemImageId

指定要分发的 OS 映像 ID 的数组。 例如，"XYZ00018"。

类型:	String[]
别名:	OperatingSystemImageIds
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OperatingSystemImageName

指定要分发的 OS 映像名称数组。

类型:	String[]
别名:	OperatingSystemImageNames
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OperatingSystemInstallerId

指定要分发的 OS 升级包 ID 的数组。 例如，"XYZ00019"。

类型:	String[]
别名:	OperatingSystemInstallerIds
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OperatingSystemInstallerName

指定要分发的 OS 升级包名称的数组。

类型:	String[]
别名:	OperatingSystemImageInstallerNames
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-PackageId

指定要分发的旧包 ID 的数组。 例如，"XYZ00020"。

类型:	String[]
别名:	PackageIds
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-PackageName

指定要分发的旧包名称数组。

类型:	String[]
别名:	PackageNames
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-TaskSequenceId

指定要分发引用内容的任务序列 ID 的数组。 例如，"XYZ00021"。

类型:	String[]
别名:	TaskSequenceIds
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-TaskSequenceName

指定任务序列名称数组以分发引用的内容。

类型:	String[]
别名:	TaskSequenceNames
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• Get-CMApplication
• Get-CMBootImage
• Get-CMDeploymentPackage
• Get-CMDriverPackage
• Get-CMOperatingSystemImage
• Get-CMOperatingSystemInstaller
• Get-CMPackage
• Get-CMTaskSequence
• Remove-CMContentDistribution
• Invoke-CMContentValidation
• Update-CMDistributionPoint