Partager via

New-CMTSStepDownloadPackageContent

  • Référence
Module:
ConfigurationManager

Créez une étape Télécharger le contenu du package , que vous pouvez ajouter à une séquence de tâches.

Syntaxe

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

Cette applet de commande crée un nouvel objet d’étape Télécharger le contenu du package . Utilisez ensuite l’applet de commande Add-CMTaskSequenceStep pour ajouter l’étape à une séquence de tâches. Pour plus d’informations sur cette étape, consultez Étapes de la séquence de tâches : Télécharger le contenu du package.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Créer une étape de séquence de tâches avec condition et ajouter à un groupe

Cet exemple définit d’abord des variables pour les paramètres nécessaires. Il utilise ensuite l’applet de commande New-CMTSStepDownloadPackageContent pour créer l’étape et l’enregistre en tant que variable. Il ajoute ensuite l’étape à une séquence de tâches dans un groupe spécifique à l’aide de l’applet de commande 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

Paramètres

-AddPackage

Spécifiez un ou plusieurs objets de package à utiliser avec l’étape . Pour obtenir cet objet, utilisez l’applet de commande Get-CMPackage .

Type:IResultObject[]
Alias:AddPackages
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Condition

Spécifiez un objet de condition à utiliser avec cette étape. Pour obtenir un objet condition, utilisez l’une des applets de commande de condition d’étape. Par exemple, New-CMTSStepConditionQueryWMI.

Type:IResultObject[]
Alias:Conditions
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ContinueDownload

Définissez ce paramètre sur true pour continuer à télécharger d’autres packages dans la liste en cas d’échec du téléchargement d’un package.

Type:Boolean
Alias:ContinueDownloadOnError
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ContinueOnError

Ajoutez ce paramètre pour activer l’option d’étape Continuer en cas d’erreur. Lorsque vous activez cette option, si l’étape échoue, la séquence de tâches continue.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifiez une description facultative pour cette étape de séquence de tâches.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationVariable

Utilisez ce paramètre pour enregistrer le chemin d’accès du package dans une variable de séquence de tâches personnalisée.

Type:String
Alias:DestinationVariableName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Disable

Ajoutez ce paramètre pour désactiver cette étape de séquence de tâches.

Type:SwitchParameter
Alias:DisableThisStep
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LocationOption

Spécifiez l’une des valeurs suivantes pour l’emplacement où la séquence de tâches enregistre le package :

  • TaskSequenceWorkingFolder: utilisez le répertoire de travail de séquence de tâches, également appelé cache de séquence de tâches.

  • ClientCache: utilisez le cache du client Configuration Manager. Par défaut, ce chemin est %WinDir%\ccmcache.

  • CustomPath: le moteur de séquence de tâches télécharge d’abord le package dans le répertoire de travail de la séquence de tâches. Il déplace ensuite le contenu vers le chemin que vous spécifiez. Le moteur de séquence de tâches ajoute le chemin d’accès avec l’ID de package. Lorsque vous utilisez cette option, définissez le chemin avec le paramètre Path .

Type:LocationType
Valeurs acceptées:TaskSequenceWorkingFolder, ClientCache, CustomPath
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifiez un nom pour cette étape afin de l’identifier dans la séquence de tâches.

Type:String
Alias:StepName
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Lorsque vous spécifiez -LocationOption CustomPath, utilisez ce paramètre pour spécifier le chemin d’accès local pour enregistrer le contenu du package. Le moteur de séquence de tâches ajoute le chemin d’accès avec l’ID de package.

Type:String
Alias:DestinationCustomPath
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_TaskSequence_DownloadPackageContentAction classe WMI du serveur.