Compartilhar via


Start-CMContentDistribution

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

Sintaxe

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 .

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 .

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BootImageId

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

Tipo:String[]
Aliases:BootImageIds
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BootImageName

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

Tipo:String[]
Aliases:BootImageNames
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeploymentPackageId

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

Tipo:String[]
Aliases:DeploymentPackageIds, SoftwareUpdatesPackageId, SoftwareUpdatesPackageIds
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeploymentPackageName

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

Tipo:String[]
Aliases:DeploymentPackageNames, SoftwareUpdatesPackageName, SoftwareUpdatesPackageNames
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableContentDependencyDetection

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

Tipo:SwitchParameter
Aliases:DisableDetectAssociatedContentDependencies
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DistributionPointGroupName

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DistributionPointName

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

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DriverPackageId

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

Tipo:String[]
Aliases:DriverPackageIds
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DriverPackageName

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

Tipo:String[]
Aliases:DriverPackageNames
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

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

Tipo:IResultObject
Aliases:Application, Package, BootImage, DeploymentPackage, SoftwareUpdatePackage, DriverPackage, ImagePackage, OperatingSystemInstaller, TaskSequence
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-OperatingSystemImage

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

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OperatingSystemImageId

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

Tipo:String[]
Aliases:OperatingSystemImageIds
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OperatingSystemImageName

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

Tipo:String[]
Aliases:OperatingSystemImageNames
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OperatingSystemInstallerId

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

Tipo:String[]
Aliases:OperatingSystemInstallerIds
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OperatingSystemInstallerName

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

Tipo:String[]
Aliases:OperatingSystemImageInstallerNames
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PackageId

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

Tipo:String[]
Aliases:PackageIds
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PackageName

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

Tipo:String[]
Aliases:PackageNames
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TaskSequenceId

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

Tipo:String[]
Aliases:TaskSequenceIds
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TaskSequenceName

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

Tipo:String[]
Aliases:TaskSequenceNames
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object