Стандартные квалификаторы

Все реализации, совместимые с CIM, должны работать со стандартным набором квалификаторов. Все указанные объекты не имеют всех указанных квалификаторов. Как правило, классы расширений предоставляют дополнительные квалификаторы для упрощения инициализации экземпляров классов и других операций с классом.

Поставщик должен применять квалификаторы. Инструментарий WMI не применяет квалификаторы, но использует их только для информирования пользователя о том, как используется свойство.

Примечание

Инструментарий WMI соответствует спецификации CIM 2,5.

Квалификаторы имеют следующие ограничения.

  • Не все стандартные квалификаторы можно использовать вместе.
  • Не все Квалификаторы могут применяться ко всем конструкциям, таким как ассоциация или ссылка. Эти ограничения определены в списке применимо к.
  • Для конкретной конструкции, такой как ассоциация или ссылка, использование юридических квалификаторов может быть дополнительно ограничено, так как некоторые квалификаторы являются взаимоисключающими, а использование одного квалификатора может привести к некоторым ограничениям на значение другого и т. д. Эти правила использования задокументированы.
  • Юридические квалификаторы наследуются сущностями, такими как свойства, методы, экземпляры или подклассы, а не по связям или ссылкам. Например, квалификатор maxlen , применяемый к свойствам, не наследуется ссылками.

Ниже перечислены квалификаторы WMI уровня "Стандартный".

Выделяет

Тип данных: логический

Область применения: классы, ассоциации, указания

Указывает, является ли класс абстрактным и служит только в качестве основы для новых классов. Значение по умолчанию — false. Нельзя создавать экземпляры абстрактных классов. Отсутствие этого квалификатора указывает, что класс не является абстрактным; Таким образом, этот квалификатор необходим для всех абстрактных классов.

Множеств

Тип данных: логический

Область применения: ссылки

Указывает, является ли ссылка родительским компонентом статистической ассоциации. Значение по умолчанию — false.

Использование: квалификаторы статистической обработки и статистической функции используются совместно со статистической обработкой, а функция Aggregate задает родительскую ссылку.

Статистической обработки

Тип данных: логический

Область применения: связи

Указывает, является ли ассоциация агрегатом. Значение по умолчанию — false. Используется со статистическим выражением. Этот квалификатор является обязательным для всех сопоставлений агрегатов.

Псевдоним

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

Область применения: свойства, ссылки, методы

Альтернативное имя для свойства или метода в схеме. Значение по умолчанию — null.

ArrayType

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

Область применения: свойства, параметры

Тип полного массива.

Допустимые значения:

  • контейнер (по умолчанию)
  • индексированные
  • упорядоченного

Использование: Примените этот тип квалификатора только к свойствам и параметрам, которые являются массивами (определяемыми с помощью синтаксиса скобок).

Массив

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

Область применения: свойства, методы, параметры

Сопоставьте значительные позиции, где каждая значимая позиция может быть "on" или "OFF". Каждый бит "на" соответствует соответствующему значению в массиве битвалуес . Наличие нескольких битов "on" указывает несколько одновременных значений в массиве битвалуес . Значение по умолчанию — null.

Дополнительные сведения см. в разделе BitMap и битвалуес.

битвалуес

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

Область применения: свойства, методы, параметры

Преобразование значения битовой координаты в связанную строку. Значение по умолчанию — null.

Дополнительные сведения см. в разделе BitMap и битвалуес.

Конструктор

Тип данных: логический

Область применения: методы

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

Квалификатор конструктора предназначен только для информации и не ожидается, что он действует диспетчером объектов. Диспетчеру объектов не обязательно вызывать методы конструктора при создании объекта. Кроме того, при вызове конструктора диспетчер объектов не должен вызывать методы конструктора, определенные для любого родительского класса исходного класса. Значение по умолчанию — false.

креатеби

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

Область применения: классы

Имя метода, с помощью которого создаются экземпляры этого класса. Значение может быть либо "PutInstance", либо именем другого метода, который создает экземпляры. Значение по умолчанию — null.

Использование: этот квалификатор можно использовать только при наличии квалификатора суппортскреате .

делетеби

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

Область применения: классы

