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

класс CIM_ServiceAccessPoint

  • Статья

CIM_ServiceAccessPoint представляет возможность использования или вызова службы. Точки доступа представляют, что служба доступна для других сущностей.

Следующий пример синтаксиса — упрощенный MOF-код, который включает все наследуемые свойства.

Синтаксис

[UMLPackagePath("CIM::Core::Service"), Abstract, Version("2.10.0"), AMENDMENT]
class CIM_ServiceAccessPoint : CIM_EnabledLogicalElement
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   TransitioningToState = 12;
  uint16   AvailableRequestedStates[];
  string   Name;
  string   SystemCreationClassName;
  string   SystemName;
  string   CreationClassName;
};

Участники

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

Методы

Класс CIM_ServiceAccessPoint имеет эти методы.

Метод Description
RequestStateChange Запрашивает изменение состояния элемента на значение, указанное в параметре RequestsState . При изменении запрошенного состояния состояние включено и запрошенное состояние элемента будет одинаковым. Вызов метода RequestChangeState несколько раз может привести к перезаписи или потере более ранних запросов. Если возвращается значение 0, задача успешно завершена и использование CIM_ConcreteJob не требуется. Если возвращается значение 4096 (0x1000), задача займет некоторое время, CIM_ConcreteJob будет создана, а ее ссылка возвращается в задании выходного параметра. Любой другой код возврата указывает на условие ошибки.
Этот метод наследуется от CIM_EnabledLogicalElement.

Свойства

Класс CIM_ServiceAccessPoint имеет эти свойства.

AvailableRequestedStates

Тип данных: массив uint16

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

Квалификаторы: ModelCorrespondence ("CIM_EnabledLogicalElement.RequestStateChange", "CIM_EnabledLogicalElementCapabilities.RequestStatesSupported")

AvailableRequestedStates указывает возможные значения параметра RequestState метода RequestStateChange, используемого для инициирования изменения состояния. Перечисленные значения должны быть подмножеством значений, содержащихся в свойстве RequestedStatesSupported связанного экземпляра CIM_EnabledLogicalElementCapabilities, где выбранные значения являются функцией текущего состояния CIM_EnabledLogicalElement. Это свойство может быть не null, если реализация может объявлять набор возможных значений как функцию текущего состояния. Это свойство должно иметь значение NULL, если реализация не может определить набор возможных значений в качестве функции текущего состояния.

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

Включено (2)

Отключено (3)

Завершение работы (4)

Автономный (6)

Тест (7)

Отложить (8)

Quiesce (9)

Перезагрузка (10)

Сброс (11)

Зарезервировано DMTF (12 65535)

Заголовок

Тип данных: строка

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

Квалификаторы: MaxLen (64)

Содержит короткое текстовое описание объекта.

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

CommunicationStatus

Тип данных: uint16

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

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

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

Значения Значение
Unknown
0
 Указывает, что инструментирование в настоящее время не может сообщать о свойстве CommunicationStatus .
Недоступно
1
 Указывает, что инструментирование может сообщать об этом свойстве, но намеренно не предназначено для этого элемента.
Связь ОК
2
 Указывает только то, что обмен данными устанавливается с элементом.
Потерянный обмен данными
3
 Указывает, что элемент был связан в прошлом, но в настоящее время недоступен.
Нет контакта
4
 Указывает, что инструментирование содержит контактные данные для этого элемента, но никогда не могло взаимодействовать с ним.
Зарезервированный DMTF
5 32767
 Зарезервировано.
Зарезервировано поставщиком
32768 = значение
Зарезервировано.

CreationClassName

Тип данных: строка

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

Квалификаторы: ключ, MaxLen (256)

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

Description

Тип данных: строка

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

Предоставляет текстовое описание объекта.

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

DetailedStatus

Тип данных: uint16

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

Квалификаторы: ModelCorrespondence ("CIM_EnabledLogicalElement.PrimaryStatus", "CIM_ManagedSystemElement.HealthState")

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

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

Значения Значение
Недоступно
0
 Указывает, что инструментирование может сообщать об этом свойстве, но намеренно не сообщает об этом элементе.
Нет дополнительных сведений
1
 Указывает, что к свойству PrimaryStatus не нужно добавлять никаких сведений, например если для primaryStatus задано значение "ОК".
