Main Content

license

라이선스 상태 확인, 라이선스의 존재 여부 테스트 또는 기능 라이선스 체크아웃

설명

license 함수를 사용하여 현재 사용 중인 라이선스 번호를 반환하고, 현재 세션에서 체크아웃된 라이선스를 나열하고, 라이선스에서 특정 기능이 체크아웃되었는지 확인하고, 라이선스에서 특정 기능을 체크아웃합니다. 라이선스를 갱신 또는 비활성화하는 방법을 포함하여 라이선스 관리 작업을 수행하려면 라이선스 관리하기 항목을 참조하십시오.

license는 이 MATLAB®의 라이선스 번호를 반환합니다. 반환 값은 MATLAB 데모 버전의 경우 'demo', MATLAB Student Version의 경우 'student'와 같이 번호가 아닌 값일 수도 있습니다.

예제

license('inuse')는 현재 MATLAB 세션에서 체크아웃된 기능 목록을 표시합니다. 이 목록은 라이선스 기능 이름을 사전순으로 표시합니다. 이러한 이름은 feature 입력값의 유효한 값과 동일합니다.

예제

S = license('inuse')는 현재 세션에서 체크아웃된 기능을 표시하는 구조체로 구성된 배열을 반환합니다.

예제

S = license('inuse',feature)feature가 현재 MATLAB 세션에서 체크아웃되었는지 여부를 확인합니다. 해당 기능이 체크아웃되었으면 license는 현재 세션에 사용 중인 라이선스 이름을 반환합니다. 그렇지 않은 경우 S의 필드는 비어 있습니다.

예제

status = license('test',feature)feature로 지정된 값의 라이선스가 존재하는지 테스트합니다.

license('test',feature,toggle)toggle 값에 따라 feature로 지정된 값의 테스트를 활성화하거나 비활성화합니다.

예제

[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: ''

구조체에 사용자 필드가 포함되어 있지만 이 필드는 항상 비어 있습니다.

MATLAB의 라이선스가 사용 중인지 확인합니다. 라이선스가 사용 중인 경우 S는 체크아웃된 기능의 이름을 갖는 구조체형 배열입니다.

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

    feature: 'matlab'
       user: ''

Mapping Toolbox™의 라이선스가 존재하는지 확인합니다. 라이선스가 존재하는 경우 license1을 반환합니다.

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

    1

Control System Toolbox™의 라이선스를 체크아웃합니다. 체크아웃이 성공한 경우 status 출력값은 1이고 errmsg 출력값은 비어 있습니다.

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

     1


errmsg =

     ''

입력 인수

모두 축소

라이선스 기능 이름으로, 문자형 벡터로 지정됩니다. feature의 값은 대/소문자를 구분하지 않습니다. 라이선스 파일의 INCREMENT 라인에 유효한 라이선스 기능이 기술되어 있습니다. 라이선스 파일이 있는 위치를 알아보려면 Where can I find MATLAB license files?를 참조하십시오.

라이선스가 있는지 테스트할 수 있는 기능으로, 'enable' 또는 'disable'로 지정됩니다.

  • toggle'enable'이면 구문 license('test',feature)는 라이선스가 존재하는 경우 1을 반환하고 라이선스가 존재하지 않는 경우 0을 반환합니다.

  • toggle'disable'이면 구문 license('test',feature)는 지정된 기능에 대해 항상 0(라이선스가 존재하지 않음)을 반환합니다.

참고

특정 라이선스에 대한 테스트를 비활성화하면 license 명령으로 수행되는 테스트뿐만 아니라 라이선스가 존재하는지 여부를 확인하는 다른 테스트에도 영향을 줄 수 있습니다.

출력 인수

모두 축소

체크아웃된 라이선스로, 구조체로 구성된 배열로 반환됩니다. 여기서 각 구조체는 체크아웃된 라이선스를 나타냅니다. 구조체는 다음 두 필드를 포함합니다.

  • feature — 라이선스 기능 이름

  • user — 항상 비어 있는 필드

두 필드가 모두 비어 있으면 라이선스가 현재 체크아웃되지 않은 것입니다.

테스트 또는 체크아웃 상태로, 1 또는 0으로 반환됩니다.

  • 라이선스가 있는지 여부를 테스트할 때 1은 라이선스가 존재함을 나타내고 0은 라이선스가 존재하지 않음을 나타냅니다.

    라이선스가 있다고 해서 반드시 라이선스를 체크아웃할 수 있거나 라이선스의 기능이 설치되었음을 의미하는 것은 아닙니다. 라이선스의 모든 키가 사용 중인 경우 테스트는 여전히 1을 반환하지만 실제 체크아웃은 실패하게 됩니다.

  • 라이선스를 체크아웃할 때 1은 체크아웃이 성공했음을 나타내고 0license 함수가 라이선스를 체크아웃할 수 없음을 나타냅니다.

라이선스 체크아웃이 실패한 경우에 반환되는 오류 메시지로, 문자형 벡터로 반환됩니다. 체크아웃이 성공하면 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 이전에 개발됨

모두 확장

참고 항목

|