Класс Msvm_StorageJob

Статья
06/13/2023

Представляет задание операции хранения, созданное службой управления образами Microsoft Hyper-V.

Следующий синтаксис представляет собой упрощенный код формата управляемого объекта (MOF) и включает все унаследованные свойства.

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_StorageJob : CIM_ConcreteJob
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   JobStatus;
  datetime TimeSubmitted;
  datetime ScheduledStartTime;
  datetime StartTime;
  datetime ElapsedTime;
  uint32   JobRunTimes;
  uint8    RunMonth;
  sint8    RunDay;
  sint8    RunDayOfWeek;
  datetime RunStartInterval;
  uint16   LocalOrUtcTime;
  datetime UntilTime;
  string   Notify;
  string   Owner;
  uint32   Priority;
  uint16   PercentComplete;
  boolean  DeleteOnCompletion;
  uint16   ErrorCode;
  string   ErrorDescription;
  string   ErrorSummaryDescription;
  uint16   RecoveryAction;
  string   OtherRecoveryAction;
  uint16   JobState;
  datetime TimeOfLastStateChange;
  datetime TimeBeforeRemoval = 00000000000500.000000:000";
  boolean  Cancellable;
  string   Child;
  UINT32   JobCompletionStatusCode;
  string   Parent;
  uint16   JobType;
};

Члены

Класс Msvm_StorageJob имеет следующие типы членов:

Методы
Свойства

Методы

Класс Msvm_StorageJob содержит следующие методы.

Метод	Описание
GetError	Извлекает ошибку, описывающую причину сбоя задания.
GetErrorEx	Если задание выполняется или завершается без ошибок, этот метод не возвращает Msvm_Error экземпляра. Однако если задание завершилось сбоем из-за какой-либо внутренней проблемы или из-за того, что задание было завершено клиентом, возвращается один или несколько экземпляров Msvm_Error .
KillJob	Этот метод не поддерживается.
RequestStateChange	Запрашивает изменение состояния.

Свойства

Класс Msvm_StorageJob имеет следующие свойства.

Отменяемый

Тип данных: boolean
Тип доступа: только для чтения

Указывает, можно ли отменить задание. Значение этого свойства не гарантирует успешного выполнения запроса на отмену задания.

Caption

Тип данных: string
Тип доступа: только для чтения

Краткое описание объекта. Это свойство наследуется от CIM_ManagedElement.

Ребенка

Тип данных: string
Тип доступа: только для чтения

При сбое асинхронной операции это свойство содержит полный путь к дочернему элементу виртуального жесткого диска, затронутого этой операцией.

CommunicationStatus

Тип данных: uint16
Тип доступа: только для чтения

Указывает на способность инструментирования взаимодействовать с базовым управляемым элементом. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

DeleteOnCompletion

Тип данных: boolean
Тип доступа: только для чтения

Указывает, следует ли автоматически удалять задание после завершения. Это свойство наследуется от CIM_Job.

Описание

Тип данных: string
Тип доступа: только для чтения

Описание объекта. Это свойство наследуется от CIM_ManagedElement.

DetailedStatus

Тип данных: uint16
Тип доступа: только для чтения

Дополняет свойство PrimaryStatus дополнительными сведениями о состоянии. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

ElapsedTime

Тип данных: datetime
Тип доступа: только для чтения

Продолжительность выполнения задания. Это свойство наследуется от CIM_Job.

ElementName

Тип данных: string
Тип доступа: только для чтения

Отображаемое имя объекта. Это свойство наследуется от CIM_ManagedElement.

ErrorCode

Тип данных: uint16
Тип доступа: только для чтения

Код ошибки конкретного поставщика. Значение должно быть равно нулю, если задание выполнено без ошибок. Это свойство наследуется от CIM_Job.

ErrorDescription

Тип данных: string
Тип доступа: только для чтения

Строка, содержащая описание ошибки поставщика. Это свойство наследуется от CIM_Job.

ErrorSummaryDescription

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: ModelCorrespondence ("CIM_Job. ErrorCode")

Сводное описание ошибки, если она имеется. Это свойство наследуется от CIM_Job.

HealthState

Тип данных: uint16
Тип доступа: только для чтения

Текущая работоспособность элемента. Этот атрибут выражает работоспособность данного элемента, но не обязательно его подкомпонентов. Возможные значения: от 0 до 30, где 5 означает, что элемент полностью работоспособен, а 30 означает, что элемент полностью нефункциональный. Это свойство наследуется от CIM_ManagedSystemElement и всегда имеет значение 5.

InstallDate

Тип данных: datetime
Тип доступа: только для чтения

Дата и время создания конфигурации виртуальной машины. Это свойство наследуется от CIM_ManagedSystemElement.

InstanceID

Тип данных: string
Тип доступа: только для чтения

Уникально идентифицирует экземпляр этого класса. Это свойство наследуется от CIM_ManagedElement.

JobCompletionStatusCode

Тип данных: UINT32
Тип доступа: только для чтения

Код HRESULT , описывающий состояние завершения асинхронной операции.

