New-CMTSStepDownloadPackageContent
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
RELATED LINKS
Get-CMTSStepDownloadpackageContent Remover-CMTSStepDownloadpackageContent Set-CMTSStepDownloadpackageContent Etapas da sequência de tarefas: Descarregue o conteúdo do pacote