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 :
|
_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 :
|
_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 :
|
_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.
|
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. |