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.

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

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 séquence de tâches : Télécharger le contenu du package.

Remarque

Exécutez Configuration Manager applets de commande à 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[]
Aliases:AddPackages
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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[]
Aliases:Conditions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

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

-Description

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

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

-Disable

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

Type:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Accepted values:TaskSequenceWorkingFolder, ClientCache, CustomPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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