Ударный
2
 Указывает, что функции элемента, но требуют внимания. Перегрузка и перегрев являются примерами состояний "Подчеркнутый".
Прогнозный сбой
3
 Указывает, что элемент работает номинально, но прогнозирует сбой в ближайшем будущем.
Невосстановимая ошибка
4
 Указывает, что этот элемент находится в состоянии ошибки, требующей вмешательства человека.
Поддержка сущности в ошибке
5
 Указывает, что элемент, от которого зависит этот элемент, находится в ошибке. Этот элемент может быть ОК , но не может функционировать из-за состояния зависимого элемента. Примером является сетевая служба или конечная точка, которая не может функционировать из-за проблем с сетью нижнего уровня.
Зарезервированный DMTF
6 32767
 Зарезервировано.
Зарезервировано поставщиком
32768 = значение
Зарезервировано.

ElementName

Тип данных: строка

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

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

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

EnabledDefault

Тип данных: uint16

Тип доступа: чтение и запись

Перечисленное значение, указывающее конфигурацию администратора по умолчанию или начальной конфигурации для включенного состояния элемента. По умолчанию элемент имеет значение Enabled (value=2).

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

Включено (2)

Отключено (3)

Неприменимо (5)

Включен, но автономный (6)

Нет по умолчанию (7)

Quiesce (9)

Зарезервированный DMTF (10 32767)

Зарезервированный поставщик (32768 65535)

EnabledState

Тип данных: uint16

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

Квалификаторы: ModelCorrespondence ("CIM_EnabledLogicalElement.OtherEnabledState")

Указывает включенные и отключенные состояния элемента. Он также может указывать на переходы между этими запрошенными состояниями. Например, завершение работы (value=4) и запуск (value=10) являются временными состояниями между включенными и отключенными.

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

Значение Значение
Unknown
0
Другое
1
Включено
2
 Элемент является или может выполнять команды, будет обрабатывать любые команды в очереди и очереди новых запросов.
Отключен
3
 Элемент не будет выполнять команды и будет удалять новые запросы.
Завершает работу
4
 Элемент находится в процессе выхода в состояние "Отключено".
Неприменимо
5
 Элемент не поддерживает включение или отключение.
Включен, но автономный
6
 Элемент может выполнять команды и удалять новые запросы.
В тесте
7
 Элемент находится в тестовом состоянии.
Замедленный
8
 Элемент может выполнять команды, но будет очередью новых запросов.
Замораживание
9
 Элемент включен, но в ограниченном режиме. Поведение элемента аналогично состоянию Enabled (2), но обрабатывает только ограниченный набор команд. Все остальные запросы помещаются в очередь.
Запуск
10
 Элемент находится в процессе входа в состояние "Включено" (2). Новые запросы помещаются в очередь.
Зарезервированный DMTF
11 32767
 Зарезервировано.
Зарезервировано поставщиком
32768 65535
 Зарезервировано.

HealthState

Тип данных: uint16

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

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

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

Значения Значение
Unknown
0
 Реализация в настоящее время не может сообщать о HealthState .
OK
5
 Элемент полностью функциональный и работает в обычных операционных параметрах и без ошибок.
Понижение или предупреждение
10
 Элемент находится в рабочем порядке и предоставляется все функциональные возможности. Однако элемент не работает до лучших своих возможностей. Например, элемент может не работать в оптимальной производительности или может сообщать об ошибках, которые можно восстановить.
Незначительный сбой
15
 Все функциональные возможности доступны, но некоторые из этих функций могут быть понижены.
Основной сбой
20
 Элемент завершается ошибкой. Возможно, некоторые или все функциональные возможности этого компонента ухудшаются или не работают.
Критический сбой
25
 Элемент нефункциональный, и восстановление может оказаться невозможным.
Невосстановимая ошибка
30
 Элемент полностью завершился сбоем, и восстановление невозможно. Все функции, предоставляемые этим элементом, были потеряны.
Зарезервированный DMTF
31 = значение
DMTF зарезервирована неиспользуемая часть континуума для дополнительных значений HealthStates в будущем.

InstallDate

Тип данных: datetime

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

