класс 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 |
|
Библиотека dll |
|