Compartilhar via

New-CMTSStepDownloadPackageContent

  • Referência
Módulo:
ConfigurationManager

Crie um passo Transferir Conteúdo do Pacote , que pode adicionar a uma sequência de tarefas.

Sintaxe

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 passo Transferir Conteúdo do Pacote . Em seguida, utilize o cmdlet Add-CMTaskSequenceStep para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, veja Passos de sequência de tarefas: Transferir conteúdo do pacote.

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

Este exemplo define primeiro as variáveis para os parâmetros necessários. Em seguida, utiliza o cmdlet New-CMTSStepDownloadPackageContent para criar o passo e guarda-o como uma variável. Em seguida, adiciona o passo a uma sequência de tarefas num grupo específico com 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 utilizar com o passo . Para obter este objeto, utilize o cmdlet Get-CMPackage .

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

-Condition

Especifique um objeto de condição a utilizar com este passo. Para obter um objeto de condição, utilize um dos cmdlets da condição de passo. Por exemplo, New-CMTSStepConditionQueryWMI.

Tipo:IResultObject[]
Aliases:Conditions
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:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ContinueDownload

Defina este parâmetro para true continuar a transferir outros pacotes na lista se a transferência de um pacote falhar.

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

-ContinueOnError

Adicione este parâmetro para ativar a opção de passo Continuar com o erro. Quando ativa esta opção, se o passo falhar, a sequência de tarefas continuará.

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

-Description

Especifique uma descrição opcional para este passo de sequência de tarefas.

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

-DestinationVariable

Utilize este parâmetro para guardar o caminho do pacote numa variável de sequência de tarefas personalizada.

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

-Disable

Adicione este parâmetro para desativar este passo de sequência de tarefas.

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

-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

-LocationOption

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

  • TaskSequenceWorkingFolder: utilize o diretório de trabalho da sequência de tarefas, também conhecido como cache de sequência de tarefas.

  • ClientCache: utilize a cache de cliente do Configuration Manager. Por predefinição, este caminho é %WinDir%\ccmcache.

  • CustomPath: o motor de sequência de tarefas transfere primeiro o pacote para o diretório de trabalho da sequência de tarefas. Em seguida, move o conteúdo para este caminho que especificar. O motor de sequência de tarefas acrescenta o caminho com o ID do pacote. Quando utilizar esta opção, defina o caminho com o parâmetro Caminho .

Tipo:LocationType
Valores aceitos:TaskSequenceWorkingFolder, ClientCache, CustomPath
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique um nome para este passo para identificá-lo na sequência de tarefas.

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

-Path

Quando especificar -LocationOption CustomPath, utilize este parâmetro para especificar o caminho local para guardar o conteúdo do pacote. O motor de sequência de tarefas acrescenta o caminho com o ID do pacote.

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

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_DownloadPackageContentAction classe WMI de servidor.