Указывает, когда объект был установлен. Отсутствие значения не указывает, что объект не установлен.

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

InstanceID

Тип данных: строка

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

Уникально и непрозрачно идентифицирует экземпляр этого класса в пределах области содержащего пространства имен.

[! Важно]Чтобы обеспечить уникальность в пространстве имен, значение InstanceID должно быть создано в следующем шаблоне:

OrgID:LocalID

OrgID должен содержать авторские права, товарные знаки или другое уникальное имя, принадлежащее бизнес-сущности, определяющей ЭкземплярID, или быть зарегистрированным идентификатором, назначенным признанным глобальным органом. Это похоже на структуру имен классов Schema. Кроме того, чтобы обеспечить уникальность первой двоеточия в InstanceID , должна быть между OrgID иLocalID. Для этого OrgID не должен содержать двоеточие (":").

LocalID выбирается бизнес-сущностью и не следует повторно использовать для идентификации различных базовых реальных элементов.

Если предыдущий шаблон не используется, определяющая сущность должна убедиться, что результирующий идентификатор InstanceID не используется повторно для любого экземпляра, созданного этим или другими поставщиками для этого пространства имен.

Для определенных экземпляров группы задач распределенного управления (DMTF) шаблон должен использоваться с идентификатором orgID, заданным для CIM.

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

Имя

Тип данных: строка

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

Квалификаторы: MaxLen (256), ключ, переопределение ("Имя")

Уникально идентифицирует точку доступа службы (SAP) и указывает на функциональность, управляемую. Эта функция подробно описана в свойстве Description объекта.

OperatingStatus

Тип данных: uint16

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

Квалификаторы: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

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

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

Значение Значение
Unknown
0
 Указывает, что инструментирование не может сообщать о свойстве OperatingStatus в настоящее время.
Недоступно
1
 Указывает, что инструментирование может сообщать об этом свойстве, но намеренно не сообщает об этом элементе.
Обслуживание
2
 Указывает, что элемент находится в процессе настройки, обслуживания, очистки или администрирования.
Запуск
3
 Указывает, что элемент инициализирован.
Остановлено.
4
 Указывает, что элемент преобразуется в упорядоченную остановку.
Остановлено
5
 Указывает, что элемент намеренно остановлен.
Недоношенный
6
 Указывает, что элемент остановлен неожиданным образом.
Бездействует
7
 Указывает, что элемент неактивен или неактивен.
Завершено
8
 Указывает, что элемент завершил свою операцию. Рекомендуется использовать значение свойства PrimaryStatus для ОК, Error или Degraded , чтобы указать успешность или сбой операции.
Перенос
9
 Указывает, что элемент перемещается между элементами узла.
Эмигрировать
10
 Указывает, что элемент перемещается от элемента узла.
Иммиграции
11
 Указывает, что элемент перемещается в новый элемент узла.
Создание моментальных снимков
12
 Указывает, что создается копия моментального снимка элемента.
Завершает работу
13
 Указывает, что элемент привозится к резкой остановке.
В тесте
14
 Указывает, что элемент выполняет тестовые функции.
Переход
15
 Указывает, что элемент находится между состояниями и не полностью доступен в любом состоянии. Используйте другое значение, указывающее более конкретный переход, если он доступен.
В службе
16
 Указывает, что элемент находится в службе и эксплуатации.
Зарезервированный DMTF
17 32767
 Зарезервировано.
Зарезервировано поставщиком
32768 = значение
Зарезервировано.

OperationsStatus

Тип данных: массив uint16

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

Квалификаторы: ArrayType ("Indexed"), ModelCorrespondence ("CIM_ManagedSystemElement.StatusDescriptions")

Содержит индикаторы текущего состояния элемента. Первое значение OperationsStatus должно содержать основное состояние элемента.

Примечание.

OperationsStatus заменяет нерекомендуемое свойство Status . Из-за широкого использования существующего свойства Status в приложениях управления корпорация Майкрософт настоятельно рекомендует поставщикам или инструментированию предоставлять свойства Status и OperationsStatus . При инструментировании состояние (так как оно однозначно) также должно предоставлять основное состояние элемента.

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

Значения Значение
Unknown
0
 Указывает, что реализация не может сообщать о OperationsStatus в настоящее время.
