다음을 통해 공유


az sql vm

SQL 가상 머신을 관리합니다.

명령

Name Description 형식 상태
az sql vm add-to-group

SQL 가상 머신 그룹에 SQL 가상 머신을 추가합니다.

핵심 GA
az sql vm create

SQL 가상 머신을 만듭니다.

핵심 GA
az sql vm delete

SQL 가상 머신을 삭제합니다.

핵심 GA
az sql vm enable-azure-ad-auth

SQL 가상 머신의 Azure AD 인증을 사용하도록 설정합니다.

핵심 GA
az sql vm group

SQL 가상 머신 그룹을 관리합니다.

핵심 GA
az sql vm group ag-listener

SQL 가용성 그룹 수신기를 관리합니다.

핵심 GA
az sql vm group ag-listener create

가용성 그룹 수신기를 만듭니다.

핵심 GA
az sql vm group ag-listener delete

가용성 그룹 수신기를 삭제합니다.

핵심 GA
az sql vm group ag-listener list

SQL 가상 머신 그룹의 모든 가용성 그룹 수신기를 나열합니다.

핵심 GA
az sql vm group ag-listener show

가용성 그룹 수신기를 가져옵니다.

핵심 GA
az sql vm group ag-listener update

가용성 그룹 수신기를 업데이트.

핵심 GA
az sql vm group create

SQL 가상 머신 그룹을 만듭니다.

핵심 GA
az sql vm group delete

SQL 가상 머신 그룹을 삭제합니다.

핵심 GA
az sql vm group list

리소스 그룹 또는 구독의 모든 SQL 가상 머신 그룹을 나열합니다.

핵심 GA
az sql vm group show

SQL 가상 머신 그룹을 가져옵니다.

핵심 GA
az sql vm group update

그룹에 연결된 SQL 가상 머신이 없는 경우 SQL 가상 머신 그룹을 업데이트.

핵심 GA
az sql vm list

리소스 그룹 또는 구독의 모든 SQL 가상 머신을 나열합니다.

핵심 GA
az sql vm remove-from-group

현재 SQL 가상 머신 그룹에서 SQL 가상 머신을 제거합니다.

핵심 GA
az sql vm show

SQL 가상 머신을 가져옵니다.

핵심 GA
az sql vm start-assessment

SQL 가상 머신에서 SQL 모범 사례 평가를 시작합니다.

핵심 GA
az sql vm update

SQL 가상 머신의 속성을 업데이트.

핵심 GA
az sql vm validate-azure-ad-auth

클라이언트 쪽에서 SQL 가상 머신을 사용하도록 설정하지 않고 Azure AD 인증의 유효성을 검사합니다.

핵심 GA

az sql vm add-to-group

SQL 가상 머신 그룹에 SQL 가상 머신을 추가합니다.

az sql vm add-to-group --sqlvm-group
                       [--bootstrap-acc-pwd]
                       [--ids]
                       [--name]
                       [--operator-acc-pwd]
                       [--resource-group]
                       [--service-acc-pwd]
                       [--subscription]

예제

그룹에 SQL 가상 머신을 추가합니다.

az sql vm add-to-group -n sqlvm -g myresourcegroup --sqlvm-group sqlvmgroup --bootstrap-acc-pwd {bootstrappassword} --operator-acc-pwd {operatorpassword} --service-acc-pwd {servicepassword}

필수 매개 변수

--sqlvm-group -r

SQL 가상 머신 그룹의 이름 또는 리소스 ID입니다. 이름만 제공된 경우 SQL 가상 머신 그룹은 SQL 가상 머신의 동일한 리소스 그룹에 있어야 합니다.

선택적 매개 변수

--bootstrap-acc-pwd -b

SQL 가상 머신 그룹에 제공된 경우 클러스터 부트스트랩 계정의 암호입니다.

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

SQL 가상 머신의 이름입니다.

--operator-acc-pwd -p

SQL 가상 머신 그룹에 제공된 클러스터 운영자 계정의 암호입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--service-acc-pwd -s

SQL 가상 머신 그룹에 제공된 SQL 서비스 계정의 암호입니다.

--subscription

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql vm create

SQL 가상 머신을 만듭니다.

