Compartilhar via


Start-CMContentDistribution

Distribuir conteúdo por 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

Utilize este cmdlet para distribuir conteúdo da biblioteca de conteúdos no servidor do site para pontos de distribuição.

Pode utilizar este cmdlet para distribuir conteúdo para os seguintes objetos implementáveis:

  • Aplicativos
  • Pacotes legados
  • Pacotes de implementação de atualizações de software
  • Pacotes de controladores
  • Imagens do SO
  • Pacotes de atualização do SO
  • Imagens de inicialização
  • Conteúdo referenciado por sequências de tarefas

Pode distribuir o conteúdo por 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, veja Implementar e gerir conteúdos no Configuration Manager.

Observação

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

Exemplos

Exemplo 1: Distribuir uma imagem de arranque

Este comando distribui a imagem de arranque com o ID CM200004 para o ponto de distribuição com o nome CMDIV-TSQA04.CORP.CONTOSO.COM.

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

Parâmetros

-ApplicationId

Especifique uma matriz de IDs de aplicação a distribuir. Estes IDs são GUIDs como cadeias de carateres.

Por predefinição, o Configuration Manager também distribui o conteúdo para aplicações dependentes. Para desativar este comportamento, utilize 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 aplicações a distribuir.

Por predefinição, o Configuration Manager também distribui o conteúdo para aplicações dependentes. Para desativar este comportamento, utilize 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 arranque a distribuir. 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 imagens de arranque a distribuir.

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ções do Configuration Manager. Utilize esta coleção para direcionar os pontos de distribuição para os quais pretende 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 do pacote de implementação de atualização de software a distribuir. 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 pacotes de implementação de atualização de software a distribuir.

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 este parâmetro para não distribuir automaticamente conteúdo para aplicações 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

Este parâmetro trata os carateres universais como valores de carateres literais. 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 grupos de pontos de distribuição para os quais pretende 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 pontos de distribuição para os quais pretende 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 controlador a distribuir. 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 pacotes de controladores a distribuir.

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

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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 distribuir. Para obter estes objetos, utilize 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 SO a distribuir. Para obter este objeto, utilize 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 SO a distribuir. 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 imagens do SO a distribuir.

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 do pacote de atualização do SO a distribuir. 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 pacotes de atualização do SO a distribuir.

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 pacotes legados a distribuir. 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 legados a distribuir.

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