JobRunTimes

Тип данных: uint32
Тип доступа: только для чтения

Количество запусков задания. Значение 1 указывает, что задание не повторяется, а любое ненулевое значение указывает ограничение на количество повторений задания. Ноль означает, что количество операций обработки задания не ограничено, но оно будет завершено либо после достижения значения UntilTime , либо после завершения задания вручную. Это свойство наследуется от CIM_Job.

JobState

Тип данных: uint16
Тип доступа: только для чтения

Рабочее состояние задания. Он также может указывать на переходы между этими состояниями, например 6 (завершение работы) и 3 (начало). Это свойство наследуется от CIM_ConcreteJob.

Значение	Значение
Создать 2	Задание никогда не запускалось.
Запуск 3	Задание переходит из состояний "Новый", "Приостановлено" или "Служба" в состояние "Выполняется".
Выполнение 4	Задание выполняется.
Приостановлена 5	Задание остановлено, но его можно легко перезапустить.
Завершает работу 6	Задание переходит в состояние "Завершено", "Завершено" или "Завершено".
Завершено 7	Задание выполнено в обычном режиме.
Завершен 8	Задание было остановлено запросом на изменение состояния "Terminate". Задание и все его базовые процессы завершены и могут быть перезапущены только как новое задание. Требование перезапускать задание только как новое задание зависит от конкретного задания.
Убил 9	Задание было остановлено запросом на изменение состояния Kill. Базовые процессы могут по-прежнему выполняться, и для освобождения ресурсов может потребоваться очистка.
Exception 10	Задание находится в ненормальном состоянии, которое может свидетельствовать об ошибке. Фактическое состояние задания может быть доступно через объекты, относящиеся к заданию.
Служба 11	Задание находится в состоянии конкретного поставщика, которое поддерживает обнаружение или разрешение проблем или и то, и другое.
Зарезервировано DMTF 12 32767	Зарезервировано.
Зарезервировано поставщиком 32768 65535	Зарезервировано.

JobStatus

Тип данных: string
Тип доступа: только для чтения

Строка, представляющая состояние задания. Это свойство наследуется от CIM_Job.

JobType

Тип данных: uint16
Тип доступа: только для чтения

Тип асинхронной операции, отслеживаемой этим экземпляром Msvm_StorageJob.

Неизвестно (0)

Создание виртуального жесткого диска (1)

Создание образа виртуального жесткого диска (VHD).

Создание гибких дисков (2)

Создание образа виртуальной дискеты (VFD).

Сжатие (3)

Сжатие размера образа VHD.

Расширение (4)

Расширение размера образа VHD.

Слияние (5)

Объединение нескольких образов VHD в один образ.

Преобразование (6)

Преобразование типа образа виртуального жесткого диска.

Подключение замыкания на себя (7)

Подключение виртуального жесткого диска к родительскому разделу

Получение сведений о виртуальном жестком диске (8)

Подключение виртуального жесткого диска к операционной системе управления.

Проверка образа VHD (9)

LocalOrUtcTime

Тип данных: uint16
Тип доступа: только для чтения

Указывает, представляет ли время, представленное в свойствах RunStartInterval и UntilTime , локальное время или время в формате UTC. Это свойство наследуется от CIM_Job.

Местное время (1)
Время UTC (2)

имя;

Тип данных: string
Тип доступа: только для чтения

Метка, по которой известен объект. Это свойство наследуется от CIM_ManagedSystemElement.

Уведомление

Тип данных: string
Тип доступа: только для чтения

Пользователь, который получает уведомление о завершении задания или сбое. Это свойство наследуется от CIM_Job.

OperatingStatus

Тип данных: uint16
Тип доступа: только для чтения

Предоставляет сведения о текущем состоянии для рабочего состояния элемента и может использоваться для предоставления дополнительных сведений о значении свойства EnabledState . Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

OperationalStatus

Тип данных: массив uint16
Тип доступа: только для чтения

Текущие состояния объекта. Это свойство наследуется от CIM_ManagedSystemElement.

OtherRecoveryAction

Тип данных: string
Тип доступа: только для чтения

Строка, описывающая действие восстановления, если свойство RecoveryAction экземпляра равно 1 (Другое). Это свойство наследуется от CIM_Job.

Владелец

Тип данных: string
Тип доступа: только для чтения

Пользователь, отправивший задание. Это свойство наследуется от CIM_Job.

Parent

Тип данных: string
Тип доступа: только для чтения

При сбое асинхронной операции это свойство содержит путь к файлу родительского диска виртуального жесткого диска, на который влияет эта операция.

PercentComplete

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MinValue ( 0 ), MaxValue ( 100 ), Единицы ( "Процент" )

Процент завершения задания. Это свойство наследуется от CIM_Job.

PrimaryStatus

Тип данных: uint16
Тип доступа: только для чтения

Предоставляет сведения о состоянии высокого уровня. Это свойство следует использовать вместе со свойством DetailedStatus , чтобы обеспечить высокий уровень и подробное состояние работоспособности элемента и его подкомпонентов. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Приоритет

