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


класс CIM_NetworkPipe

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

Этот объект отличается от связи между конечными точками (CIM_ActiveConnection), так как акцент не на конечных точках, а на управлении самой каналом — его состояние, конфигурация и т. д. Сетевые каналы определяются в контексте сети и представляют собой "передачу информации". . . между. . . endpoints'. Эти понятия соответствуют определению объекта Pipe в спецификации M.3100 ITU.

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

Синтаксис

[UMLPackagePath("CIM::Network::Pipes"), Version("2.19.0"), AMENDMENT]
class CIM_NetworkPipe : CIM_EnabledLogicalElement
{
  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;
};

Члены

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

Методика

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

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

Свойства

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

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

Тип данных: uint16

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

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

неизвестные (0)

Нет Lower-Level композиции (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.

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

описание

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

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

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

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

DetailedStatus

Тип данных: uint16

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

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

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

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

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

направление

Тип данных: uint16

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

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

неизвестные (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"), Override ("EnabledState")

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

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

HealthState

Тип данных: uint16

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

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

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

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

InstallDate

Тип данных: datetime

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

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

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

InstanceID

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

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

Квалификаторы: ключ , переопределение ("InstanceID")

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

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

OrgID:LocalID

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

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

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

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

имени

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

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

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

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

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

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

OperatingStatus

Тип данных: uint16

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

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

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

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

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

OperationsStatus

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

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

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

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

Заметка

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

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

Значения Значение
Неизвестное
0
Указывает, что реализация не может сообщать о OperationsStatus в настоящее время.
Другие
1
Указывает неопределенное состояние.
OK
2
Указывает полную функциональность без ошибок.
пониженный
3
Указывает, что элемент работает и предоставляется все функциональные возможности. Однако элемент не работает до лучших своих возможностей. Например, элемент может не работать в оптимальной производительности или может сообщать об ошибках, которые можно восстановить.
подчеркнул
4
Указывает, что элемент работает, но требует внимания. Перегрузка и перегрев являются примерами состояний Подчеркнул.
прогнозный сбой
5
Указывает, что элемент работает номинально, но прогнозирует сбой в ближайшем будущем.
ошибка
6
Указывает, что произошла ошибка.
невосстановлимая ошибка
7
Произошла неустранимая ошибка.
запуска
8
Задание начинается.
остановка
9
Задание останавливается.
остановлено
10
Элемент был намеренно остановлен.
в службе
11
Указывает, что элемент настраивается, поддерживается, очищается или администрирование в противном случае.
без контакта
12
Указывает, что система мониторинга знает об этом элементе, но никогда не могла установить связь с ней.
потерянной связи
13
Указывает, что задание, как известно, существует и успешно подключено к прошлому, но в настоящее время недоступно.
прерванный
14
Указывает, что задание остановлено неожиданным образом. Может потребоваться обновить состояние и конфигурацию задания.
Dormant
15
Указывает, что задание неактивно.
поддержки сущности в ошибки
16
Указывает, что элемент, от которого зависит это задание, находится в ошибке. Этот элемент может быть OK, но не может функционировать из-за состояния зависимого элемента. Примером является сетевая служба или конечная точка, которая не может функционировать из-за проблем с сетью нижнего уровня.
завершенные
17
Указывает, что задание завершило свою операцию. Это значение должно сочетаться с OK, errorError, или понижение, чтобы клиент смог определить, завершена ли операция завершена с ОК (передана), завершена ошибка (сбой) или завершена пониженным (операция завершена, но она не завершилась ОК или не сообщила об ошибке).
режим питания
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)

OK (1)

пониженный (2)

ошибка (3)

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

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

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

Тип данных: uint16

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

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

RequestedState — это целочисленное перечисление, указывающее последнее запрошенное или требуемое состояние элемента независимо от механизма, с помощью которого он был запрошен. Фактическое состояние элемента представлено в EnabledState. Это свойство предоставляется для сравнения последних запрошенных и текущих включенных или отключенных состояний. Обратите внимание, что если параметр EnabledState имеет значение 5 ("Неприменимо"), то это свойство не имеет смысла. Описание свойства EnabledState см. в описании значений перечисления RequestedState.

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

См. также

CIM_EnabledLogicalElement