Start-CMContentDistribution
SYNOPSIS
Distribuir conteúdo por pontos de distribuição.
SYNTAX
SearchByValueMandatory_Application (Predefinição)
Start-CMContentDistribution [-CollectionName <String[]>] [-DisableContentDependencyDetection]
[-DistributionPointGroupName <String[]>] [-DistributionPointName <String[]>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdMandatory_Application
Start-CMContentDistribution -ApplicationId <String[]> [-CollectionName <String[]>]
[-DisableContentDependencyDetection] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByNameMandatory_Application
Start-CMContentDistribution -ApplicationName <String[]> [-CollectionName <String[]>]
[-DisableContentDependencyDetection] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByIdMandatory_BootImage
Start-CMContentDistribution -BootImageId <String[]> [-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>] [-DistributionPointName <String[]>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByNameMandatory_BootImage
Start-CMContentDistribution -BootImageName <String[]> [-CollectionName <String[]>]
[-DistributionPointGroupName <String[]>] [-DistributionPointName <String[]>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdMandatory_DeploymentPackage
Start-CMContentDistribution [-CollectionName <String[]>] -DeploymentPackageId <String[]>
[-DistributionPointGroupName <String[]>] [-DistributionPointName <String[]>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByNameMandatory_DeploymentPackage
Start-CMContentDistribution [-CollectionName <String[]>] -DeploymentPackageName <String[]>
[-DistributionPointGroupName <String[]>] [-DistributionPointName <String[]>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdMandatory_DriverPackage
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -DriverPackageId <String[]> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByNameMandatory_DriverPackage
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -DriverPackageName <String[]> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByValueMandatory
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -InputObject <IResultObject> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByValueMandatory_OperatingSystemImage
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -OperatingSystemImage <IResultObject> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdMandatory_OperatingSystemImage
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -OperatingSystemImageId <String[]> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByNameMandatory_OperatingSystemImage
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -OperatingSystemImageName <String[]> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdMandatory_OperatingSystemInstaller
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -OperatingSystemInstallerId <String[]> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByNameMandatory_OperatingSystemInstaller
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -OperatingSystemInstallerName <String[]> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdMandatory_Package
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -PackageId <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
SearchByNameMandatory_Package
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -PackageName <String[]> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdMandatory_TaskSequence
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -TaskSequenceId <String[]> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByNameMandatory_TaskSequence
Start-CMContentDistribution [-CollectionName <String[]>] [-DistributionPointGroupName <String[]>]
[-DistributionPointName <String[]>] -TaskSequenceName <String[]> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Utilize este cmdlet para distribuir o 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 implantáveis:
- Aplicações
- Pacotes legados
- Pacotes de implementação de atualização de software
- Pacotes de controladores
- Imagens do SO
- Pacotes de upgrade do SO
- Imagens de arranque
- 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, consulte Implementar e gerir conteúdos no Gestor de Configurações.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\>
. Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Distribuir uma imagem de arranque
Este comando distribui a imagem de arranque com ID CM200004 para o ponto de distribuição denominado CMDIV-TSQA04. A CORP. CONTOSO.COM.
Start-CMContentDistribution -BootImageId "CM200004" -DistributionPointName "CMDIV-TSQA04.CORP.CONTOSO.COM"
PARAMETERS
-ApplicationId
Especifique um conjunto de IDs de aplicação para distribuir. Estes IDs são GUIDs como cordas.
Por predefinição, o Gestor de Configuração também distribui o conteúdo para aplicações dependentes. Para desativar este comportamento, utilize o parâmetro DisableContentDependencyDetection.
Type: String[]
Parameter Sets: SearchByIdMandatory_Application
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de aplicação
Especifique um conjunto de nomes de aplicações para distribuir.
Por predefinição, o Gestor de Configuração também distribui o conteúdo para aplicações dependentes. Para desativar este comportamento, utilize o parâmetro DisableContentDependencyDetection.
Type: String[]
Parameter Sets: SearchByNameMandatory_Application
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BootImageId
Especifique um conjunto de IDs de imagem de arranque para distribuir. Por exemplo, "XYZ00015"
.
Type: String[]
Parameter Sets: SearchByIdMandatory_BootImage
Aliases: BootImageIds
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BootImageName
Especifique um conjunto de nomes de imagem de arranque para distribuir.
Type: String[]
Parameter Sets: SearchByNameMandatory_BootImage
Aliases: BootImageNames
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de coleção
Especifique um conjunto de nomes de coleção do Gestor de Configuração. Utilize esta recolha para direcionar os pontos de distribuição para distribuir o conteúdo.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentPackageId
Especifique uma série de IDs de pacote de atualização de software para distribuir. Por exemplo, "XYZ00016"
.
Type: String[]
Parameter Sets: SearchByIdMandatory_DeploymentPackage
Aliases: DeploymentPackageIds, SoftwareUpdatesPackageId, SoftwareUpdatesPackageIds
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentPackageName
Especifique um conjunto de nomes de pacotes de implementação de atualização de software para distribuir.
Type: String[]
Parameter Sets: SearchByNameMandatory_DeploymentPackage
Aliases: DeploymentPackageNames, SoftwareUpdatesPackageName, SoftwareUpdatesPackageNames
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableContentDependencyDetection
Adicione este parâmetro para não distribuir automaticamente conteúdo para aplicações dependentes.
Type: SwitchParameter
Parameter Sets: SearchByValueMandatory_Application, SearchByIdMandatory_Application, SearchByNameMandatory_Application
Aliases: DisableDetectAssociatedContentDependencies
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
Especifique um conjunto de nomes de grupo de pontos de distribuição para distribuir o conteúdo.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome do Ponto de Distribuição
Especifique um conjunto de nomes de pontos de distribuição para distribuir o conteúdo.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DriverPackageId
Especifique uma matriz de IDs do pacote do controlador para distribuir. Por exemplo, "XYZ00017"
.
Type: String[]
Parameter Sets: SearchByIdMandatory_DriverPackage
Aliases: DriverPackageIds
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DriverPackageName
Especifique um conjunto de nomes de pacotes do motorista para distribuir.
Type: String[]
Parameter Sets: SearchByNameMandatory_DriverPackage
Aliases: DriverPackageNames
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifique um tipo de objeto para distribuir. Para obter estes objetos, utilize um dos seguintes cmdlets:
- Get-CMApplication para uma aplicação
- Get-CMPackage para um pacote legado
- Get-CMBootImage para uma imagem de arranque
- Get-CMDeploymentPackage para um pacote de implementação de atualização de software
- Get-CMSoftwareUpdateGroup para o conteúdo de um grupo de atualização de software
- Get-CMDriverPackage para um pacote de motorista
- Get-CMOperatingSystemImage para uma imagem de SO
- Get-CMOperatingSystemInstaller para um pacote de atualização de SO
- Get-CMTaskSequence para o conteúdo referenciado por uma sequência de tarefa
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: Application, Package, BootImage, DeploymentPackage, SoftwareUpdatePackage, DriverPackage, ImagePackage, OperatingSystemInstaller, TaskSequence
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-OperatingSystemImage
Especifique um objeto de imagem SO para distribuir. Para obter este objeto, utilize o cmdlet Get-CMOperatingSystemImage.
Type: IResultObject
Parameter Sets: SearchByValueMandatory_OperatingSystemImage
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OperarSystemImageId
Especifique uma matriz de IDs de imagem de SO para distribuir. Por exemplo, "XYZ00018"
.
Type: String[]
Parameter Sets: SearchByIdMandatory_OperatingSystemImage
Aliases: OperatingSystemImageIds
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OperatingSystemImageName
Especifique um conjunto de nomes de imagem de SO para distribuir.
Type: String[]
Parameter Sets: SearchByNameMandatory_OperatingSystemImage
Aliases: OperatingSystemImageNames
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OperatingSystemInstallerId
Especifique uma matriz de IDs de pacote de upgrade de SO para distribuir. Por exemplo, "XYZ00019"
.
Type: String[]
Parameter Sets: SearchByIdMandatory_OperatingSystemInstaller
Aliases: OperatingSystemInstallerIds
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OperatingSystemInstallerName
Especifique um conjunto de nomes de pacotes de upgrade de SO para distribuir.
Type: String[]
Parameter Sets: SearchByNameMandatory_OperatingSystemInstaller
Aliases: OperatingSystemImageInstallerNames
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageId
Especifique uma variedade de iDs de pacote legado para distribuir. Por exemplo, "XYZ00020"
.
Type: String[]
Parameter Sets: SearchByIdMandatory_Package
Aliases: PackageIds
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome do pacote
Especifique uma variedade de nomes de pacotes antigos para distribuir.
Type: String[]
Parameter Sets: SearchByNameMandatory_Package
Aliases: PackageNames
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TaskSequenceId
Especifique um conjunto de IDs de sequência de tarefa para distribuir conteúdo referenciado. Por exemplo, "XYZ00021"
.
Type: String[]
Parameter Sets: SearchByIdMandatory_TaskSequence
Aliases: TaskSequenceIds
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- Nome de Tarefasequence
Especifique um conjunto de nomes de sequência de tarefas para distribuir conteúdo referenciado.
Type: String[]
Parameter Sets: SearchByNameMandatory_TaskSequence
Aliases: TaskSequenceNames
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.