Wbudowane zmienne sekwencji zadań w programie Configuration Manager

 

Dotyczy: 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

Program System Center 2012 Configuration Manager udostępnia wbudowane zmienne sekwencji zadań. Wbudowane zmienne zawierają informacje o środowisku, w którym sekwencja zadań jest uruchomiona, a ich wartości są dostępne w całej sekwencji zadań. Zazwyczaj wbudowane zmienne są inicjowane przed wykonaniem kroków w sekwencji zadań. Na przykład wbudowana zmienna _SMSTSLogPath jest zmienną środowiskową, który określa ścieżkę używaną przez składniki programu Menedżer konfiguracji do zapisania plików dziennika podczas wykonywania sekwencji zadań; dowolny etap sekwencji zadań można uzyskiwać dostęp do tej zmiennej środowiskowej. Jednak niektóre zmienne, takie jak _SMSTSCurrentActionName, są obliczane przed każdym etapem. Wartości wbudowanych zmiennych są zwykle tylko do odczytu. Wartości są tylko do odczytu w przypadku wbudowanych zmiennych o nazwie rozpoczynającej się od znaku podkreślenia.

Lista wbudowanych zmiennych sekwencji zadań

Poniższa lista zawiera wbudowane zmienne, które są dostępne w programie Menedżer konfiguracji:

