New-CMTSStepDownloadPackageContent

  • Referência
Módulo:
ConfigurationManager

Crie uma etapa Baixar Conteúdo do Pacote , que você pode adicionar a uma sequência de tarefas.

Syntax

New-CMTSStepDownloadPackageContent
   -AddPackage <IResultObject[]>
   [-ContinueDownload <Boolean>]
   [-DestinationVariable <String>]
   [-LocationOption <LocationType>]
   [-Path <String>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet cria um novo objeto de etapa Baixar Conteúdo do Pacote . Em seguida, use o cmdlet Add-CMTaskSequenceStep para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre esta etapa, confira Etapas da sequência de tarefas: Baixar conteúdo do pacote.

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: criar uma etapa de sequência de tarefas com condição e adicionar a um grupo

Este exemplo primeiro define variáveis para os parâmetros necessários. Em seguida, ele usa o cmdlet New-CMTSStepDownloadPackageContent para criar a etapa e salva isso como uma variável. Em seguida, ele adiciona a etapa a uma sequência de tarefas em um grupo específico usando o cmdlet Set-CMTaskSequenceGroup .

$TaskSequenceName = "Module - Download Driver Packages"
$Model = "Latitude E7470"
$GroupName = "Dell Drivers"
$ContentPackage = Get-CMPackage -Fast -Name "Driver Dell Latitude E7470"
$StepName = $ContentPackage.Name
$ConditionQuery = "Select * From Win32_ComputerSystem Where Model = `"$Model`""
$StepCondition = New-CMTSStepConditionQueryWMI -Namespace "root\cimv2" -Query $ConditionQuery

$PackageStep = New-CMTSStepDownloadPackageContent -AddPackage $ContentPackage -Name $StepName -LocationOption TaskSequenceWorkingFolder -DestinationVariable "DRIVERS" -Condition $StepCondition

Set-CMTaskSequenceGroup -TaskSequenceName $TaskSequenceName -StepName $GroupName -AddStep $PackageStep -InsertStepStartIndex 1

Parâmetros

-AddPackage

Especifique um ou mais objetos de pacote a serem usados com a etapa. Para obter esse objeto, use o cmdlet Get-CMPackage .

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

-Condition

Especifique um objeto de condição a ser usado com esta etapa. Para obter um objeto de condição, use um dos cmdlets de condição de etapa. Por exemplo, New-CMTSStepConditionQueryWMI.

Type:IResultObject[]
Aliases:Conditions
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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueDownload

Defina esse parâmetro para true continuar baixando outros pacotes na lista se um download de pacote falhar.

Type:Boolean
Aliases:ContinueDownloadOnError
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnError

Adicione esse parâmetro para habilitar a opção de etapa Continuar no erro. Quando você habilita essa opção, se a etapa falhar, a sequência de tarefas continuará.

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

-Description

Especifique uma descrição opcional para esta etapa de sequência de tarefas.

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

-DestinationVariable

Use esse parâmetro para salvar o caminho do pacote em uma variável de sequência de tarefas personalizada.

Type:String
Aliases:DestinationVariableName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Disable

Adicione esse parâmetro para desabilitar essa etapa de sequência de tarefas.

Type:SwitchParameter
Aliases:DisableThisStep
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

-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

-LocationOption

Especifique um dos seguintes valores para onde a sequência de tarefas salva o pacote:

  • TaskSequenceWorkingFolder: use o diretório de trabalho da sequência de tarefas, que também é chamado de cache de sequência de tarefas.

  • ClientCache: use o cache do cliente Configuration Manager. Por padrão, esse caminho é %WinDir%\ccmcache.

  • CustomPath: o mecanismo de sequência de tarefas primeiro baixa o pacote para o diretório de trabalho da sequência de tarefas. Em seguida, ele move o conteúdo para este caminho que você especifica. O mecanismo de sequência de tarefas acrescenta o caminho com a ID do pacote. Ao usar essa opção, defina o caminho com o parâmetro Caminho .

Type:LocationType
Accepted values:TaskSequenceWorkingFolder, ClientCache, CustomPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique um nome para esta etapa para identificá-lo na sequência de tarefas.

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

-Path

Quando você especificar -LocationOption CustomPath, use esse parâmetro para especificar o caminho local para salvar o conteúdo do pacote. O mecanismo de sequência de tarefas acrescenta o caminho com a ID do pacote.

Type:String
Aliases:DestinationCustomPath
Position:Named
Default value:None
Required:False
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:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_TaskSequence_DownloadPackageContentAction classe WMI do servidor.