Partager via


Variables intégrées de séquence de tâches dans Configuration Manager

 

S'applique à: System Center 2012 Configuration Manager, System Center 2012 Configuration Manager SP1, System Center 2012 Configuration Manager SP2, System Center 2012 R2 Configuration Manager, System Center 2012 R2 Configuration Manager SP1

Des variables intégrées de séquence de tâches sont fournies par System Center 2012 Configuration Manager. Les variables intégrées fournissent des informations sur l'environnement dans lequel la séquence de tâches est exécutée, et leurs valeurs sont disponibles tout au long de la séquence de tâches. En règle générale, les variables intégrées sont initialisées avant que les étapes soient exécutées dans la séquence de tâches. Par exemple, la variable intégrée _SMSTSLogPath est une variable d'environnement qui spécifie le chemin d'accès que les composants Configuration Manager utilisent pour écrire des fichiers journaux pendant l'exécution de la séquence de tâches ; toutes les étapes de la séquence de tâches peuvent accéder à cette variable d'environnement. Toutefois, certaines variables, telles que _SMSTSCurrentActionName, sont évaluées avant chaque étape. Les valeurs des variables intégrées sont généralement en lecture seule. Les valeurs sont lues uniquement pour les variables intégrées dont le nom commence par un trait de soulignement.

Liste des variables intégrées de la séquence de tâches

La liste suivante décrit les variables intégrées qui sont disponibles dans Configuration Manager :

Nom de variable intégrée

Description

_SMSTSAdvertID

Stocke l'ID unique de déploiement de la séquence de tâches en cours d'exécution. Elle utilise le même format qu'un ID de déploiement de distribution logicielle Configuration Manager. Si la séquence de tâches s'exécute à partir d'un média autonome, cette variable n'est pas définie.

Exemple :

ABC20001

_TSAppInstallStatus

Pour System Center 2012 R2 Configuration Manager et ultérieur :

la séquence de tâches définit la variable _TSAppInstallStatus avec l'état d'installation de l'application lors de l'étape de séquence de tâches Installer l'application. La séquence de tâches définit la variable sur l'une des valeurs suivantes :

  1. Non défini : valeur définie lorsque l'étape de séquence de tâches Installer l'application n'a pas été exécutée.

  2. Erreur : valeur définie lorsqu'au moins une application a échoué en raison d'une erreur lors de l'étape de séquence de tâches Installer l'application.

  3. Avertissement : valeur définie lorsque aucune erreur ne se produit lors de l'étape de séquence de tâches Installer l'application, mais qu'une ou plusieurs applications, ou une dépendance requise, ne se sont pas installées car une spécification n'a pas été satisfaite.

  4. Opération réussie : valeur définie lorsqu'il n'y a aucune erreur ou aucun avertissement détecté lors de l'étape de séquence de tâches Installer l'application.

_SMSTSBootImageID

Stocke l'ID de package d'images de démarrage Configuration Manager si un package d'images de démarrage est associé à la séquence de tâches en cours d'exécution. La variable ne sera pas définie sans package d'images de démarrage Configuration Manager associé.

Exemple :

ABC00001

_SMSTSBootUEFI

Pour System Center 2012 Configuration Manager SP1 et ultérieur :

la séquence de tâches définit la variable SMSTSBootUEFI lorsqu'elle détecte un ordinateur en mode UEFI.

_SMSTSClientGUID

Stocke la valeur du GUID du client Configuration Manager. Cette variable n'est pas définie si la séquence de tâches est exécutée à partir d'un média autonome.

Exemple :

0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c

_SMSTSCurrentActionName

Spécifie le nom de l'étape de séquence de tâches en cours d'exécution. Cette variable est définie avant que le gestionnaire des séquences de tâches exécute chaque étape individuelle.

Exemple :

exécuter la ligne de commande

_SMSTSDownloadOnDemand

Variable définie sur vrai si la séquence de tâches en cours est exécutée en mode de téléchargement sur demande, ce qui signifie que le gestionnaire des séquences de tâches télécharge le contenu localement uniquement lorsqu'il doit y accéder.

_SMSTSInWinPE

Cette variable est définie sur vrai lorsque l'étape de séquence de tâches en cours est exécutée dans l'environnement Windows PE et elle est définie sur faux dans le cas inverse. Vous pouvez tester cette variable de séquence de tâches pour déterminer l'environnement de système d'exploitation actuel.

_SMSTSLastActionRetCode

Stocke le code de retour qui a été renvoyé par la dernière action exécutée. Cette variable peut être utilisée comme une condition pour déterminer si l'étape suivante est exécutée.

Exemple :

0

_SMSTSLastActionSucceeded

