Exponenta Banner
exponenta event banner

лицензия

Получение статуса лицензии, проверка существования лицензии на продукт или получение лицензии на функции

свернуть все на странице

Синтаксис

лицензия
лицензия ('inuse')
S = лицензия ('inuse')
S = лицензия ('inuse', функция)
status = лицензия ('тест', функция)
лицензия («тест», функция, переключатель)
[status, errmsg] = лицензия («извлечение», функция)

Описание

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

license возвращает номер лицензии для данного продукта MATLAB ®. Возвращаемое значение также может быть нечисловым, например ,'demo' для демонстрационной версии MATLAB, или 'student', для студенческой версии MATLAB.

пример

license('inuse') отображает список лицензий, взятых на изменение в текущем сеансе MATLAB. Список продуктов представлен в алфавитном порядке по наименованию лицензионного компонента. Эти имена совпадают с допустимыми значениями для feature вход.

пример

S = license('inuse') возвращает массив структур, указывающих выданные лицензии и имя пользователя каждого пользователя, у которого выдана лицензия.

пример

S = license('inuse',feature) проверяет, указан ли продукт feature взята на изменение в текущем сеансе MATLAB. Если продукт извлечен, то license возвращает имя продукта и имя пользователя, который взял его на изменение. В противном случае поля S пусты.

пример

status = license('test',feature) проверяет, существует ли лицензия на продукт, указанный в feature.

license('test',feature,toggle) включает или отключает тестирование продукта, указанного в feature, в зависимости от значения toggle.

пример

[status,errmsg] = license('checkout',feature) получение лицензии для указанного продукта. Если указан дополнительный второй выходной аргумент, errmsg, то license возвращает текст любого сообщения об ошибке, обнаруженного в случае неуспешного завершения операции.

Примеры

свернуть все

Отображение списка используемых лицензий. license отображает список продуктов в алфавитном порядке по имени лицензионного компонента для конфигурации.

license('inuse')
image_toolbox
map_toolbox
matlab

Получите список используемых лицензий с информацией о каждом пользователе. license возвращает массив структуры.

S = license('inuse');

Просмотр первого элемента S.

S(1)
ans = 

    feature: 'image_toolbox'
       user: 'juser'

Определите, используется ли лицензия для MATLAB. Если лицензия используется, то S - структурный массив с непустыми полями.

S = license('inuse','MATLAB')
S = 

    feature: 'matlab'
       user: 'jsmith'

Определите, существует ли лицензия для Toolbox™ сопоставления. Если лицензия существует, то license прибыль 1.

status = license('test','MAP_Toolbox')
status =

    1

Проверьте лицензию на Toolbox™ системы управления. status вывод - 1 и errmsg если извлечение выполнено успешно, то выходные данные пусты.

[status,errmsg] = license('checkout','Control_Toolbox')
status =

     1


errmsg =

     ''

Входные аргументы

свернуть все

Имя лицензионного элемента, указанное как символьный вектор. Значения feature не чувствительны к регистру. INCREMENT строки в файле лицензии указывают допустимые функции. Чтобы найти файл лицензии, см. раздел Где находятся файлы лицензий для MATLAB?

Возможность проверки наличия лицензии на продукт, указанной как 'enable' или 'disable'.

  • Если toggle является 'enable', то синтаксис, license('test',feature) прибыль 1 когда лицензия на продукт существует и 0 если лицензия на продукт не существует.

  • Если toggle является 'disable', то синтаксис, license('test',feature) всегда возвращается 0 (лицензия на продукт не существует) для указанного продукта.

Примечание

Отключение теста для определенного продукта может повлиять на другие тесты на наличие лицензии, а не только на тесты, выполняемые license команда.

Выходные аргументы

свернуть все

Взятые на изменение изделия, возвращенные в виде массива структур, где каждая структура представляет взятую на изменение лицензию. Структуры содержат два поля:

  • feature - имя лицензионного элемента

  • user - имя пользователя, у которого выдана лицензия

Если поля пусты, то продукт в настоящее время не извлечен.

Состояние тестирования или извлечения, возвращено как 1 или 0.

  • При тестировании на наличие лицензии, 1 указывает, что лицензия существует, и 0 указывает, что лицензия не существует.

    Наличие лицензии не обязательно означает, что лицензия может быть извлечена или что продукт установлен. Если все ключи продукта используются, то тест все равно вернет 1, но реальная проверка завершится неудачей.

  • При получении лицензии 1 указывает, что оформление заказа выполнено успешно, и 0 указывает, что license функция не может извлечь лицензию.

Сообщение об ошибке при неудачном извлечении лицензии, возвращенное в виде символьного вектора. Если оформление заказа выполнено успешно, то errmsg пуст.

Сообщения об ошибках обычно указывают, как можно решить проблему. Например:

License checkout failed.
License Manager Error -5
Cannot find a license for FEATURENAME.

Troubleshoot this issue by visiting:
https://www.mathworks.com/support/lme/R2021b/5

Полученная ошибка извлечения лицензии может зависеть от типа лицензии.

Совет

  • Войдите в учетную запись MathWorks ® для получения сведений обо всех лицензиях, связанных с вашей учетной записью, таких как тип лицензии, использование продукта и сведения об истечении срока действия.

  • Чтобы выполнить задачи управления лицензиями, включая обновление или деактивацию лицензии, см. раздел Управление лицензиями.

См. также

| |

Темы

Представлен до R2006a

Документация MATLAB

Поддержка