New-CMTSStepDownloadPackageContent

Artykuł
08/11/2021

SYNOPSIS

Dodaj krok Pobierz zawartość pakietu do sekwencji zadań.

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

To polecenie cmdlet tworzy nowy krok Pobierz zawartość pakietu do sekwencji zadań. Aby uzyskać więcej informacji na temat tego kroku, zobacz Kroki sekwencji zadań: Pobieranie zawartości pakietu.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1. Tworzenie kroku sekwencji zadań z warunkiem i dodawanie go do grupy

W tym przykładzie najpierw ustawiane są zmienne dla niezbędnych parametrów. Następnie używa polecenia cmdlet New-CMTSStepDownloadPackageContent do utworzenia kroku i zapisuje go jako zmienną. Następnie dodaje krok do sekwencji zadań w określonej grupie przy użyciu polecenia 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

Określ obiekt pakietu do użycia w kroku . Aby uzyskać obiekt pakietu, użyj polecenia 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

-Warunek

Określ obiekt warunku do użycia w tym kroku. Aby uzyskać obiekt warunku, użyj jednego z polecenia cmdlet warunku kroku. Na przykład 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

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-ContinueDownload

Ustaw ten parametr na true , aby kontynuować pobieranie innych pakietów na liście, jeśli pobieranie pakietu nie powiedzie się.

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

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

-ContinueOnError

Dodaj ten parametr, aby włączyć opcję kroku Kontynuuj przy błędzie. Jeśli ta opcja zostanie włączyć, jeśli krok zakończy się niepowodzeniem, sekwencja zadań będzie kontynuowana.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Description (Opis)

Określ opcjonalny opis tego kroku sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

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

-DestinationVariable

Użyj tego parametru, aby zapisać ścieżkę pakietu do niestandardowej zmiennej sekwencji zadań.

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

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

-Wyłącz

Dodaj ten parametr, aby wyłączyć ten krok sekwencji zadań.

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

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-LocationOption

Określ jedną z akceptowanych wartości miejsca, w którym sekwencja zadań zapisuje pakiet. Jeśli używasz parametru CustomPath, ustaw ścieżkę za pomocą parametru -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

Określ nazwę tego kroku, aby zidentyfikować go w sekwencji zadań.

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

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

-Path

W przypadku ustawienia parametru LocationOption na wartość CustomPath użyj tego parametru, aby określić ścieżkę lokalną do zapisania zawartości pakietu. Aparat sekwencji zadań dołącza ścieżkę z identyfikatorem pakietu.

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

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Brak

OUTPUTS

IResultObject#SMS_TaskSequence_DownloadPackageContentAction

UWAGI

Get-CMTSStepDownloadPackageContent Remove-CMTSStepDownloadPackageContent Set-CMTSStepDownloadPackageContent Kroki sekwencji zadań: pobieranie zawartości pakietu