Cette variable est définie sur vrai si la dernière action a réussi et sur faux si elle a échoué. Si la dernière action a été ignorée car l'étape était désactivée ou la condition associée était évaluée sur faux, cette variable n'est pas réinitialisée, ce qui signifie qu'elle contient toujours la valeur de l'action précédente.

_SMSTSLaunchMode

Spécifie la méthode de lancement de la séquence de tâches. La séquence de tâches peut avoir les valeurs suivantes :

  • SMS : spécifie que la séquence de tâches est démarrée à partir du client Configuration Manager.

  • Disque mémoire flash USB : spécifie que la séquence de tâches est démarrée à l'aide d'un support USB et que le support USB a été créé sous Windows XP/2003.

  • Disque mémoire flash USB+FORMAT : spécifie que la séquence de tâches est démarrée à l'aide d'un support USB et que le support USB a été créé sous Windows Vista ou ultérieur.

  • CD : spécifie que la séquence de tâches est démarrée à l'aide d'un CD.

  • DVD : spécifie que la séquence de tâches est démarrée à l'aide d'un DVD.

  • PXE : spécifie que la séquence de tâches est démarrée à partir de PXE.

  • HD : spécifie que la séquence de tâches a été démarrée à partir d'un disque dur (média préparé uniquement).

_SMSTSLogPath

Stocke le chemin d'accès complet du répertoire des journaux. Cette variable peut servir à déterminer l'emplacement des actions consignées. Cette valeur n'est pas définie si un disque dur n'est pas disponible.

_SMSTSMachineName

Stocke et spécifie le nom de l'ordinateur. Stocke le nom de l'ordinateur que la séquence de tâches utilisera pour consigner tous les messages d'état. Pour modifier le nom d'ordinateur dans le nouveau système d'exploitation, utilisez la variable OSDComputerName.

Exemple :

ABC

_SMSTSMDataPath

Spécifie le chemin d'accès défini par la variable SMSTSLocalDataDrive. Lorsque que vous définissez SMSTSLocalDataDrive avant le démarrage de la séquence de tâches, notamment en définissant une variable de regroupement, Configuration Manager définit ensuite la variable _SMSTSMDataPath une fois que la séquence de tâches démarre.

_SMSTSMediaType

Spécifie le type de média qui est utilisé pour démarrer l'installation. Le média de démarrage, le média complet, l'environnement PXE et le média préparé sont des exemples de types de médias.

_SMSTSMP

Stocke le nom ou l'adresse IP d'un point de gestion Configuration Manager.

_SMSTSMPPort

Stocke le numéro de port d'un point de gestion Configuration Manager.

Exemple :

80

_SMSTSOrgName

Stocke le nom du titre de la marque qui s'affiche dans la boîte de dialogue de l'interface utilisateur de progression d'une séquence de tâches.

Exemple :

Organisation XYZ

_SMSTSPackageID

Stocke l'ID de la séquence de tâches en cours d'exécution. Cet ID utilise le même format qu'un ID de package logiciel Configuration Manager.

Exemple :

HJT00001

_SMSTSPackageName

Stocke le nom de la séquence de tâches en cours d'exécution spécifié par l'administrateur Configuration Manager au moment de la création de la séquence de tâches.

Exemple :

Déployer la séquence de tâches de Windows 7

_SMSTSRunFromDP

Variable définie sur vrai si la séquence de tâches en cours est exécutée en mode exécution à partir du point de distribution, ce qui signifie que le gestionnaire des séquences de tâches obtient des partages de packages requis à partir de points de distribution.

_SMSTSSiteCode

Stocke le code de site du site Configuration Manager.

Exemple :

ABC

_SMSTSType

Spécifie le type de séquence de tâches en cours d'exécution. Il peut afficher les valeurs suivantes :

1 : indique une séquence de tâches générique.

2 : indique une séquence de tâches de déploiement du système d'exploitation.

_SMSTSTimezone

La variable _SMSTSTimezone stocke les informations de fuseau horaire au format suivant (sans espaces) :

Biais, StandardBias, DaylightBias, StandardDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, DaylightDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, StandardName, DaylightName

Exemple :

Pour l'heure de la côte est des États-Unis et du Canada, la valeur serait 300,0,-60,0,11,0,1,2,0,0,0,0,3,0,2,2,0,0,0,Heure standard de la côte est, heure d'été de la côte est 

_SMSTSUseCRL

Spécifie si la séquence de tâches utilise la liste de révocation de certificats lors de l'utilisation d'un certificat SSL (Secure Socket Layer) pour communiquer avec le point de gestion.

_SMSTSUserStarted

Spécifie si un utilisateur démarre une séquence de tâches. Cette variable est définie uniquement si la séquence de tâches est démarrée à partir du Centre logiciel. Par exemple, si la variable _SMSTSLaunchMode est définie sur SMS. La variable peut afficher les valeurs suivantes :

  • vrai : spécifie que la séquence de tâches est démarrée manuellement par un utilisateur depuis le Centre logiciel.

  • faux : spécifie que la séquence de tâches est lancée automatiquement par le planificateur Configuration Manager.

