az cu

비고

이 참조는 Azure CLI(버전 2.75.0 이상)에 대한 콘텐츠 이해 확장의 일부입니다. az cu 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

Azure Content Understanding을 관리하고 사용합니다.

명령

속성 Description 형식 상태
az cu analyze

로컬 파일 또는 HTTPS URL을 처리하고 분석기 결과를 반환합니다.

확장 Preview
az cu analyzer

Content Understanding 분석기를 관리합니다.

확장 Preview
az cu analyzer copy

Microsoft Foundry 리소스 내 또는 전체에서 분석기를 복사합니다.

확장 Preview
az cu analyzer create

JSON 스키마 파일에서 분석기를 만듭니다.

확장 Preview
az cu analyzer delete

분석기를 삭제합니다.

확장 Preview
az cu analyzer list

Microsoft Foundry 리소스의 분석기를 나열합니다.

확장 Preview
az cu analyzer schema

Content Understanding 분석기 스키마를 작성합니다.

확장 Preview
az cu analyzer schema create

시작 스키마를 만들거나 로컬 문서 샘플에서 스키마를 파생합니다.

확장 Preview
az cu analyzer show

단일 분석기 정의(JSON)를 표시합니다.

확장 Preview
az cu analyzer test

로컬 샘플을 통해 분석기를 실행합니다.

확장 Preview
az cu analyzer validate

로컬 분석기 스키마의 유효성을 검사합니다.

확장 Preview
az cu defaults

Content Understanding 모델 배포 기본값을 관리합니다.

확장 Preview
az cu defaults set

모델을 배포에 매핑하는 Content Understanding 기본값을 구성합니다.

확장 Preview
az cu defaults show

모델을 배포에 매핑하는 Content Understanding 기본값을 표시합니다.

확장 Preview
az cu doctor

Microsoft Foundry 리소스 연결 및 Content Understanding 기본값을 확인합니다.

확장 Preview
az cu env-var

인식된 CU 환경 변수 이름을 안전하게 검사합니다.

확장 Preview
az cu env-var list

현재 설정된 인식된 환경 변수를 나열합니다.

확장 Preview
az cu infra

Content Understanding에 대한 코드로서의 인프라를 생성합니다.

확장 Preview
az cu infra _models

생성된 인프라 프로젝트에 대한 모델 배포를 구성합니다.

확장 Preview
az cu infra _postprovision-v1

azd 프로비전 후 생성된 프로젝트 설정을 완료합니다.

확장 Preview
az cu infra generate

Content Understanding에 대한 azd/Bicep 프로젝트를 생성합니다.

확장 Preview
az cu profile

Azure CLI 구성에 원자성으로 저장된 CU 프로필을 관리합니다.

확장 Preview
az cu profile copy

CU CLI 프로필을 새 이름으로 복사합니다.

확장 Preview
az cu profile create

정품 인증 없이 명명된 빈 CU CLI 프로필을 만듭니다.

확장 Preview
az cu profile delete

비활성 CU CLI 프로필을 삭제합니다.

확장 Preview
az cu profile get

저장된 CU CLI 프로필 값 하나를 인쇄합니다.

확장 Preview
az cu profile list

저장된 CU CLI 프로필을 나열하고 활성 CU CLI 프로필을 식별합니다.

확장 Preview
az cu profile rename

값과 활성 상태를 유지하면서 CU CLI 프로필의 이름을 바꿉니다.

확장 Preview
az cu profile set

저장된 CU CLI 프로필 값 하나를 설정합니다.

확장 Preview
az cu profile set-active

활성 CU CLI 프로필을 선택합니다.

확장 Preview
az cu profile show

비밀이 수정된 유효한 CU CLI 프로필을 표시합니다.

확장 Preview
az cu profile sync-defaults

Content Understanding 기본값에서 프로필의 모델 매핑을 새로 고칩니다.

확장 Preview
az cu profile unset

명시적으로 저장된 CU CLI 프로필 값을 제거합니다.

확장 Preview

az cu analyze

미리 보기

명령 그룹 'cu'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

로컬 파일 또는 HTTPS URL을 처리하고 분석기 결과를 반환합니다.

