Поделиться через


Объект Principal

Объект скрипта, предоставляющий учетные данные безопасности для субъекта. Эти учетные данные безопасности определяют контекст безопасности для задач, связанных с субъектом.

Элементы

Объект Principal имеет следующие типы элементов:

Элемент Property

Объект Principal имеет эти свойства.

Свойство Тип доступа Описание
DisplayName
Чтение/запись
Возвращает или задает имя субъекта, которое отображается в пользовательском интерфейсе планировщика задач.
GroupId
Чтение/запись
Возвращает или задает идентификатор группы пользователей, необходимой для выполнения задач, связанных с субъектом.
Id
Чтение/запись
Возвращает или задает идентификатор участника.
LogonType
Чтение/запись
Возвращает или задает метод входа в систему безопасности, необходимый для выполнения задач, связанных с субъектом.
RunLevel
Чтение/запись
Возвращает или задает идентификатор, используемый для указания уровня привилегий, необходимого для выполнения задач, связанных с субъектом.
Userid
Чтение/запись
Возвращает или задает идентификатор пользователя, необходимый для выполнения задач, связанных с субъектом.

Комментарии

При указании учетной записи не забудьте правильно использовать двойную обратную косую черту в коде, чтобы указать домен и имя пользователя. Например, используйте DOMAIN\\UserName, чтобы указать значение свойства UserId .

При чтении или записи XML для задачи учетные данные безопасности для субъекта указываются в элементе Principal схемы планировщика задач.

Если задача зарегистрирована с помощью программы командной строки at.exe и этот объект используется для получения сведений о задаче, то свойство LogonType возвращает значение 0, свойство RunLevel возвращает значение 0, а свойство UserId — Nothing.

Примеры

Дополнительные сведения и пример кода для этого объекта скрипта см. в разделе Пример триггера времени (скрипты).

Требования

Требование Значение
Минимальная версия клиента
Windows Vista [только классические приложения]
Минимальная версия сервера
Windows Server 2008 [только классические приложения]
Библиотека типов
Taskschd.tlb
DLL
Taskschd.dll