az sql vm create --name
                 --resource-group
                 [--backup-pwd]
                 [--backup-schedule-type {Automated, Manual}]
                 [--backup-system-dbs {false, true}]
                 [--connectivity-type {LOCAL, PRIVATE, PUBLIC}]
                 [--credential-name]
                 [--day-of-week {Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
                 [--enable-auto-backup {false, true}]
                 [--enable-auto-patching {false, true}]
                 [--enable-encryption {false, true}]
                 [--enable-key-vault-credential {false, true}]
                 [--enable-r-services {false, true}]
                 [--full-backup-duration]
                 [--full-backup-frequency {Daily, Weekly}]
                 [--full-backup-start-hour]
                 [--image-offer]
                 [--image-sku {Developer, Enterprise, Express, Standard, Web}]
                 [--key-vault]
                 [--least-privilege-mode {Enabled, NotSet}]
                 [--license-type {AHUB, DR, PAYG}]
                 [--location]
                 [--log-backup-frequency]
                 [--maintenance-window-duration]
                 [--maintenance-window-start-hour]
                 [--port]
                 [--retention-period]
                 [--sa-key]
                 [--sp-name]
                 [--sp-secret]
                 [--sql-auth-update-pwd]
                 [--sql-auth-update-username]
                 [--sql-mgmt-type {Full, LightWeight, NoAgent}]
                 [--sql-workload-type {DW, GENERAL, OLTP}]
                 [--storage-account]
                 [--tags]

예제

AHUB 청구 태그를 사용하여 SQL 가상 머신을 만듭니다.

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type AHUB

DR 청구 태그를 사용하여 SQL 가상 머신을 만듭니다.

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type DR

특정 sku 유형 및 라이선스 유형을 사용하여 SQL 가상 머신을 만듭니다.

az sql vm create -n sqlvm -g myresourcegroup -l eastus --image-sku Enterprise --license-type AHUB

최소 권한 모드를 사용하도록 설정된 SQL 가상 머신을 만듭니다.

az sql vm create -n sqlvm -g myresourcegroup -l eastus --least-privilege-mode Enabled --sql-mgmt-type Full

EOS SQL 2008 및 SQL 2008 R2에만 유효한 NoAgent 형식의 SQL 가상 머신을 만듭니다.

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type AHUB --sql-mgmt-type NoAgent --image-sku Enterprise --image-offer SQL2008-WS2008R2

SQL2016 이후부터 R 서비스를 사용하도록 설정합니다.

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --enable-r-services true

SQL 가상 머신을 만들고 자동 백업 설정을 구성합니다.

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --backup-schedule-type manual --full-backup-frequency Weekly --full-backup-start-hour 2 --full-backup-duration 2 --sa-key {storageKey} --storage-account 'https://storageacc.blob.core.windows.net/' --retention-period 30 --log-backup-frequency 60

SQL 가상 머신을 만들고 자동 패치 설정을 구성합니다.

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --day-of-week sunday --maintenance-window-duration 60 --maintenance-window-start-hour 2

SQL 가상 머신을 만들고 SQL 연결 설정을 구성합니다.

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --connectivity-type private --port 1433 --sql-auth-update-username {newlogin} --sql-auth-update-pwd {sqlpassword}

필수 매개 변수

--name -n

SQL 가상 머신의 이름입니다. 새 SQL 가상 머신의 이름은 SQL Marketplace 이미지에서 만든 기본 가상 머신과 같아야 합니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--backup-pwd

백업에서 암호화에 대한 암호입니다.

--backup-schedule-type

백업 일정 유형입니다.

허용되는 값: Automated, Manual
--backup-system-dbs

백업에 시스템 데이터베이스를 포함합니다.

허용되는 값: false, true
Default value: False
--connectivity-type

SQL Server 연결 옵션입니다.

허용되는 값: LOCAL, PRIVATE, PUBLIC
--credential-name

자격 증명 이름입니다.

--day-of-week

패치를 적용할 요일입니다.

허용되는 값: Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday
--enable-auto-backup

SQL 가상 머신에서 자동 복구를 사용하거나 사용하지 않도록 설정합니다. 백업 설정이 제공되면 매개 변수가 자동으로 true로 설정됩니다.

허용되는 값: false, true
--enable-auto-patching

SQL 가상 머신에서 자동 패치를 사용하거나 사용하지 않도록 설정합니다. 자동 패치 설정이 제공되면 매개 변수가 자동으로 true로 설정됩니다.

허용되는 값: false, true
--enable-encryption

SQL 가상 머신에서 백업에 암호화를 사용하도록 설정합니다.

허용되는 값: false, true
Default value: False
--enable-key-vault-credential

키 자격 증명 모음 자격 증명 설정을 사용하거나 사용하지 않도록 설정합니다. 키 자격 증명 모음 설정이 제공되면 매개 변수가 자동으로 true로 설정됩니다.

허용되는 값: false, true
--enable-r-services

R 서비스를 사용하거나 사용하지 않도록 설정합니다(SQL 2016 이상).

허용되는 값: false, true
--full-backup-duration

전체 백업이 수행될 수 있는 지정된 날의 시간 기간입니다. 1-23시간.

--full-backup-frequency

전체 백업의 빈도입니다. 두 경우 모두 전체 백업은 예약된 다음 기간 동안 시작됩니다.

허용되는 값: Daily, Weekly
--full-backup-start-hour

전체 백업이 수행될 수 있는 지정된 날의 시작 시간입니다. 0-23시간

--image-offer

SQL 이미지 제품입니다. 예를 들어 SQL2008R2-WS2008, SQL2008-WS2008이 있습니다.

--image-sku

SQL 이미지 sku.

허용되는 값: Developer, Enterprise, Express, Standard, Web
--key-vault

Azure Key Vault URL입니다.

--least-privilege-mode

SQL IaaS 에이전트 최소 권한 모드입니다. sysadmin에서 기능별로 사용되는 특정 권한으로 업데이트.

허용되는 값: Enabled, NotSet
--license-type -i

SQL Server 라이선스 유형입니다.

허용되는 값: AHUB, DR, PAYG
--location -l

위치. 제공되지 않은 경우 가상 머신은 리소스 그룹의 동일한 지역에 있어야 합니다. 를 사용하여 az configure --defaults location=<location>기본 위치를 구성할 수 있습니다.

--log-backup-frequency

로그 백업의 빈도입니다. 5-60분.

--maintenance-window-duration

패치 기간입니다. 30-180분.

--maintenance-window-start-hour

패치가 시작되는 하루 중 시간입니다. 로컬 VM 시간 0-23시간

--port

SQL Server 포트입니다.

--retention-period

백업 보존 기간입니다. 1-30일.

--sa-key

백업이 수행될 스토리지 계정 키입니다.

--sp-name

키 자격 증명 모음에 액세스할 서비스 주체 이름입니다.

--sp-secret

키 자격 증명 모음에 액세스하기 위한 서비스 주체 이름 비밀입니다.

--sql-auth-update-pwd

SQL Server sysadmin 로그인 암호입니다.

--sql-auth-update-username

만들 SQL Server sysadmin 로그인입니다.

--sql-mgmt-type
사용되지 않음

'sql_management_mode' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

SQL Server 관리 유형입니다. NoAgent를 선택한 경우 --image-sku 및 --offer-type을 제공하세요.

허용되는 값: Full, LightWeight, NoAgent
Default value: LightWeight
--sql-workload-type

SQL Server 워크로드 유형입니다.

허용되는 값: DW, GENERAL, OLTP
--storage-account

백업이 수행될 스토리지 계정 URL입니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql vm delete

SQL 가상 머신을 삭제합니다.

az sql vm delete [--ids]
                 [--name]
                 [--resource-group]
                 [--subscription]
                 [--yes]

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

SQL 가상 머신의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

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

--yes -y

확인 메시지를 표시하지 않습니다.

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

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql vm enable-azure-ad-auth

SQL 가상 머신의 Azure AD 인증을 사용하도록 설정합니다.

az sql vm enable-azure-ad-auth [--ids]
                               [--msi-client-id]
                               [--name]
                               [--resource-group]
                               [--skip-client-validation]
                               [--subscription]

예제

클라이언트 쪽 유효성 검사를 사용하여 시스템 할당 관리 ID를 사용하여 Azure AD 인증을 사용하도록 설정합니다.

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup

클라이언트 쪽 유효성 검사를 사용하여 사용자 할당 관리 ID를 사용하여 Azure AD 인증을 사용하도록 설정합니다.

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup --msi-client-id 12345678

클라이언트 쪽 유효성 검사를 건너뛰는 시스템 할당 관리 ID를 사용하여 Azure AD 인증을 사용하도록 설정합니다. 서버 쪽 유효성 검사는 항상 발생합니다.

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup --skip-client-validation

클라이언트 쪽 유효성 검사를 건너뛰는 사용자 할당 관리 ID를 사용하여 Azure AD 인증을 사용하도록 설정합니다. 서버 쪽 유효성 검사는 항상 발생합니다.

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup --msi-client-id 12345678 --skip-client-validation

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--msi-client-id

Virutal Machine 관리 ID 클라이언트 ID입니다.

--name -n

SQL 가상 머신의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--skip-client-validation

클라이언트 쪽 Azure AD 인증 유효성 검사를 건너뛰면 서버 쪽 유효성 검사가 계속 수행됩니다.

--subscription

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql vm list

리소스 그룹 또는 구독의 모든 SQL 가상 머신을 나열합니다.

az sql vm list [--resource-group]

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql vm remove-from-group

현재 SQL 가상 머신 그룹에서 SQL 가상 머신을 제거합니다.

az sql vm remove-from-group [--ids]
                            [--name]
                            [--resource-group]
                            [--subscription]

예제

그룹에서 SQL 가상 머신을 제거합니다.

az sql vm remove-from-group -n sqlvm -g myresourcegroup

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

SQL 가상 머신의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql vm show

SQL 가상 머신을 가져옵니다.

az sql vm show [--expand {*, AssessmentSettings, AutoBackupSettings, AutoPatchingSettings, KeyVaultCredentialSettings, ServerConfigurationsManagementSettings}]
               [--ids]
               [--name]
               [--resource-group]
               [--subscription]

선택적 매개 변수

--expand

SQLIaaSExtension 구성 설정을 가져옵니다. 모든 설정을 보려면 *를 사용합니다. 몇 가지만 선택하려면 설정이 공백으로 구분되어야 합니다.

허용되는 값: *, AssessmentSettings, AutoBackupSettings, AutoPatchingSettings, KeyVaultCredentialSettings, ServerConfigurationsManagementSettings
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

SQL 가상 머신의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql vm start-assessment

SQL 가상 머신에서 SQL 모범 사례 평가를 시작합니다.

az sql vm start-assessment [--ids]
                           [--name]
                           [--resource-group]
                           [--subscription]

예제

SQL 모범 사례 평가를 시작합니다.

az sql vm start-assessment -n sqlvm -g myresourcegroup

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

SQL 가상 머신의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql vm update

SQL 가상 머신의 속성을 업데이트.

az sql vm update [--add]
                 [--agent-rg]
                 [--am-day {Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
                 [--am-month-occ {-1, 1, 2, 3, 4}]
                 [--am-schedule {false, true}]
                 [--am-time]
                 [--am-week-int {1, 2, 3, 4, 5, 6}]
                 [--backup-pwd]
                 [--backup-schedule-type {Automated, Manual}]
                 [--backup-system-dbs {false, true}]
                 [--connectivity-type {LOCAL, PRIVATE, PUBLIC}]
                 [--credential-name]
                 [--day-of-week {Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
                 [--enable-assessment {false, true}]
                 [--enable-auto-backup {false, true}]
                 [--enable-auto-patching {false, true}]
                 [--enable-encryption {false, true}]
                 [--enable-key-vault-credential {false, true}]
                 [--enable-r-services {false, true}]
                 [--force-string]
                 [--full-backup-duration]
                 [--full-backup-frequency {Daily, Weekly}]
                 [--full-backup-start-hour]
                 [--ids]
                 [--image-sku {Developer, Enterprise, Express, Standard, Web}]
                 [--key-vault]
                 [--least-privilege-mode {Enabled, NotSet}]
                 [--license-type {AHUB, DR, PAYG}]
                 [--log-backup-frequency]
                 [--maintenance-window-duration]
                 [--maintenance-window-start-hour]
                 [--name]
                 [--port]
                 [--remove]
                 [--resource-group]
                 [--retention-period]
                 [--sa-key]
                 [--set]
                 [--sp-name]
                 [--sp-secret]
                 [--sql-mgmt-type {Full, LightWeight, NoAgent}]
                 [--sql-workload-type {DW, GENERAL, OLTP}]
                 [--storage-account]
                 [--subscription]
                 [--tags]
                 [--workspace-name]
                 [--workspace-rg]
                 [--workspace-sub]
                 [--yes]

예제

태그를 추가하거나 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --set tags.tagName=tagValue

태그를 제거합니다.

az sql vm update -n sqlvm -g myresourcegroup --remove tags.tagName

특정 sku 형식으로 SQL 가상 머신을 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --image-sku Enterprise

LIGHTWeight에서 Full로 SQL 가상 머신 관리 기능을 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --sql-mgmt-type Full

SQL 가상 머신을 최소 권한 모드로 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --least-privilege-mode Enabled --sql-mgmt-type Full

SQL 가상 머신 자동 백업 설정을 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --backup-schedule-type manual --full-backup-frequency Weekly --full-backup-start-hour 2 --full-backup-duration 2 --sa-key {storageKey} --storage-account 'https://storageacc.blob.core.windows.net/' --retention-period 30 --log-backup-frequency 60

SQL 가상 머신 자동 백업 설정을 사용하지 않도록 설정합니다.

az sql vm update -n sqlvm -g myresourcegroup --enable-auto-backup false

SQL 가상 머신 자동 패치 설정을 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --day-of-week sunday --maintenance-window-duration 60 --maintenance-window-start-hour 2

SQL 가상 머신 자동 패치 설정을 사용하지 않도록 설정합니다.

az sql vm update -n sqlvm -g myresourcegroup --enable-auto-patching false

SQL 가상 머신 청구 태그를 AHUB로 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --license-type AHUB

SQL 가상 머신 청구 태그를 DR로 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --license-type DR

SQL 모범 사례 평가를 사용하지 않도록 SQL 가상 머신을 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment false

SQL 모범 사례 평가 일정을 사용하지 않도록 SQL 가상 머신을 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment-schedule false

VM이 Log Analytics 작업 영역과 이미 연결된 경우 SQL 모범 사례 평가에 대한 주간 간격으로 일정을 사용하도록 SQL 가상 머신을 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --assessment-weekly-interval 1 --assessment-day-of-week monday --assessment-start-time-local '19:30'

Log Analytics 작업 영역과 연결하고 에이전트 리소스에 대한 리소스 그룹을 할당하는 동안 SQL 모범 사례 평가에 대한 월별 발생 일정을 사용하도록 SQL 가상 머신을 업데이트합니다.

az sql vm update -n sqlvm -g myresourcegroup --workspace-name myLogAnalyticsWorkspace --workspace-rg myRg --agent-rg myRg2 --assessment-monthly-occurrence 1 --assessment-day-of-week monday --assessment-start-time-local '19:30'

요청 시 평가를 실행하기 위한 일정을 설정하지 않고 SQL 모범 사례 평가를 사용하도록 SQL 가상 머신을 업데이트합니다. 에이전트 리소스를 배포하기 위한 Log Analytics 작업 영역 및 리소스 그룹을 제공해야 합니다.

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment true --workspace-name myLogAnalyticsWorkspace --workspace-rg myRg --agent-rg myRg2

다른 구독의 Log Analytics 작업 영역과 연결하면서 SQL 모범 사례 평가를 사용하도록 SQL 가상 머신 업데이트

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment true --workspace-name myLogAnalyticsWorkspace --workspace-rg myRg --workspace-sub myLogAnalyticsWorkspaceSubName --agent-rg myRg2

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>

Default value: []
--agent-rg

AMA 리소스 DCE 및 DCR을 포함하는 리소스 그룹입니다.

--am-day --assessment-day-of-week

평가를 실행하는 요일입니다.

허용되는 값: Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday
--am-month-occ --assessment-monthly-occurrence

평가를 예약하기 위해 한 달 이내에 DayOfWeek 일 발생 값 1,2,3,4 및 -1을 지원합니다. 월의 마지막 DayOfWeek 일(예: 월의 마지막 화요일)에 -1을 사용합니다.

허용되는 값: -1, 1, 2, 3, 4
--am-schedule --enable-assessment-schedule

평가 일정을 사용하거나 사용하지 않도록 설정합니다. 평가 일정 설정이 제공되면 매개 변수가 자동으로 true로 설정됩니다.

허용되는 값: false, true
--am-time --assessment-start-time-local

HH:mm 형식의 하루 중 시간입니다. 예를 들어 17:30, 05:13이 있습니다.

--am-week-int --assessment-weekly-interval

2개의 평가 실행 사이에 예약할 주 수입니다. 1-6의 값을 지원합니다.

허용되는 값: 1, 2, 3, 4, 5, 6
--backup-pwd

백업에서 암호화에 대한 암호입니다.

--backup-schedule-type

백업 일정 유형입니다.

허용되는 값: Automated, Manual
--backup-system-dbs

백업에 시스템 데이터베이스를 포함합니다.

허용되는 값: false, true
Default value: False
--connectivity-type

SQL Server 연결 옵션입니다.

허용되는 값: LOCAL, PRIVATE, PUBLIC
--credential-name

자격 증명 이름입니다.

--day-of-week

패치를 적용할 요일입니다.

허용되는 값: Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday
--enable-assessment

평가 기능을 사용하거나 사용하지 않도록 설정합니다. 평가 설정이 제공되면 매개 변수가 자동으로 true로 설정됩니다.

허용되는 값: false, true
--enable-auto-backup

SQL 가상 머신에서 자동 복구를 사용하거나 사용하지 않도록 설정합니다. 백업 설정이 제공되면 매개 변수가 자동으로 true로 설정됩니다.

허용되는 값: false, true
--enable-auto-patching

SQL 가상 머신에서 자동 패치를 사용하거나 사용하지 않도록 설정합니다. 자동 패치 설정이 제공되면 매개 변수가 자동으로 true로 설정됩니다.

허용되는 값: false, true
--enable-encryption

SQL 가상 머신에서 백업에 암호화를 사용하도록 설정합니다.

허용되는 값: false, true
Default value: False
--enable-key-vault-credential

키 자격 증명 모음 자격 증명 설정을 사용하거나 사용하지 않도록 설정합니다. 키 자격 증명 모음 설정이 제공되면 매개 변수가 자동으로 true로 설정됩니다.

허용되는 값: false, true
--enable-r-services

R 서비스를 사용하거나 사용하지 않도록 설정합니다(SQL 2016 이상).

허용되는 값: false, true
--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

Default value: False
--full-backup-duration

전체 백업이 수행될 수 있는 지정된 날의 시간 기간입니다. 1-23시간.

--full-backup-frequency

전체 백업의 빈도입니다. 두 경우 모두 전체 백업은 예약된 다음 기간 동안 시작됩니다.

허용되는 값: Daily, Weekly
--full-backup-start-hour

전체 백업이 수행될 수 있는 지정된 날의 시작 시간입니다. 0-23시간

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--image-sku

SQL 이미지 sku.

허용되는 값: Developer, Enterprise, Express, Standard, Web
--key-vault

Azure Key Vault URL입니다.

--least-privilege-mode

SQL IaaS 에이전트 최소 권한 모드입니다. sysadmin에서 기능별로 사용되는 특정 권한으로 업데이트.

허용되는 값: Enabled, NotSet
--license-type -i

SQL Server 라이선스 유형입니다.

허용되는 값: AHUB, DR, PAYG
--log-backup-frequency

로그 백업의 빈도입니다. 5-60분.

--maintenance-window-duration

패치 기간입니다. 30-180분.

--maintenance-window-start-hour

패치가 시작되는 하루 중 시간입니다. 로컬 VM 시간 0-23시간

--name -n

SQL 가상 머신의 이름입니다.

--port

SQL Server 포트입니다.

--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--retention-period

백업 보존 기간입니다. 1-30일.

--sa-key

백업이 수행될 스토리지 계정 키입니다.

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>

Default value: []
--sp-name

키 자격 증명 모음에 액세스할 서비스 주체 이름입니다.

--sp-secret

키 자격 증명 모음에 액세스하기 위한 서비스 주체 이름 비밀입니다.

--sql-mgmt-type
사용되지 않음

'sql_management_mode' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

SQL Server 관리 유형입니다. 라이트급에서 풀로 업데이트.

허용되는 값: Full, LightWeight, NoAgent
--sql-workload-type

SQL Server 워크로드 유형입니다.

허용되는 값: DW, GENERAL, OLTP
--storage-account

백업이 수행될 스토리지 계정 URL입니다.

--subscription

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

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--workspace-name

VM과 연결할 Log Analytics 작업 영역의 이름입니다.

--workspace-rg

Log Analytics 작업 영역을 포함하는 리소스 그룹입니다.

--workspace-sub

Log Analytics 작업 영역을 포함하는 구독입니다.

--yes -y
사용되지 않음

인수 'prompt'는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

확인 메시지를 표시하지 않습니다. --sql-mgmt-type이 필요합니다.

Default value: True
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az sql vm validate-azure-ad-auth

클라이언트 쪽에서 SQL 가상 머신을 사용하도록 설정하지 않고 Azure AD 인증의 유효성을 검사합니다.

az sql vm validate-azure-ad-auth [--ids]
                                 [--msi-client-id]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]

예제

클라이언트 쪽에서 시스템 할당 관리 ID를 사용하여 Azure AD 인증의 유효성을 검사합니다.

az sql vm validate-azure-ad-auth -n sqlvm -g myresourcegroup

클라이언트 쪽에서 사용자 할당 관리 ID를 사용하여 Azure AD 인증의 유효성을 검사합니다.

az sql vm validate-azure-ad-auth -n sqlvm -g myresourcegroup --msi-client-id 12345678

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--msi-client-id

Virutal Machine 관리 ID 클라이언트 ID입니다.

--name -n

SQL 가상 머신의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.