Имя метода, с помощью которого удаляются экземпляры этого класса. Значение может быть либо "DeleteInstance", либо именем другого метода, который удаляет экземпляры. Значение по умолчанию — null.

Использование: этот квалификатор можно использовать только при наличии квалификатора суппортсделете .

Nописание

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

Применимо к: Any

Описание именованного элемента. Значение по умолчанию — null.

Использовал

Тип данных: логический

Область применения: методы

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

Квалификатор деструктора предназначен только для информации и не ожидается, что он действует диспетчером объектов. При удалении экземпляра диспетчер объектов не обязан вызвать метод, имеющий квалификатор деструктора . Кроме того, при вызове деструктора диспетчеру объектов не нужно вызывать методы деструктора, определенные для любого родительского класса исходного класса. Значение по умолчанию — false.

DisplayName

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

Применимо к: Any

Имя, отображаемое в пользовательском интерфейсе, а не фактическое имя элемента. Значение по умолчанию — null.

ембеддединстанце

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

Применимо к: Any

Элемент уточненного строкового типа содержит внедренный экземпляр. Значение квалификатора указывает имя класса CIM в том же пространстве имен, что и класс, которому принадлежит квалифицированный элемент. Внедренный экземпляр — это экземпляр указанного класса, включая экземпляры его подклассов. Значение по умолчанию — null.

Калибр

Тип данных: логический

Применимо к: Any

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

Максимальное значение свойства не может быть больше 2 ^n -1. N может иметь значение 8, 16, 32 или 64 в зависимости от типа данных свойства, к которому применяется этот квалификатор. Значение датчика имеет максимальное значение всякий раз, когда смоделированная информация больше или равна этому максимальному значению. Если сведения, смоделированные в дальнейшем, уменьшится ниже максимального значения, датчик также сокращается. Этот квалификатор применим только к свойствам с типом данных Integer без знака.

Окне

Тип данных: логический

Область применения: параметры

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

В, out

Тип данных: логический

Область применения: параметры

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

Раздел

Тип данных: логический

Область применения: свойства, ссылки

Указывает, является ли свойство частью обработчика пространства имен. Если квалификатор ключа имеется в нескольких свойствах, то все эти свойства вместе формируют ключ (составной ключ). При совместном использовании ключевые свойства должны предоставлять уникальную ссылку на каждый экземпляр класса. Если этот квалификатор размещается в свойстве, то допускается только значение true .

Явно

Область применения: свойства

Указывает, что свойство может возвращать ресурсы и требует большого количества процессорного времени и памяти. WMI повышает производительность запросов, не пытаясь вернуть свойства, помеченные квалификатором Lazy .

маппингстрингс

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

Область применения: классы, свойства, ассоциации, указания, ссылки

Набор значений, указывающий путь к расположению, где можно найти дополнительные сведения о происхождении свойства, класса, ассоциации, указания или ссылки. Строка сопоставления может быть путем к каталогу, URL-адресом, ключом реестра, включаемым файлом, ссылкой на класс CIM или другим форматом. Значение по умолчанию — null.

Максимальной

Тип данных: int

Область применения: ссылки

Максимальное число значений, которое может иметь данная ссылка для каждого набора других ссылочных значений в ассоциации. Значение по умолчанию — null. Например, если Ассоциация связывает экземпляры с экземплярами B и в каждом экземпляре B должно быть не более одного экземпляра, то ссылка на объект должен иметь максимум один квалификатор.

MaxLen

Тип данных: int

Область применения: свойства, методы, параметры

Максимальная длина строкового элемента данных (в символах) и указание поддержки массивов фиксированной длины.

Если обнаружен массив фиксированной длины, квалификатор maxlen содержит фиксированную длину, найденную во время синтаксического анализа. При обнаружении массива переменной длины этот квалификатор не используется. Maxlen используется для предложения максимального количества элементов, которые должны храниться в массиве. При переопределении значения по умолчанию можно указать любое целочисленное значение без знака (UInt32). Значение null (по умолчанию) подразумевает неограниченную длину.

MaxValue

Тип данных: int

Область применения: свойства, методы, параметры

Максимальное значение объекта. Значение по умолчанию — null.

Минимум

Тип данных: int

Область применения: ссылки

