New-CMTSStepDownloadPackageContent
Erstellen Sie einen Schritt Paketinhalt herunterladen , den Sie einer Tasksequenz hinzufügen können.
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>] Beschreibung
Dieses Cmdlet erstellt ein neues Schrittobjekt paketinhalt herunterladen . Verwenden Sie dann das Cmdlet Add-CMTaskSequenceStep , um den Schritt einer Tasksequenz hinzuzufügen. Weitere Informationen zu diesem Schritt finden Sie unter Tasksequenzschritte: Herunterladen von Paketinhalten.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Erstellen eines Tasksequenzschritts mit bedingung und Hinzufügen zu einer Gruppe
In diesem Beispiel werden zunächst Variablen für die erforderlichen Parameter festgelegt. Anschließend wird das Cmdlet New-CMTSStepDownloadPackageContent zum Erstellen des Schritts verwendet und als Variable gespeichert. Anschließend wird der Schritt mithilfe des Cmdlets Set-CMTaskSequenceGroup einer Tasksequenz in einer bestimmten Gruppe hinzugefügt.
$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 1Parameter
-AddPackage
Geben Sie mindestens ein Paketobjekt an, das mit dem Schritt verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMPackage .
| Typ: | IResultObject[] |
| Aliase: | AddPackages |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Condition
Geben Sie ein Bedingungsobjekt an, das mit diesem Schritt verwendet werden soll. Verwenden Sie zum Abrufen eines Bedingungsobjekts eines der Schrittbedingungs-Cmdlets. Beispiel: New-CMTSStepConditionQueryWMI.
| Typ: | IResultObject[] |
| Aliase: | Conditions |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ContinueDownload
Legen Sie diesen Parameter auf fest true , um das Herunterladen anderer Pakete in der Liste fortzusetzen, wenn ein Paketdownload fehlschlägt.
| Typ: | Boolean |
| Aliase: | ContinueDownloadOnError |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ContinueOnError
Fügen Sie diesen Parameter hinzu, um die Schrittoption Bei Fehler fortsetzen zu aktivieren. Wenn Sie diese Option aktivieren und der Schritt fehlschlägt, wird die Tasksequenz fortgesetzt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DestinationVariable
Verwenden Sie diesen Parameter, um den Pfad des Pakets in einer benutzerdefinierten Tasksequenzvariablen zu speichern.
| Typ: | String |
| Aliase: | DestinationVariableName |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Disable
Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.
| Typ: | SwitchParameter |
| Aliase: | DisableThisStep |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-LocationOption
Geben Sie einen der folgenden Werte für den Speicherort an, an dem die Tasksequenz das Paket speichert:
TaskSequenceWorkingFolder: Verwenden Sie das Tasksequenzarbeitsverzeichnis, das auch als Tasksequenzcache bezeichnet wird.ClientCache: Verwenden Sie den Configuration Manager-Clientcache. Standardmäßig ist%WinDir%\ccmcachedieser Pfad .CustomPath: Die Tasksequenz-Engine lädt das Paket zuerst in das Tasksequenzarbeitsverzeichnis herunter. Anschließend wird der Inhalt in den von Ihnen angegebenen Pfad verschoben. Die Tasksequenz-Engine fügt den Pfad mit der Paket-ID an. Wenn Sie diese Option verwenden, legen Sie den Pfad mit dem Path-Parameter fest.
| Typ: | LocationType |
| Zulässige Werte: | TaskSequenceWorkingFolder, ClientCache, CustomPath |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.
| Typ: | String |
| Aliase: | StepName |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Path
Wenn Sie angeben -LocationOption CustomPath, verwenden Sie diesen Parameter, um den lokalen Pfad zum Speichern des Paketinhalts anzugeben. Die Tasksequenz-Engine fügt den Pfad mit der Paket-ID an.
| Typ: | String |
| Aliase: | DestinationCustomPath |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_DownloadPackageContentAction WMI-Serverklasse.