New-CMTSStepDownloadPackageContent

  • Referenz
Modul:
ConfigurationManager

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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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 1

Parameter

-AddPackage

Geben Sie mindestens ein Paketobjekt an, das mit dem Schritt verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMPackage .

Type:IResultObject[]
Aliases:AddPackages
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueDownload

Legen Sie diesen Parameter auf fest true , um das Herunterladen anderer Pakete in der Liste fortzusetzen, wenn ein Paketdownload fehlschlägt.

Type:Boolean
Aliases:ContinueDownloadOnError
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnError

Fügen Sie diesen Parameter hinzu, um die Schrittoption Bei Fehler fortfahren zu aktivieren. Wenn Sie diese Option aktivieren und der Schritt fehlschlägt, wird die Tasksequenz fortgesetzt.

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

-Description

Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.

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

-DestinationVariable

Verwenden Sie diesen Parameter, um den Pfad des Pakets in einer benutzerdefinierten Tasksequenzvariablen zu speichern.

Type:String
Aliases:DestinationVariableName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Disable

Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.

Type:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:LocationType
Accepted values:TaskSequenceWorkingFolder, ClientCache, CustomPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.

Type:String
Aliases:StepName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:DestinationCustomPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_DownloadPackageContentAction WMI-Serverklasse.