Nazwa wbudowanej zmiennej	Opis
_SMSTSAdvertID	Przechowuje unikatowy identyfikator aktualnie uruchomionego wdrożenia sekwencji zadań. Używa tego samego formatu co identyfikator wdrożenia dystrybucji oprogramowania programu Menedżer konfiguracji. Ta zmienna jest niezdefiniowana, jeśli sekwencja zadań została uruchomiona z autonomicznego nośnika. Przykład: ABC20001
_TSAppInstallStatus	Dla programu System Center 2012 R2 Configuration Manager i nowszych wersji: sekwencja zadań ustawia w zmiennej _TSAppInstallStatus stan instalacji aplikacji podczas kroku sekwencji zadań Zainstaluj aplikację. Sekwencja zadań ustawia jedną z następujących wartości zmiennej: Niezdefiniowane: ustawiana, jeśli krok sekwencji zadań Zainstaluj nie został uruchomiony. Błąd: ustawiana, jeśli wystąpił błąd co najmniej jednej aplikacji z powodu błędu podczas wykonywania kroku sekwencji zadań Zainstaluj aplikację. Ostrzeżenie: ustawiana, jeśli nie występują błędy podczas wykonywania kroku sekwencji zadań Zainstaluj aplikację, ale co najmniej jedna z aplikacji lub wymagana zależność nie zostały zainstalowane, ponieważ nie spełniono wymagania. Powodzenie: ustawiana, jeśli nie wykryto błędów ani ostrzeżeń podczas wykonywania kroku sekwencji zadań Zainstaluj aplikację.
_SMSTSBootImageID	Przechowuje identyfikator pakietu obrazu rozruchowego programu Menedżer konfiguracji, jeśli pakiet obrazu rozruchowego jest skojarzony z aktualnie uruchomioną sekwencją zadań. Zmienna nie zostanie ustawiona, jeśli nie ma skojarzonego pakietu obrazu rozruchowego programu Menedżer konfiguracji. Przykład: ABC00001
_SMSTSBootUEFI	Dla programu System Center 2012 Configuration Manager z dodatkiem SP1 i nowszych wersji: Sekwencja zadań ustawia zmienną _SMSTSBootUEFI, gdy wykryje komputer uruchamiany w trybie UEFI.
_SMSTSClientGUID	Przechowuje wartość identyfikatora GUID klienta programu Menedżer konfiguracji. Ta zmienna nie jest ustawiona, jeśli sekwencja zadań jest uruchomiona z autonomicznego nośnika. Przykład: 0a1a9a4b-fc56-44f6-b7cd-c3f8ee37c04c
_SMSTSCurrentActionName	Określa nazwę aktualnie uruchomionego etapu sekwencji zadań. Ta zmienna jest ustawiana przed uruchomieniem każdego etapu przez Menedżera sekwencji zadań. Przykład: uruchom wiersz polecenia
_SMSTSDownloadOnDemand	Ma wartość true, jeśli aktualna sekwencja zadań jest uruchomiona w trybie pobierania na żądanie, co oznacza, że Menedżer sekwencji zadań pobiera zawartość lokalnie tylko wtedy, gdy musi mieć do niej dostęp.
_SMSTSInWinPE	Ta zmienna ma ustawioną wartość true, gdy aktualny etap sekwencji zadań jest uruchomiony w środowisku Windows PE; w przeciwnym razie ma ona wartość false. Tę zmienną sekwencji zadań można sprawdzić w celu określenia bieżącego środowiska systemu operacyjnego.
_SMSTSLastActionRetCode	Zawiera kod powrotu zwrócony przez ostatnią akcję, która została uruchomiona. Ta zmienna może służyć jako warunek do określenia, czy należy uruchomić następny etap. Przykład: 0
_SMSTSLastActionSucceeded	Ma ustawioną wartość true, jeśli ostatnia akcja zakończyła się pomyślnie; ma ustawioną wartość false, jeśli ostatnia akcja nie powiodła się. Jeśli ostatnia akcja została pominięta, ponieważ etap został wyłączony lub skojarzony warunek przyjął wartość false, ta zmienna nie zostanie zresetowana, co oznacza, że nadal będzie zawierać wartość dla poprzedniej akcji.
_SMSTSLaunchMode	Określa metodę uruchamiania sekwencji zadań. Sekwencja zadań może mieć następujące wartości: SMS — określa, że sekwencja zadań została uruchomiona przy użyciu klienta programu Menedżer konfiguracji. UFD — określa, że sekwencja zadań została uruchomiona z nośnika USB i że nośnik USB został utworzony w systemie Windows XP/2003. UFD+FORMAT — określa, że sekwencja zadań została uruchomiona z nośnika USB i że nośnik USB został utworzony w systemie Windows Vista lub nowszym. CD — określa, że sekwencja zadań została uruchomiona z dysku CD. DVD — określa, że sekwencja zadań została uruchomiona z dysku DVD. PXE — określa, że sekwencja zadań została uruchomiona ze środowiska PXE. HD — określa, że sekwencja zadań została uruchomiona z dysku twardego (tylko w przypadku nośników wstępnie przygotowanych).
_SMSTSLogPath	Przechowuje pełną ścieżkę katalogu dziennika. Służy ona do określenia miejsca, w którym są rejestrowane działania. Ta wartość nie jest ustawiona, jeśli dysk twardy nie jest dostępny.
_SMSTSMachineName	Przechowuje i określa nazwę komputera. Przechowuje nazwę komputera, którego sekwencja zadań będzie używała do logowania wszystkich komunikatów o stanie. Aby zmienić nazwę komputera w nowym systemie operacyjnym, użyj zmiennej OSDComputerName. Przykład: ABC
_SMSTSMDataPath	Określa ścieżkę zdefiniowaną przez zmienną SMSTSLocalDataDrive. W przypadku zdefiniowania zmiennej SMSTSLocalDataDrive przed uruchomieniem sekwencji zadań, na przykład przez ustawienie zmiennej kolekcji, program Menedżer konfiguracji definiuje zmienną _SMSTSMDataPath, gdy rozpoczyna się wykonanie sekwencji zadań.
_SMSTSMediaType	Określa typ nośnika, który jest używany do inicjowania instalacji. Przykłady typów nośników to nośnik rozruchowy, nośnik pełny, PXE i wstępnie przygotowany nośnik.
_SMSTSMP	Przechowuje nazwę lub adres IP punktu zarządzania programu Menedżer konfiguracji.
_SMSTSMPPort	Przechowuje numer portu punktu zarządzania programu Menedżer konfiguracji. Przykład: 80
_SMSTSOrgName	Przechowuje informacje o tytule znakowania wyświetlane w oknie dialogowym interfejsu użytkownika postępu sekwencji zadań. Przykład: Organizacja XYZ
_SMSTSPackageID	Przechowuje identyfikator aktualnie uruchomionej sekwencji zadań. Ten identyfikator używa tego samego formatu co identyfikator pakietu oprogramowania programu Menedżer konfiguracji. Przykład: HJT00001
_SMSTSPackageName	Przechowuje nazwę aktualnie uruchomionej sekwencji zadań określoną przez administratora programu Menedżer konfiguracji podczas tworzenia sekwencji zadań. Przykład: Sekwencja zadań wdrożenia systemu Windows 7
_SMSTSRunFromDP	Ma wartość true, jeśli aktualna sekwencja zadań jest uruchomiona w trybie uruchamiania z punktu dystrybucji, co oznacza, że Menedżer sekwencji zadań uzyskuje dostęp do udziałów wymaganego pakietu z punktu dystrybucji.
_SMSTSSiteCode	Przechowuje kod lokacji programu Menedżer konfiguracji. Przykład: ABC
_SMSTSType	Określa typ aktualnie uruchomionej sekwencji zadań. Może mieć następujące wartości: 1 wskazuje ogólną sekwencję zadań. 2 wskazuje sekwencję zadań wdrażania systemu operacyjnego.
_SMSTSTimezone	Zmienna _SMSTSTimezone przechowuje informacje o strefie czasowej w następującym formacie (bez spacji): Bias, StandardBias, DaylightBias, StandardDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, DaylightDate.wYear, wMonth, wDayOfWeek, wDay, wHour, wMinute, wSecond, wMilliseconds, StandardName, DaylightName Przykład: W przypadku Czasu wschodniego (Stany Zjednoczone i Kanada) wartość będzie wynosić 300,0,-60,0,11,0,1,2,0,0,0,0,3,0,2,2,0,0,0,Eastern Standard Time,Eastern Daylight Time
_SMSTSUseCRL	Określa, czy sekwencja zadań używa listy odwołań certyfikatów w przypadku użycia certyfikatu Secure Socket Layer (SSL) do komunikacji z punktem zarządzania.
_SMSTSUserStarted	Określa, czy sekwencja zadań jest uruchomiona przez użytkownika. Ta zmienna jest ustawiana tylko wtedy, gdy sekwencja zadań jest uruchamiana z Centrum oprogramowania. Na przykład jeśli zmienna _SMSTSLaunchMode ma ustawioną wartość SMS. Zmienna może mieć następujące wartości: true — określa, że sekwencja zadań jest uruchomiona ręcznie przez użytkownika z Centrum oprogramowania. false — określa, że sekwencja zadań jest inicjowana automatycznie przez harmonogram programu Menedżer konfiguracji.
_SMSTSUseSSL	Określa, czy sekwencja zadań używa protokołu SSL do komunikowania się z punktem zarządzania programu Menedżer konfiguracji. Jeśli lokacja jest hostowana w trybie macierzystym, wartość jest równa true.
_SMSTSWTG	Dla programu System Center 2012 Configuration Manager z dodatkiem SP1 i nowszych wersji: określa, czy komputer działa jako urządzenie Windows To Go.
SMSTSAssignmentsDownloadInterval	Dla programu System Center 2012 Configuration Manager z dodatkiem SP1 i nowszych wersji: Ta zmienna umożliwia określenie czasu oczekiwania w sekundach przed próbą pobrania przez klienta zasad od momentu ostatniej próby, która nie zwróciła żadnych zasad. Domyślnie klient będzie czekać 0 sekund przed ponowną próbą. Możesz ustawić tę zmienną przy użyciu polecenia przeduruchomieniowego z nośnika lub środowiska PXE.
SMSTSAssignmentsDownloadRetry	Dla programu System Center 2012 Configuration Manager z dodatkiem SP1 i nowszych wersji: Ta zmienna umożliwia określenie liczby prób pobrania przez klienta zasad, jeśli przy pierwszej próbie nie znaleziono zasad. Domyślnie klient ponawia próbę 0 razy. Możesz ustawić tę zmienną przy użyciu polecenia przeduruchomieniowego z nośnika lub środowiska PXE.
SMSTSAssignUsersMode	Określa, jak sekwencja zadań kojarzy użytkowników z komputerem docelowym. Ustaw zmienną na jedną z następujących wartości: Auto: sekwencja zadań tworzy relację między określonymi użytkownikami a komputerem docelowym podczas wdrażania systemu operacyjnego na komputerze docelowym. Pending: sekwencja zadań tworzy relację między określonymi użytkownikami a komputerem docelowym, ale przed ustawieniem relacji oczekuje na zatwierdzenie przez użytkownika administracyjnego. Disabled: sekwencja zadań nie kojarzy użytkowników z komputerem docelowym podczas wdrażania systemu operacyjnego.
SMSTSDownloadProgram	Dla programu System Center 2012 Configuration Manager z dodatkiem SP1 i nowszych wersji: ta zmienna umożliwia określenie dla sekwencji zadań alternatywnego dostawcy zawartości, czyli programu służącego do pobierania zawartości zamiast domyślnego programu do pobierania w oprogramowaniu Menedżer konfiguracji. W ramach procesu pobierania zawartości sekwencja zadań sprawdza zmienną dla określonego programu do pobierania. Jeżeli został określony, sekwencja zadań uruchamia program w celu wykonania pobierania.
SMSTSDownloadRetryCount	Dla programu System Center 2012 R2 Configuration Manager i nowszych wersji: ta zmienna umożliwia określenie liczby prób pobrania zawartości z punktu dystrybucji podejmowanych przez program Menedżer konfiguracji. Domyślnie klient ponawia próbę 2 razy.
SMSTSDownloadRetryDelay	Dla programu System Center 2012 R2 Configuration Manager i nowszych wersji: ta zmienna umożliwia określenie czasu oczekiwania w sekundach przed ponowną próbą pobrania przez program Menedżer konfiguracji zawartości z punktu dystrybucji. Domyślnie klient będzie czekać 15 sekund przed ponowną próbą.
SMSTSErrorDialogTimeout	Po wystąpieniu błędu w sekwencji zadań jest wyświetlane okno dialogowe i jest ono automatycznie odrzucane po upływie liczby sekund określonej przez tę zmienną. Domyślnie okno dialogowe jest automatycznie odrzucane po 900 sekundach (15 minutach).
TSErrorOnWarning	Dla programu System Center 2012 R2 Configuration Manager i nowszych wersji: Użyj tej zmiennej, aby określić, czy aparat sekwencji zadań traktuje ostrzeżenie jako błąd podczas etapu instalowania aplikacji sekwencji zadań. Sekwencja zadań ustawia zmienną _TSAppInstallStatus na wartość Warning w przypadku, gdy co najmniej jedna aplikacja lub wymagana zależność nie została zainstalowana, ponieważ nie zostało spełnione wymaganie. W przypadku ustawienia zmiennej TSErrorOnWarning na wartość True i zmiennej _TSAppInstallStatus na wartość Warning opisana sytuacja będzie traktowana jako błąd. Wartość False jest zachowaniem domyślnym.
SMSTSLanguageFolder	Dla programu System Center 2012 Configuration Manager z dodatkiem SP1 i nowszych wersji: ta zmienna umożliwia zmianę języka wyświetlania obrazu rozruchowego niezależnego od języka.
SMSTSLocalDataDrive	Określa, gdzie są przechowywane tymczasowe pliki na komputerze docelowym, gdy jest uruchomiona sekwencja zadań. Ta zmienna musi zostać ustawiona przed uruchomieniem sekwencji zadań, na przykład przez ustawienie zmiennej kolekcji. Po uruchomieniu sekwencji zadań program Menedżer konfiguracji definiuje zmienną _SMSTSMDataPath, gdy rozpoczyna się wykonanie sekwencji zadań.
SMSTSMPListRequestTimeout	Dla programu System Center 2012 R2 Configuration Manager i nowszych wersji: Ta zmienna umożliwia określenie czasu oczekiwania (w milisekundach) przez sekwencję zadań przed ponowną próbą zainstalowania aplikacji po niepowodzeniu pobrania listy punktów zarządzania z usług lokalizacji. Domyślnie sekwencja zadań czeka 60 000 milisekund (60 sekund), zanim ponawia etap, a liczba ponownych prób to maksymalnie trzy. Ta zmienna dotyczy tylko kroku sekwencji zadań Zainstaluj aplikację.
SMSTSPersistContent	Dla programu System Center 2012 Configuration Manager z dodatkiem SP1 i nowszych wersji: ta zmienna służy do tymczasowego zachowania zawartości w pamięci podręcznej sekwencji zadań.
SMSTSPostAction	Dla programu System Center 2012 Configuration Manager z dodatkiem SP1 i nowszych wersji: Określa polecenie, które jest uruchamiane po ukończeniu sekwencji zadań. Na przykład można użyć tej zmiennej do określenia skryptu, który włącza filtry zapisu na urządzeniach wbudowanych po wdrożeniu systemu operacyjnego na urządzeniu przez sekwencję zadań.
SMSTSPreferredAdvertID	Wymusza uruchomienie określonego wdrożenia na komputerze docelowym. Można ją skonfigurować z użyciem wstępnie uruchamianych poleceń z nośników lub środowiska PXE. Jeśli ta zmienna jest ustawiona, sekwencja zadań zastępuje wszelkie wymagane wdrożenia.
OSDPreserveDriveLetter	Dla programu System Center 2012 Configuration Manager z dodatkiem SP1 i nowszych wersji: Ta zmienna określa, czy sekwencja zadań używa litery dysku przechwytywanej w pliku WIM obraz systemu operacyjnego w przypadku stosowania tego obrazu na komputerze docelowym. W programie Menedżer konfiguracji bez dodatku Service Pack litera dysku w pliku WIM była używana, gdy program stosował plik WIM obrazu systemu operacyjnego. W programie Menedżer konfiguracji z dodatkiem SP1 można ustawić wartość tej zmiennej na False, aby użyć lokalizacji określonej dla ustawienia Miejsce docelowe w kroku sekwencji zadań Zastosuj system operacyjny. Więcej informacji o kroku sekwencji zadań Zastosuj system operacyjny znajduje się w sekcji Zastosuj obraz systemu operacyjnego w temacie Kroki sekwencji zadań w programie Configuration Manager.
SMSTSRebootDelay	Określa czas oczekiwania (w sekundach) przed ponownym uruchomieniem komputera. Jeśli ta zmienna nie jest równa 0, Menedżer sekwencji zadań wyświetli okno dialogowe powiadomienia przed ponownym rozruchem. Przykłady: 0 30
SMSTSRebootMessage	Określa komunikat wyświetlany w oknie dialogowym zamknięcia systemu, gdy jest wymagane ponowne uruchomienie komputera. Jeśli ta zmienna nie jest ustawiona, zostanie wyświetlony komunikat domyślny. Przykład: Ten komputer jest uruchamiany ponownie przez Menedżera sekwencji zadań.
SMSTSRebootRequested	Wskazuje, że po ukończeniu bieżącego etapu sekwencji zadań wymagane jest ponowne uruchomienie. Jeśli ponowne uruchomienie jest wymagane, ustaw wartość tej zmiennej na true, a Menedżer sekwencji zadań ponownie uruchomi komputer po wykonaniu tego etapu sekwencji zadań. Etap sekwencji zadań musi ustawić tę zmienną sekwencji zadań, jeśli wymaga ponownego uruchomienia do ukończenia etapu sekwencji zadań. Po ponownym uruchomieniu komputera sekwencja zadań będzie kontynuowała pracę od następnego kroku sekwencji zadań.
SMSTSRetryRequested	Żąda ponowienia próby po ukończeniu bieżącego etapu sekwencji zadań. Jeśli ustawiono tę zmienną sekwencji zadań, zmienna SMSTSRebootRequested również musi być ustawiona na wartość true. Po ponownym uruchomieniu komputera Menedżer sekwencji zadań spowoduje ponowne uruchomienie tego samego etapu sekwencji zadań.
SMSTSUDAUsers	Określa użytkownika podstawowego komputera docelowego. Określa użytkowników w następującym formacie. Do rozdzielania wielu użytkowników użyj przecinka (,). Przykład: domena\użytkownik1, domena\użytkownik2, domena\użytkownik3 Więcej informacji o sposobie kojarzenia użytkowników z komputerem docelowym znajduje się w temacie Tworzenie skojarzeń użytkowników z komputerem docelowym.

Zobacz też

Zmienne sekwencji zadań w programie Configuration Manager