Минимальное количество элементов ссылки (минимальное число значений, которое может иметь данная ссылка для каждого набора других ссылочных значений в ассоциации). Значение по умолчанию равно 0.

Например, если Ассоциация связывает экземпляры с экземплярами B, и для каждого экземпляра B должен существовать хотя бы один экземпляр, то ссылка на объект должен иметь минимум один квалификатор.

MinValue

Тип данных: int

Область применения: свойства, методы, параметры

Указывает минимальное значение объекта. Значение по умолчанию — null.

моделкорреспонденце

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

Область применения: свойства

Набор значений, указывающих на соответствие свойству объекта и другим свойствам в схеме CIM. Значение по умолчанию — null.

Свойства объекта определяются с помощью следующего синтаксиса.

"_" "."

Нелокальное

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

Область применения: ссылки

Расположение экземпляра, значение которого <намеспацетипе>://<намеспацехандле> значение по умолчанию равно null.

Использование: этот квалификатор нельзя использовать с квалификатором нонлокалтипе .

нонлокалтипе

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

Область применения: ссылки

Тип расположения экземпляра. Его значение — . Значение по умолчанию — null.

Использование: этот квалификатор не может использоваться с нелокальным квалификатором.

NullValue

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

Область применения: свойства

Значение, указывающее, что связанное свойство имеет значение null (свойство не имеет допустимого или осмысленного значения). Значение по умолчанию — null.

Правила и ограничения, используемые для определения значений null , совпадают с соглашениями, применимыми к квалификатору ValueMap . Обратите внимание, что квалификатор не может быть переопределен. Неоправданно разрешите подклассу возвращать другое значение null по сравнению с родительским классом.

Заполняет

Тип данных: логический

Область применения: параметры

Указывает, возвращает ли параметр значения из метода. Значение по умолчанию — false.

Крывают

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

Область применения: свойства, методы, ссылки

Родительский класс или подчиненная конструкция (свойство, метод или ссылка), переопределяемая свойством, методом или ссылкой на то же имя в производном классе. Значение по умолчанию — null.

Формат будет следующим:

[<> класса . ] < подчиненная конструкция>

Если имя класса пропущено, переопределение применяется к подчиненной конструкции в родительском классе в иерархии классов.

Использование. квалификатор переопределения может ссылаться только на конструкции, основанные только на той же мета модели. Не допускается изменение имени или подписи конструкции во время операции переопределения.

оверридевалуе

Область применения: классы

Указывает, переопределяет ли значение свойства подкласса значение в родительском классе. Функциональное приведение заключается в том, что при выполнении запроса к родительскому классу и если предложение WHERE включает это свойство, родительский элемент должен возвращать экземпляр с переопределенным значением. В результате система управления Windows настраивает предложение WHERE запроса, отправляемого в родительский класс, чтобы исключить ссылки на это свойство.

Распространяются

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

Область применения: свойства

Имя распространяемого ключа. Значение по умолчанию — null.

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

[<> класса . ] < подчиненная конструкция>

Использование: Если используется распространенный квалификатор, необходимо указать квалификатор ключа со значением true.

Просмотр

Тип данных: логический

Область применения: свойства

Указывает, доступно ли свойство для чтения. Значение по умолчанию — true.

Обязательно

Тип данных: логический

Область применения: свойства

Указывает, требуется ли для свойства значение, отличное от NULL. Значение по умолчанию — false.

Редакции

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

Область применения: классы, ассоциации, указания, схемы

Дополнительный номер редакции объекта схемы. Значение по умолчанию — null.

Использование: квалификатор версии должен присутствовать, чтобы указать основной номер версии при использовании квалификатора редакции .

Схемы

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

Область применения: свойства, методы

Имя схемы, в которой определен компонент. Значение по умолчанию — null.

Источника

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

Область применения: классы, ассоциации, указания, ссылки

Расположение экземпляра. Значение по умолчанию — null.

Значение квалификатора — <намеспацетипе>://<намеспацехандле>.

Использование: квалификатор источника не может использоваться с квалификатором sourceType .

SourceType

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

Область применения: классы, ассоциации, указания, ссылки

Тип расположения экземпляра. Значение этого квалификатора — <намеспацетипе>. Значение по умолчанию — null.

