Расширения настройки поддерживают переменные среды Windows и создают ряд дополнительных переменных среды процесса. В значении параметра конфигурации может использоваться любая переменная. Каждый документ справки указывает, какие переменные поддерживаются в определенном поле.

Примечание

С помощью элементов нацеленности Нацеленность на соответствие реестра можно определить переменные во время выполнения клиента и контролировать их поведение с помощью элементов нацеленности Нацеленность на переменную окружения или как значения в параметре элемента предпочтения.

Переменные среды Windows

Среда Windows представляет собой список переменных, сохраненных в парах имя-значение. Для просмотра текущего списка переменных введите в командной строке команду SET. У каждого процесса, включая рабочий стол, есть список уникальных переменных. Когда один процесс запускает другой, то запускаемому процессу обычно передается копия среды запускающего процесса. Обычно имена переменных среды заключаются в знаки процентов (например, %ProgramFiles%). Windows разрешает переменную среды, когда приложение запрашивает значение, сопоставленное имени.

Переменные процесса настройки

Расширения предпочтений реализуют следующие переменные процесса.

Примечание

При вводе переменных регистр не учитывается.

%AppDataDir%

Каталог Application Data текущего пользователя.

%BinaryComputerSid%

Идентификатор безопасности (SID) компьютера в шестнадцатеричном формате.

%BinaryUserSid%

Идентификатор безопасности (SID) текущего пользователя в шестнадцатеричном формате.

%CommonAppdataDir%

Каталог «Application Data» для всех пользователей («all users»).

%CommonDesktopDir%

Каталог «Рабочий стол» для всех пользователей («all users»).

%CommonFavoritesDir%

Каталог «Избранное» для всех пользователей («all users»).

%CommonProgramsDir%

Каталог «Программы» для всех пользователей («all users»).

%CommonStartMenuDir%

Каталог «Главное меню» для всех пользователей («all users»).

%CommonStartUpDir%

Каталог «Автозагрузка» для всех пользователей («all users»).

%ComputerName%

Имя NetBIOS компьютера.

%CurrentProcessId%

Цифровая подпись основного клиентского процесса.

%CurrentThreadId%

Цифровая подпись основного клиентского потока.

%DateTime%

Текущее время (UTC).

%DateTimeEx%

Текущее время (UTC) с миллисекундами.

%DesktopDir%

Каталог «Рабочий стол» текущего пользователя.

%DomainName%

Имя домена или рабочая группа компьютера.

%FavoritesDir%

Каталог «Избранное» текущего пользователя.

%LastError%

Последний код ошибки при настройке.

%LastErrorText%

Текстовое описание последнего кода ошибки.

%LdapComputerSid%

Идентификатор безопасности (SID) компьютера в двоичном формате LDAP.

%LdapUserSid%

Идентификатор безопасности (SID) текущего пользователя в двоичном формате LDAP.

%LocalTime%

Текущее местное время.

%LocalTimeEx%

Текущее местное время с миллисекундами.

%LogonDomain%

Домен текущего пользователя.

%LogonServer%

Контроллер домена, проверивший текущего пользователя.

%LogonUser%

Имя текущего пользователя.

%LogonUserSid%

Идентификатор безопасности текущего пользователя.

%MacAddress%

Первый обнаруженный MAC-адрес компьютера.

%NetPlacesDir%

Каталог «Сетевое окружение» текущего пользователя.

%OsVersion%

Операционная система: Windows Server® 2008 R2, Windows® 7, Windows Server® 2008, Windows Vista®, Windows Server 2003, Windows XP или неизвестная.

%ProgramFilesDir%

Каталог Windows Program Files.

%ProgramsDir%

Каталог «Программы» текущего пользователя.

%RecentDocumentsDir%

Каталог «Недавние документы» текущего пользователя.

%ResultCode%

Код выхода клиента.

%ResultText%

Текстовое описания кода выхода клиента.

%ReversedComputerSid%

Идентификатор безопасности (SID) компьютера в шестнадцатеричном формате обратного порядка следования байтов.

%ReversedUserSid%

Идентификатор безопасности (SID) текущего пользователя в шестнадцатеричном формате обратного порядка следования байтов.

%SendToDir%

Каталог «Отправить» текущего пользователя.

%StartMenuDir%

Каталог «Главное меню» текущего пользователя.

%StartUpDir%

Каталог «Автозагрузка» текущего пользователя.

%SystemDir%

Системный каталог Windows.

%SystemDrive%

Имя диска, с которого запускается операционная система.

%TempDir%

Каталог «Temp» текущего пользователя, определяемый Windows API.

%TimeStamp%

Отметка времени реализуемых конфигураций.

%TraceFile%

Путь и имя файла трассировки.

%WindowsDir%

Каталог Windows.

Расширения настройки предоставляют список переменных, из которых можно выбрать переменные для вставки в текстовые поля. Можно открыть диалоговое окно из любого текстового поля, которое:

  • не отключено;

  • не является доступным только для чтения;

  • не ограничено только числовыми значениями.

Чтобы ввести переменную
  1. Откройте консоль управления групповой политикой. Щелкните правой кнопкой мыши объект групповой политики (GPO), содержащий необходимый элемент предпочтения, и в контекстном меню выберите команду Изменить.

  2. Установите курсор в требуемое поле.

    • Чтобы ввести переменную процесса настройки, нажмите кнопку F3, выберите переменную из списка, а затем нажмите Выбрать, чтобы вставить переменную в поле.

    • Для ввода существующей переменной среды Windows используйте это поле.

      Примечание

      Можно запретить разрешение переменной до ее применения к клиентским компьютерам (чтобы в параметрах настройки клиентских компьютеров отображалась сама переменная, а не ее разрешенное значение). Чтобы выполнить это действие для переменной процесса предпочтения, снимите флажок Сопоставить переменную. Это приведет к вставке знаков <> между ограничителями % % и именем переменной (например, %<ProgramFiles>%). Расширения настройки удаляют символы < > из текста и оставляют неразрешенную переменную. Этот синтаксис можно использовать и с переменной среды Windows.

Дополнительные ссылки