_SMSTSUseSSL

Spécifie si la séquence de tâches utilise SSL pour communiquer avec le point de gestion Configuration Manager. Si votre site fonctionne en mode natif, la valeur est réglée sur vrai.

_SMSTSWTG

Pour System Center 2012 Configuration Manager SP1 et ultérieur :

spécifie si l'ordinateur s'exécute comme un appareil Windows Go To.

SMSTSAssignmentsDownloadInterval

Pour System Center 2012 Configuration Manager SP1 et ultérieur :

Utilisez cette variable pour spécifier le délai d'attente (exprimé en secondes) entre deux tentatives de téléchargement de la stratégie quand la tentative précédente n'a renvoyé aucune stratégie. Par défaut, le client attend 0 seconde avant une nouvelle tentative.

Cette variable peut être définie à l'aide d'une commande de prédémarrage à partir du média ou de l'environnement PXE.

SMSTSAssignmentsDownloadRetry

Pour System Center 2012 Configuration Manager SP1 et ultérieur :

Utilisez cette variable pour spécifier le nombre de tentatives de téléchargement de la stratégie par un client quand aucune stratégie n'est trouvée à la première tentative. Par défaut, le client retente 0 fois.

Cette variable peut être définie à l'aide d'une commande de prédémarrage à partir du média ou de l'environnement PXE.

SMSTSAssignUsersMode

Spécifie la façon dont une séquence de tâches associe des utilisateurs à l'ordinateur de destination. Définissez la variable sur l'une des valeurs suivantes.

  • Auto : La séquence de tâches crée une relation entre les utilisateurs spécifiés et l'ordinateur de destination lorsqu'elle déploie le système d'exploitation sur l'ordinateur de destination.

  • En attente : La séquence de tâches crée une relation entre les utilisateurs spécifiés et l'ordinateur de destination, mais attend l'approbation de l'utilisateur administratif avant de définir la relation.

  • Désactivé : La séquence de tâches n'associe pas d'utilisateurs à l'ordinateur de destination lorsqu'elle déploie le système d'exploitation.

SMSTSDownloadProgram

Pour System Center 2012 Configuration Manager SP1 et ultérieur :

utilisez cette variable pour spécifier un autre fournisseur de contenu, c'est-à-dire un programme de téléchargement utilisé pour télécharger le contenu en lieu et place du programme de téléchargement par défaut de Configuration Manager dans le cadre de la séquence de tâches. Dans le cadre du processus de téléchargement de contenu, la séquence de tâches examine si la variable indique un programme de téléchargement spécifique. Si c'est le cas, la séquence de tâches l'exécute pour procéder au téléchargement.

SMSTSDownloadRetryCount

Pour System Center 2012 R2 Configuration Manager et ultérieur :

utilisez cette variable pour spécifier le nombre de fois que Configuration Manager tente de télécharger du contenu à partir d'un point de distribution. Par défaut, le client effectue 2 nouvelles tentatives. 

SMSTSDownloadRetryDelay

Pour System Center 2012 R2 Configuration Manager et ultérieur :

utilisez cette variable pour spécifier le nombre de secondes que Configuration Manager attend avant de retenter de télécharger du contenu à partir d'un point de distribution. Par défaut, le client attend 15 secondes avant une nouvelle tentative.

SMSTSErrorDialogTimeout

Lorsqu'une erreur se produit dans une séquence de tâches, une boîte de dialogue s'affiche et est fermée automatiquement après un nombre de secondes spécifié par cette variable. Par défaut, la boîte de dialogue disparaît automatiquement après 900 secondes (15 minutes).

TSErrorOnWarning

Pour System Center 2012 R2 Configuration Manager et ultérieur :

Utilisez cette variable pour spécifier si le moteur de séquence de tâches considère qu'un avertissement détecté constitue une erreur durant l'étape de séquence de tâches Installation de l'application. La séquence de tâches affecte la valeur Warning à la variable _TSAppInstallStatus quand une ou plusieurs applications, ou une dépendance nécessaire, n'ont pas été installées car une exigence n'a pas été remplie. Lorsque vous affectez la valeur True à la variable TSErrorOnWarning et que la variable _TSAppInstallStatus a la valeur Warning, elle est traitée comme une erreur. La valeur False est le comportement par défaut.

SMSTSLanguageFolder

Pour System Center 2012 Configuration Manager SP1 et ultérieur :

utilisez cette variable pour modifier la langue d'affichage d'une image de démarrage indépendante de la langue.

SMSTSLocalDataDrive

