Share via

New-CMTSStepDownloadPackageContent

  • Artigo

SYNOPSIS

Adicione o passo de Conteúdo de Pacote de Descarregamento 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 passo de Conteúdo de Pacote de Descarregamento para uma sequência de tarefas. Para obter mais informações sobre este passo, consulte os passos da sequência de tarefas: Descarregue o conteúdo do pacote.

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

Este exemplo primeiro define 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 utilizando 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

PARAMETERS

-AddPackage

Especifique um objeto de embalagem para usar com o passo. Para obter um objeto de embalagem, utilize o cmdlet Get-CMPackage.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddPackages

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

-Condição

Especifique um objeto de condição para usar com este passo. Para obter um objeto de condição, use um dos cmdlets de condição de passo. Por exemplo, New-CMTSStepConditionQueryWMI.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: Conditions

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: None
Accept pipeline input: False
Accept wildcard characters: False

-Continuar A carregar

Desfie este parâmetro true para continuar a descarregar outros pacotes na lista se um download de pacote falhar.

Type: Boolean
Parameter Sets: (All)
Aliases: ContinueDownloadOnError

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

-ContinueOnError

Adicione este parâmetro para ativar a opção de passo Continue a cometer erro. Quando ativa esta opção, se o passo falhar, a sequência de tarefas continua.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Descrição

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

Type: String
Parameter Sets: (All)
Aliases:

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

-DestinationVariable

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

Type: String
Parameter Sets: (All)
Aliases: DestinationVariableName

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

-Desativar

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: DisableThisStep

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

-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

-LocationOption

Especifique um dos valores aceites para onde a sequência de tarefas guarda o pacote. Se utilizar o CustomPath, deslote o caminho com o parâmetro -Path.

Type: LocationType
Parameter Sets: (All)
Aliases:
Accepted values: TaskSequenceWorkingFolder, ClientCache, CustomPath

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

-Name

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

Type: String
Parameter Sets: (All)
Aliases: StepName

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

-Path

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

Type: String
Parameter Sets: (All)
Aliases: DestinationCustomPath

Required: False
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 é executado.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
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.

INPUTS

Nenhuma

OUTPUTS

IResultObject#SMS_TaskSequence_DownloadPackageContentAction

NOTAS

Get-CMTSStepDownloadpackageContent Remover-CMTSStepDownloadpackageContent Set-CMTSStepDownloadpackageContent Etapas da sequência de tarefas: Descarregue o conteúdo do pacote