Другое
1
 Указывает неопределенное состояние.
OK
2
 Указывает полную функциональность без ошибок.
Деградация
3
 Указывает, что элемент работает и предоставляется все функциональные возможности. Однако элемент не работает до лучших своих возможностей. Например, элемент может не работать в оптимальной производительности или может сообщать об ошибках, которые можно восстановить.
Ударный
4
 Указывает, что элемент работает, но требует внимания. Перегрузка и перегрев являются примерами состояний "Подчеркнутый".
Прогнозный сбой
5
 Указывает, что элемент работает номинально, но прогнозирует сбой в ближайшем будущем.
Ошибка
6
 Указывает, что произошла ошибка.
Невосстановимая ошибка
7
 Произошла неустранимая ошибка.
Запуск
8
 Задание начинается.
Остановлено.
9
 Задание останавливается.
Остановлено
10
 Элемент был намеренно остановлен.
В службе
11
 Указывает, что элемент настраивается, поддерживается, очищается или администрирование в противном случае.
Нет контакта
12
 Указывает, что система мониторинга знает об этом элементе, но никогда не могла установить связь с ней.
Потерянный обмен данными
13
 Указывает, что задание, как известно, существует и успешно подключено к прошлому, но в настоящее время недоступно.
Недоношенный
14
 Указывает, что задание остановлено неожиданным образом. Может потребоваться обновить состояние и конфигурацию задания.
Бездействует
15
 Указывает, что задание неактивно.
Поддержка сущности в ошибке
16
 Указывает, что элемент, от которого зависит это задание, находится в ошибке. Этот элемент может быть ОК , но не может функционировать из-за состояния зависимого элемента. Примером является сетевая служба или конечная точка, которая не может функционировать из-за проблем с сетью нижнего уровня.
Завершено
17
 Указывает, что задание завершило свою операцию. Это значение должно сочетаться с "ОК", "Ошибка"или "Понижение", чтобы клиент смог определить, завершена ли завершенная операция ОК (передана), завершена с ошибкой (сбой) или завершена с пониженным состоянием (операция завершена, но она не завершилась или не сообщила об ошибке).
Power Mode
18
 "Режим Power Mode" указывает, что элемент содержит дополнительные сведения о модели питания, содержащиеся в связанной ассоциации PowerManagementService.
Зарезервированный DMTF
19 32767
 DMTF резервировал эту часть диапазона для дополнительных значений OperationsStatus в будущем.
Зарезервировано поставщиком
32768 65535
 Корпорация Майкрософт резервировала неиспользуемую часть диапазона для дополнительных значений OperationsStatus в будущем.

OtherEnabledState

Тип данных: строка

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

Квалификаторы: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

Строка, описывающая включенное или отключенное состояние элемента, если для свойства EnabledState задано значение 1 ("Другое"). Это свойство должно иметь значение NULL, если EnabledState имеет любое значение, отличное от 1.

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

PrimaryStatus

Тип данных: uint16

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

Квалификаторы: ModelCorrespondence ("CIM_ManagedSystemElement.DetailedStatus", "CIM_ManagedSystemElement.HealthState")

Указывает значение состояния высокого уровня.

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

Возможные значения.

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

ОК (1)

Деградированные (2)

Ошибка (3)

Зарезервированный DMTF (4 32767)

Зарезервировано поставщиком (32768 = значение )

Запрошенная статистика

Тип данных: uint16

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

Квалификаторы: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

