Start-CMContentDistribution

将内容分发到分发点。

语法

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 之一:

类型: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