Использование: квалификатор sourceType не может использоваться с квалификатором источника .

суппортскреате

Тип данных: логический

Область применения: классы

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

суппортсделете

Тип данных: логический

Область применения: классы

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

суппортсупдате

Тип данных: логический

Область применения: классы

Указывает, поддерживает ли класс изменение (обновление) экземпляров. Значение по умолчанию — false.

Терминалов

Тип данных: логический

Область применения: классы

Указывает, может ли класс содержать подклассы. Значение по умолчанию — false.

Если подкласс объявлен, компилятор выдает ошибку.

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

Комплект

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

Область применения: свойства, методы, параметры

Тип единицы измерения, в которой выражается связанный элемент данных. Значение по умолчанию — null.

Например, элемент данных размера может иметь значение "байт" для единиц.

ValueMap

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

Область применения: свойства, методы, параметры

Набор допустимых значений для свойства, типа возвращаемого значения метода или параметра метода. Значение по умолчанию — null.

Использование. Этот квалификатор можно использовать отдельно или в сочетании с квалификатором Values . При использовании в сочетании с квалификатором Values расположение значения в массиве ValueMap предоставляет расположение соответствующей записи в массиве Values . Используйте квалификатор ValueMap только со строковыми и целыми значениями. Синтаксис для представления целочисленного значения в массиве карт значений состоит из [ + | = ] цифр [ * ] . Содержимое, максимальное число разрядов и представленное значение ограничено типом связанного свойства. Например, значение Uint8 не может быть подписано, должно быть меньше четырех цифр и должно представлять меньше 256.

Данные

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

Область применения: свойства, методы, параметры

Набор значений, преобразуя целочисленное значение в связанную строку. Значение по умолчанию — null.

Это свойство также указывает массив строковых значений, которые должны быть сопоставлены со свойством перечисления. Этот квалификатор можно применить либо к целочисленному свойству, либо к строковому свойству, и сопоставление может быть неявным или явным. Если сопоставление является неявным, значения целочисленного или строкового свойства представляют порядковые позиции в массиве Values . Если сопоставление является явным, свойство должно быть целым числом, а значения допустимых свойств перечислены в массиве, определенном квалификатором ValueMap . Дополнительные сведения см. в разделе значение Map.

Если квалификатор ValueMap отсутствует, массив Values индексируется (относительный от нуля), используя значение в связанном свойстве, типе возвращаемого значения метода или параметре метода. Если указан квалификатор ValueMap , то индекс значений определяется расположением значения свойства в сопоставлении значений.

Версия

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

Область применения: классы, схемы, ассоциации, указания

Основной номер версии объекта схемы. Значение по умолчанию — null. Номер версии увеличивается при внесении изменений в схему, которая изменяет интерфейс.

Безопасные

Тип данных: логический

Область применения: ссылки

Указывает, включают ли ключи упоминаемого класса ключи других участников ассоциации. Значение по умолчанию — false.

Этот квалификатор используется, когда удостоверение упоминаемого класса зависит от удостоверения других участников ассоциации. Ни одна ссылка на любой заданный класс может быть ненадежной. Другие классы в ассоциации должны определять ключ. Ключи других классов в ассоциации повторяются в упоминаемом классе и помечаются с помощью распространяемого квалификатора.

Будет

Тип данных: логический

Область применения: свойства

Указывает, что приложения или скрипты могут изменять значение свойства. Учетная запись, которая запускает приложение, должна иметь доступ к пространству имен, содержащему экземпляры класса. Реализация поставщика может также ограничить доступ к данным поставщика. Значение true указывает, что свойство доступно для чтения и записи для потребителей, которым разрешен доступ к WMI и поставщику. Значение по умолчанию — false.

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

вритеаткреате

Тип данных: логический

Область применения: свойства

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

вритеатупдате

Тип данных: логический

Область применения: свойства

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

Примеры

Дополнительные сведения о получении квалификаторов см. в примере кода PowerShell Get-вмиклассмесодсандвритаблевмипропертиес в коллекции TechNet.

Требования

Требование Значение
Минимальная версия клиента
Windows Vista
Минимальная версия сервера
Windows Server 2008

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

Квалификаторы WMI

Добавление квалификатора