RequestedState — это целочисленное перечисление, указывающее последнее запрошенное или требуемое состояние элемента. Фактическое состояние элемента представлено в EnabledState. Это свойство предоставляется для сравнения последних запрошенных и текущих включенных или отключенных состояний. Обратите внимание, что если параметр EnabledState имеет значение 5 ("Неприменимо"), то это свойство не имеет смысла. По умолчанию элемент RequestedState имеет значение 5 ("Нет изменения"). Описание свойства EnabledState см. в описании значений перечисления RequestedState. Следует отметить, что в RequestedState есть два новых значения, которые создаются на основе состояний EnabledState. Это "Перезагрузка" (10) и "Сброс" (11). Перезагрузка относится к выполнению действия "Завершение работы", а затем переход к состоянию "Включено". Сброс указывает, что элемент сначала отключен, а затем "Включено". Следует также отметить различие между запросом "Завершение работы" и "Отключено". Завершение работы запрашивает упорядоченный переход в отключенное состояние и может включать удаление питания, чтобы полностью удалить любое существующее состояние. Состояние "Отключено" запрашивает немедленное отключение элемента, поэтому оно не будет выполнять или принимать какие-либо команды или запросы на обработку. Это свойство задается в результате вызова метода (например, StartService или StopService на CIM_Service), или может быть переопределено и определено как WRITEable в подклассе. Подход к методу считается превосходным свойством WRITEable, так как он позволяет явно вызвать операцию и возврат результирующий код. Конкретный экземпляр CIM_EnabledLogicalElement может не поддерживать RequestStateChange. Если это происходит, используется значение 12 ("Неприменимо").

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

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

Включено (2)

Отключено (3)

Завершение работы (4)

Нет изменений (5)

Автономный (6)

Тест (7)

Отложено (8)

Quiesce (9)

Перезагрузка (10)

Сброс (11)

Неприменимо (12)

Зарезервированный DMTF (13 32767)

Зарезервированный поставщик (32768 65535)

Состояние

Тип данных: строка

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

Квалификаторы: устаревшие ("CIM_ManagedSystemElement.OperationalStatus"), MaxLen (10)

Содержит строку, указывающую основное состояние объекта.

Примечание.

Это свойство устарело и заменено свойством OperationsStatus . Если вы решили использовать свойство Status для обратной совместимости, оно должно быть вторичным для свойства OperationsStatus.

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

Возможные значения.

("ОК")

("Ошибка")

("Понижено")

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

("Предварительный сбой")

("Начало")

("Остановка")

("Служба")

("Подчеркнул")

("NonRecover")

("Нет контакта")

("Потерянный комм")

("Остановлено")

StatusDescriptions

Тип данных: массив строк

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

Квалификаторы: ArrayType ("Indexed"), ModelCorrespondence ("CIM_ManagedSystemElement.OperationalStatus")

Указывает описания соответствующих значений в массиве OperationsStatus . Например, если элемент в свойстве OperationsStatus содержит значение "Остановка", элемент с тем же индексом массива в этом свойстве может содержать объяснение причины остановки объекта.

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

SystemCreationClassName

Тип данных: строка

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

Квалификаторы: ключ, MaxLen (256), распространение ("CIM_System.CreationClassName")

Свойство CreationClassName системы области.

SystemName

Тип данных: строка

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

Квалификаторы: ключ, MaxLen (256), распространение ("CIM_System.Name")

Имя области системы.

TimeOfLastStateChange

Тип данных: datetime

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

Дата или время последнего изменения состояния элемента. Если состояние элемента не изменилось и это свойство заполняется, то оно должно быть задано в значение 0 интервала. Если было запрошено изменение состояния, но отклонено или еще не обработано, свойство не должно быть обновлено.

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

TransitioningToState

Тип данных: uint16

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

Квалификаторы: ModelCorrespondence ("CIM_EnabledLogicalElement.RequestStateChange", "CIM_EnabledLogicalElement.RequestState", "CIM_EnabledLogicalElement.EnabledState")

TransitioningToState указывает целевое состояние, в которое выполняется переход экземпляра.

Значение 5 "Нет изменений" должно указывать на то, что переход не выполняется. Значение 12 "Неприменимо" указывает, что реализация не поддерживает текущие переходы.

Значение, отличное от 5 или 12, должно определять состояние, в которое элемент находится в процессе перехода.

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

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

Включено (2)

Отключено (3)

Завершение работы (4)

Нет изменений (5)

Автономный (6)

Тест (7)

Отложить (8)

Quiesce (9)

Перезагрузка (10)

Сброс (11)

Неприменимо (12)

Зарезервировано DMTF (13 65535)

Требования
Минимальная версия клиента
 Windows 8
Минимальная версия сервера
 Windows Server 2012
Пространство имен
 Root\standardcimv2
MOF
NetTCPIP.mof
DLL-библиотеки
NetTCPIP.dll

См. также

CIM_EnabledLogicalElement