az cu analyze [--acquire-policy-token]
              [--analyzer]
              [--api-key]
              [--api-version]
              [--auth-mode {key, login}]
              [--change-reference]
              [--concurrency]
              [--dry-run]
              [--endpoint]
              [--file]
              [--inline]
              [--llm-input]
              [--on-existing {error, reanalyze, skip}]
              [--output-dir]
              [--output-file]
              [--pattern]
              [--profile]
              [--recursive]
              [--report-file]
              [--source]
              [--url]
              [--usage]
              [--yes]

예제

명시적 분석기 및 엔드포인트를 사용하여 청구서를 분석합니다.

az cu analyze --file invoice.pdf --analyzer prebuilt-invoice --endpoint https://contoso.services.ai.azure.com/

활성 CU 프로필의 기본값을 사용하여 파일을 분석합니다.

az cu analyze --file invoice.pdf

JMESPath를 사용하여 추출된 필드를 선택합니다.

az cu analyze --file invoice.pdf --query "contents[0].fields"

HTTPS 또는 Azure Blob SAS URL을 분석합니다.

az cu analyze --url "https://storage.example/container/invoice.pdf?<sas>" --analyzer prebuilt-invoice

디렉터리를 재귀적으로 분석하고 하나의 디렉터리 아래에 결과를 작성합니다.

az cu analyze --source documents --recursive --output-dir results --analyzer prebuilt-document --yes

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--analyzer -a

분석기 이름; 기본값은 구성된 기본 분석기입니다.

--api-key

foundry 리소스 API 키를 Microsoft.

--api-version

Content Understanding 서비스 API 버전입니다.

--auth-mode

인증 모드입니다.

속성 값
허용되는 값: key, login
--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--concurrency -j

동시 분석 작업입니다.

속성 값
Default value: 4
--dry-run

서비스 호출 또는 쓰기 없이 로컬 실행 계획을 표시합니다.

속성 값
Default value: False
--endpoint

Content Understanding에 대한 foundry 리소스 엔드포인트를 Microsoft.

--file

리터럴 로컬 파일입니다. 여러 파일에 대해 반복합니다.

--inline -i

미리 보기 동기 분석을 사용합니다.

속성 값
Default value: False
--llm-input

생성 AI 모델 입력으로 형식이 지정된 분석기 결과를 반환합니다.

속성 값
Default value: False
--on-existing

기존 결과 파일을 처리하는 방법입니다.

속성 값
허용되는 값: error, reanalyze, skip
--output-dir -d

원본 상대 경로를 유지하면서 이 디렉터리 아래에 결과를 작성합니다.

--output-file

선택한 파일 하나에 대한 기본 페이로드를 작성합니다.

--pattern

Python 모든 --source에 적용된 fnmatch 패턴입니다.

--profile

엔드포인트 및 API 버전 기본값을 확인하는 데 사용되는 CU CLI 프로필입니다.

--recursive -r

선택한 디렉터리로 재귀합니다.

속성 값
Default value: False
--report-file

독립 실행형 JSON 상태 보고서를 작성합니다.

--source

로컬 원본 디렉터리입니다. 여러 디렉터리에 대해 반복합니다.

--url

HTTPS 또는 Azure Blob SAS URL입니다. 여러 URL에 대해 반복합니다.

--usage

서비스 사용량 세부 정보를 포함합니다.

속성 값
Default value: False
--yes -y

검색 확인을 건너뜁니다.

속성 값
Default value: False
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az cu doctor

미리 보기

명령 그룹 'cu'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

Microsoft Foundry 리소스 연결 및 Content Understanding 기본값을 확인합니다.

az cu doctor [--acquire-policy-token]
             [--api-key]
             [--api-version]
             [--auth-mode {key, login}]
             [--change-reference]
             [--endpoint]
             [--fix-defaults]
             [--profile]

예제

활성 프로필 및 리소스 기본값을 확인합니다.

az cu doctor --output table

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--api-key

구성된 API 키를 재정의합니다.

--api-version

Content Understanding API 버전입니다. 알려진 버전: 2025-11-01(GA) 및 2026-06-01-preview(미리 보기); YYYY-MM-DD-preview 버전도 허용됩니다.

--auth-mode

인증 모드; 은 선택한 CU CLI 프로필로 기본 설정됩니다.

속성 값
허용되는 값: key, login
--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--endpoint

구성된 Microsoft Foundry 리소스 엔드포인트를 재정의합니다.

--fix-defaults

프로필 모델 매핑에서 Content Understanding 기본값을 구성합니다.

속성 값
Default value: False
--profile -p

사용할 명명된 CU CLI 프로필입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False