New-CMTSStepDownloadPackageContent
Crie uma etapa Baixar Conteúdo do Pacote , que você 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 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 .
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 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.
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 esse parâmetro para true
continuar baixando outros pacotes na lista se um download de 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 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á.
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 esta etapa 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
Use esse parâmetro para salvar o caminho do pacote em uma 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 esse parâmetro para desabilitar essa etapa 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
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 |
-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 |
-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 .
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 esta etapa 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 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.
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 esse objeto retornado e suas propriedades, consulte SMS_TaskSequence_DownloadPackageContentAction classe WMI do servidor.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de