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

класс MSFT_NetTransport Подключение ion

  • Статья

Представляет транспортное подключение для поставщика WMI microsoft TCP/IP версии 2.

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

Синтаксис

[UMLPackagePath("CIM::Network::Pipes"), ClassVersion("1.0.0"), dynamic, provider("nettcpip"), AMENDMENT]
class MSFT_NetTransportConnection : CIM_NetworkPipe
{
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   OtherEnabledState;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   TransitioningToState = 12;
  uint16   AvailableRequestedStates[];
  string   InstanceID;
  uint16   EnabledState;
  uint16   RequestedState = 5;
  uint16   Directionality;
  uint16   AggregationBehavior;
  string   LocalAddress;
  uint16   LocalPort;
};

Участники

Класс MSFT_NetTransport Подключение ion имеет следующие типы элементов:

Методы

Класс MSFT_NetTransport Подключение ion имеет эти методы.

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

Свойства

Класс MSFT_NetTransport Подключение ion имеет эти свойства.

АгрегированиеBehavior

Тип данных: uint16

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

Указывает, состоит ли канал из каналов нижнего уровня и, если да, то как эти каналы нижнего уровня агрегируются (параллельно или в последовательности). Конкретные экземпляры NetworkPipe, объединенные, описываются с помощью ассоциации NetworkPipeComposition.

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

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

Нет композиции нижнего уровня (2)

Объединенный параллельно (3)

Объединенная последовательность (4)

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.

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

Description

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

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

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

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

DetailedStatus

Тип данных: uint16

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

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

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

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

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

Направленность

Тип данных: uint16

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

Указывает направление канала. Для однонаправленных каналов источник и приемник указываются свойством (SourceOrSink) ассоциации EndpointOfNetworkPipe.

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

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

Двунаправленный (2)

Юнинаправленный (3)

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")

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

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

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

HealthState

Тип данных: uint16

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

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

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

Values Значение
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_NetworkPipe.

LocalAddress

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

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

Локальный адрес подключения транспорта.

LocalPort

Тип данных: uint16

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

Локальный порт подключения к транспорту.

Имя

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

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

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

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

[! Совет]
Имя не должно быть уникальным в пространстве имен.

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

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.

Values Значение
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 ("Неприменимо"), то это свойство не имеет смысла. Описание свойства EnabledState см. в описании значений перечисления RequestedState.

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

Значение Значение
Unknown
0
 Последнее запрошенное состояние элемента неизвестно.
Включено
2
Отключен
3
 запрашивает немедленное отключение элемента, таким образом, что он не будет выполнять или принимать какие-либо команды или запросы на обработку.
Отключение
4
 Запрашивает упорядоченный переход в отключенное состояние и может включать удаление питания, чтобы полностью удалить любое существующее состояние.
Нет изменений
5
 Не рекомендуется в соответствии с указанием последнего запрошенного состояния "Неизвестно" (0). Если последнее запрошенное или требуемое состояние неизвестно, Запрошенная Статистика должна иметь значение "Неизвестно" (0), но может иметь значение "Без изменений" (5).
Автономный режим
6
 Элемент был запрошен для перехода на enabled, но offline EnabledState.
Тестирование
7
Отложенные
8
Замораживание
9
Перезагрузка
10
 Относится к выполнению действия "Завершение работы", а затем переход к состоянию "Включено".
Сбросить
11
 Сброс указывает, что элемент сначала отключен, а затем "Включено".
Неприменимо
12
 Знание последней запрошенной статистики не поддерживается для EnabledLogicalElement.
Зарезервированный 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.

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