Тип данных: uint32
Тип доступа: только для чтения

Важность выполнения задания. Это свойство наследуется от CIM_Job.

RecoveryAction

Тип данных: uint16
Тип доступа: только для чтения

Описывает действие восстановления, выполняемое для задания, которое не выполнено успешно. Это свойство наследуется от CIM_Job.

Неизвестно (0)
Другое (1)
Не продолжать (2)
Продолжить со следующим заданием (3)
Повторное выполнение задания (4)
Запуск задания восстановления (5 )

RunDay

Тип данных: sint8
Тип доступа: только для чтения
Квалификаторы: MinValue ( -31 ), MaxValue ( 31 )

День месяца, в который должно быть обработано задание. Существуют различные интерпретации этого свойства в зависимости от значения RunDayOfWeek.

Если Значение RunDayOfWeek равно 0, а Значение RunDay положительное, RunDay определяет день месяца, в который обрабатывается задание. Например, если RunDayOfWeek имеет значение 0, а RunDay — 12, задание будет обработано в^12-й день месяца.

Если Значение RunDayOfWeek равно 0, а Значение RunDay отрицательное, RunDay определяет количество дней до последнего дня месяца, в котором обрабатывается задание. 1 обозначает последний день месяца, 2 — один день перед последним днем месяца и т. д. Например, если RunDayOfWeek имеет значение 0, а RunDay — 1, задание будет обработано в последний день месяца.

Если значение RunDayOfWeek не равно 0, RunDayOfWeek — это день недели, в течение который будет обрабатываться задание относительно RunDay. Например, если Значение RunDay равно 15, а Значение RunDayOfWeek равно 7 (+суббота), задание будет обработано в первую субботу 15-го дня месяца или после него. Если Значение RunDay равно 20, а Значение RunDayOfWeek — 7 (суббота), задание будет обработано в первую субботу 20-го дня месяца или раньше. Если RunDay имеет значение 1, а RunDayOfWeek — 1 (воскресенье), задание будет обработано в последнее воскресенье месяца.

Это свойство наследуется от CIM_Job.

RunDayOfWeek

Тип данных: sint8
Тип доступа: только для чтения

Положительное или отрицательное целое число, используемое вместе с RunDay для обозначения дня недели или месяца, в который обрабатывается задание. Дополнительные сведения см. в описании свойства RunDay . Это свойство наследуется от CIM_Job.

-Суббота ( 7)
-Пятница ( 6)
-четверг ( 5)
-среда ( 4)
-Вторник ( 3)
-Понедельник ( 2)
-Воскресенье ( 1)
ExactDayOfMonth (0)
Воскресенье (1)
Понедельник (2)
Вторник (3)
Среда (4)
Четверг (5)
Пятница (6)
Суббота (7 )

RunMonth

Тип данных: uint8
Тип доступа: только для чтения

Месяц, в течение которого должно быть обработано задание. Это свойство наследуется от CIM_Job.

Январь (0)
Февраль (1)
Март (2)
Апрель (3)
Май (4)
Июнь (5)
Июль (6)
Август (7)
Сентябрь (8)
Октябрь (9)
Ноябрь (10)
Декабрь (11 )

RunStartInterval

Тип данных: datetime
Тип доступа: только для чтения

Интервал времени после полуночи, когда задание должно быть обработано. Это свойство наследуется от CIM_Job.

ScheduledStartTime

Тип данных: datetime
Тип доступа: только для чтения

Это свойство наследуется от CIM_Job.

StartTime

Тип данных: datetime
Тип доступа: только для чтения

Время начала работы. Это свойство наследуется от CIM_Job.

Состояние

Тип данных: string
Тип доступа: только для чтения

Это свойство наследуется от CIM_ManagedSystemElement, но не используется.

Описания состояния

Тип данных: строковый массив
Тип доступа: только для чтения

Строки, описывающие различные значения массива OperationalStatus . Это свойство наследуется от CIM_ManagedSystemElement.

TimeBeforeRemoval

Тип данных: datetime
Тип доступа: только для чтения

Количество времени (в минутах), в течение которого задание сохраняется после завершения выполнения( успешно или неудачно в этом выполнении). Задание должно существовать в течение некоторого периода времени независимо от значения свойства DeleteOnCompletion . Значение по умолчанию — пять минут. Это свойство наследуется от CIM_ConcreteJob и всегда имеет значение 000000000000500.000000:000.

TimeOfLastStateChange

Тип данных: datetime
Тип доступа: только для чтения

Время последнего изменения состояния виртуальной машины. Это свойство наследуется от CIM_EnabledLogicalElement.

TimeSubmitted

Тип данных: datetime
Тип доступа: только для чтения

Время отправки задания. Это свойство наследуется от CIM_Job.

UntilTime

Тип данных: datetime
Тип доступа: только для чтения

Время, когда задание является недопустимым или должно быть остановлено. Это свойство наследуется от CIM_Job.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Пространство имен	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

См. также раздел

CIM_ConcreteJob
CIM_ConcreteJob
Классы хранения

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