Spécifie l'emplacement de stockage des fichiers temporaires sur l'ordinateur de destination lors de l'exécution de la séquence de tâches.

Cette variable doit être définie avant le démarrage de la séquence de tâches, notamment en définissant une variable de regroupement. Une fois que la séquence de tâches démarre, Configuration Manager définit la variable _SMSTSMDataPath.

SMSTSMPListRequestTimeout

Pour System Center 2012 R2 Configuration Manager et ultérieur :

Utilisez cette variable pour spécifier le délai d'attente (en millisecondes) d'une séquence de tâche avant qu'elle réessaie d'installer une application après qu'elle n'a pas réussi à récupérer la liste de points de gestion depuis les services d'emplacement. Par défaut, la séquence de tâches attend 60 000 millisecondes (60 secondes) avant de retenter d'exécuter l'étape et elle effectue jusqu'à trois nouvelles tentatives. Cette variable s'applique uniquement à l'étape de séquence de tâches d'installation de l'application.

SMSTSPersistContent

Pour System Center 2012 Configuration Manager SP1 et ultérieur :

utilisez cette variable pour conserver temporairement le contenu du cache de la séquence de tâches.

SMSTSPostAction

Pour System Center 2012 Configuration Manager SP1 et ultérieur :

Spécifie une commande exécutée une fois la séquence de tâches terminée. Par exemple, vous pouvez utiliser cette variable pour spécifier un script qui active des filtres d'écriture sur les appareils intégrés après que la séquence de tâches a déployé un système d'exploitation sur l'appareil.

SMSTSPreferredAdvertID

Force l'exécution d'un déploiement ciblé spécifique sur l'ordinateur de destination. Cela peut être défini à l'aide d'une commande de prédémarrage à partir de média ou PXE. Si cette variable est définie, la séquence de tâches se substitue à tous les déploiements requis.

OSDPreserveDriveLetter

Pour System Center 2012 Configuration Manager SP1 et ultérieur :

Cette variable détermine si la séquence de tâches utilise la lettre de lecteur capturée dans le fichier WIM d'image de système d'exploitation quand vous appliquez cette image à un ordinateur de destination. Dans Configuration Manager sans Service Pack, la lettre de lecteur capturée dans le fichier WIM est utilisée lors de l'application du fichier WIM d'image de système d'exploitation. Dans Configuration Manager SP1, vous pouvez définir la valeur de cette variable sur False pour utiliser l'emplacement que vous spécifiez pour le paramètre Destination à l'étape de séquence de tâches Appliquer le système d'exploitation. Pour plus d'informations sur l'étape de séquence de tâches Appliquer le système d'exploitation, voir la section Appliquer l'image de système d'exploitation de la rubrique Étapes de séquence de tâches dans Configuration Manager.

SMSTSRebootDelay

Spécifie le nombre de secondes à attendre avant que l'ordinateur redémarre. Le gestionnaire des séquences de tâches affiche une boîte de dialogue de notification avant le redémarrage si cette variable n'est pas définie sur 0.

Exemples :

0

30

SMSTSRebootMessage

Spécifie le message à afficher dans la boîte de dialogue de fermeture lorsqu'un redémarrage est demandé. Si vous ne définissez pas cette variable, un message par défaut apparaît.

Exemple :

Cet ordinateur est en cours de redémarrage par le gestionnaire des séquences de tâches.

SMSTSRebootRequested

Indique qu'un redémarrage est demandé après que l'étape de séquence de tâches en cours est terminée. Si un redémarrage est nécessaire, définissez simplement cette variable sur vrai et le gestionnaire des séquences de tâches redémarrera l'ordinateur après cette étape de la séquence de tâches. L'étape de séquence de tâches doit définir cette variable de séquence de tâches si elle exige un redémarrage pour finaliser l'étape de la séquence de tâches. Après le redémarrage de l'ordinateur, la séquence de tâches continue d'être exécutée à partir de l'étape de séquence de tâches suivante.

SMSTSRetryRequested

Demande une nouvelle tentative après la fin de l'étape de séquence de tâches en cours. Si cette variable de séquence de tâches est définie, la variable SMSTSRebootRequested doit également être définie sur vrai. Après le redémarrage de l'ordinateur, le gestionnaire des séquences de tâches exécute à nouveau la même étape de la séquence de tâches.

SMSTSUDAUsers

Spécifie l'utilisateur principal de l'ordinateur de destination. Spécifiez les utilisateurs en utilisant le format suivant. Séparez plusieurs utilisateurs à l'aide d'une virgule (,).

Exemple :

domaine\utilisateur1, domaine\utilisateur2, domaine\utilisateur3

Pour plus d'informations sur l'association d'utilisateurs à l'ordinateur de destination, voir Comment associer des utilisateurs à un ordinateur de destination.