Share via


Start-CMContentDistribution

Distribua conteúdo para pontos de distribuição.

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 esse cmdlet para distribuir conteúdo da biblioteca de conteúdo no servidor do site para pontos de distribuição.

Você pode usar este cmdlet para distribuir conteúdo para os seguintes objetos implantáveis:

  • Aplicativos
  • Pacotes herdados
  • Pacotes de implantação de atualização de software
  • Pacotes de driver
  • Imagens do SO
  • Pacotes de atualização do sistema operacional
  • Imagens de inicialização
  • Conteúdo referenciado por sequências de tarefas

Você pode distribuir o conteúdo para pontos de distribuição, grupos de pontos de distribuição ou coleções associadas a grupos de pontos de distribuição.

Para obter mais informações, consulte Implantar e gerenciar conteúdo em Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: Distribuir uma imagem de inicialização

Esse comando distribui a imagem de inicialização com ID CM200004 para o ponto de distribuição chamado CMDIV-TSQA04.CORP.CONTOSO.COM.

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

Parâmetros

-ApplicationId

Especifique uma matriz de IDs de aplicativo a serem distribuídas. Essas IDs são GUIDs como cadeias de caracteres.

Por padrão, Configuration Manager também distribui o conteúdo para aplicativos dependentes. Para desabilitar esse comportamento, use o parâmetro DisableContentDependencyDetection .

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationName

Especifique uma matriz de nomes de aplicativo a serem distribuídos.

Por padrão, Configuration Manager também distribui o conteúdo para aplicativos dependentes. Para desabilitar esse comportamento, use o parâmetro DisableContentDependencyDetection .

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BootImageId

Especifique uma matriz de IDs de imagem de inicialização a serem distribuídas. Por exemplo, "XYZ00015".

Type:String[]
Aliases:BootImageIds
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-BootImageName

Especifique uma matriz de nomes de imagem de inicialização a serem distribuídos.

Type:String[]
Aliases:BootImageNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Especifique uma matriz de nomes de coleção Configuration Manager. Use essa coleção para direcionar os pontos de distribuição para os quais distribuir o conteúdo.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentPackageId

Especifique uma matriz de IDs de pacote de implantação de atualização de software a serem distribuídas. Por exemplo, "XYZ00016".

Type:String[]
Aliases:DeploymentPackageIds, SoftwareUpdatesPackageId, SoftwareUpdatesPackageIds
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentPackageName

Especifique uma matriz de nomes de pacote de implantação de atualização de software a serem distribuídos.

Type:String[]
Aliases:DeploymentPackageNames, SoftwareUpdatesPackageName, SoftwareUpdatesPackageNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DisableContentDependencyDetection

Adicione esse parâmetro para não distribuir conteúdo automaticamente para aplicativos dependentes.

Type:SwitchParameter
Aliases:DisableDetectAssociatedContentDependencies
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointGroupName

Especifique uma matriz de nomes de grupo de pontos de distribuição para os quais distribuir o conteúdo.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointName

Especifique uma matriz de nomes de ponto de distribuição para o qual distribuir o conteúdo.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DriverPackageId

Especifique uma matriz de IDs de pacote de driver a serem distribuídas. Por exemplo, "XYZ00017".

Type:String[]
Aliases:DriverPackageIds
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DriverPackageName

Especifique uma matriz de nomes de pacote de driver a serem distribuídos.

Type:String[]
Aliases:DriverPackageNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique um tipo de objeto a ser distribuído. Para obter esses objetos, use um dos seguintes cmdlets:

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

Especifique um objeto de imagem do sistema operacional a ser distribuído. Para obter esse objeto, use o cmdlet Get-CMOperatingSystemImage .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemImageId

Especifique uma matriz de IDs de imagem do sistema operacional a ser distribuída. Por exemplo, "XYZ00018".

Type:String[]
Aliases:OperatingSystemImageIds
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemImageName

Especifique uma matriz de nomes de imagem do sistema operacional a serem distribuídos.

Type:String[]
Aliases:OperatingSystemImageNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemInstallerId

Especifique uma matriz de IDs de pacote de atualização do sistema operacional a serem distribuídas. Por exemplo, "XYZ00019".

Type:String[]
Aliases:OperatingSystemInstallerIds
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OperatingSystemInstallerName

Especifique uma matriz de nomes de pacote de atualização do sistema operacional a serem distribuídos.

Type:String[]
Aliases:OperatingSystemImageInstallerNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PackageId

Especifique uma matriz de IDs de pacote herdadas a serem distribuídas. Por exemplo, "XYZ00020".

Type:String[]
Aliases:PackageIds
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PackageName

Especifique uma matriz de nomes de pacotes herdados a serem distribuídos.

Type:String[]
Aliases:PackageNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TaskSequenceId

Especifique uma matriz de IDs de sequência de tarefas para distribuir conteúdo referenciado. Por exemplo, "XYZ00021".

Type:String[]
Aliases:TaskSequenceIds
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TaskSequenceName

Especifique uma matriz de nomes de sequência de tarefas para distribuir conteúdo referenciado.

Type:String[]
Aliases:TaskSequenceNames
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object