az desktopvirtualization hostpool

참고 항목

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

데스크톱 가상화 호스트 풀을 관리합니다.

명령

Name	Description	형식	상태
az desktopvirtualization hostpool create	호스트 풀을 만듭니다.	내선 번호	GA
az desktopvirtualization hostpool delete	호스트 풀을 삭제합니다.	내선 번호	GA
az desktopvirtualization hostpool list	호스트 풀을 나열합니다.	내선 번호	GA
az desktopvirtualization hostpool retrieve-registration-token	호스트 풀의 등록 토큰입니다.	내선 번호	GA
az desktopvirtualization hostpool show	호스트 풀을 표시합니다.	내선 번호	GA
az desktopvirtualization hostpool update	호스트 풀을 업데이트합니다.	내선 번호	GA

az desktopvirtualization hostpool create

호스트 풀을 만듭니다.

az desktopvirtualization hostpool create --host-pool-type {BYODesktop, Personal, Pooled}
                                         --load-balancer-type {BreadthFirst, DepthFirst, Persistent}
                                         --name
                                         --preferred-app-group-type {Desktop, None, RailApplications}
                                         --resource-group
                                         [--custom-rdp-property]
                                         [--description]
                                         [--friendly-name]
                                         [--location]
                                         [--max-session-limit]
                                         [--personal-desktop-assignment-type {Automatic, Direct}]
                                         [--registration-info]
                                         [--ring]
                                         [--sso-client-id]
                                         [--sso-client-secret-key-vault-path]
                                         [--sso-secret-type {Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault}]
                                         [--ssoadfs-authority]
                                         [--start-vm-on-connect {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--tags]
                                         [--validation-environment {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--vm-template]

예제

호스트 풀 만들기

az desktopvirtualization hostpool create -g rg -n hostpool-name --friendly-name friendly --host-pool-type Pooled --load-balancer-type BreadthFirst --max-session-limit 999999 --personal-desktop-assignment-type Automatic --preferred-app-group-type Desktop --registration-info expiration-time="yyyy-mm-ddT08:38:08.189Z" registration-token-operation=Update --sso-client-id client --sso-client-secret-key-vault-path https://keyvault/secret --sso-secret-type SharedKey --start-vm-on-connect false

필수 매개 변수

--host-pool-type

데스크톱의 호스트 풀 유형입니다.

허용되는 값: BYODesktop, Personal, Pooled

--load-balancer-type

부하 분산 장치의 유형입니다.

허용되는 값: BreadthFirst, DepthFirst, Persistent

--name -n

지정된 리소스 그룹 내의 호스트 풀 이름입니다.

--preferred-app-group-type -t

기본 설정 애플리케이션 그룹 유형의 유형으로, 기본적으로 데스크톱 애플리케이션 그룹입니다.

허용되는 값: Desktop, None, RailApplications

--resource-group -g

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

선택적 매개 변수

--custom-rdp-property

호스트 풀의 사용자 지정 rdp 속성입니다.

--description

HostPool에 대한 설명입니다.

--friendly-name

HostPool의 이름입니다.

--location -l

리소스가 있는 지리적 위치입니다.

--max-session-limit

HostPool의 최대 세션 제한입니다.

--personal-desktop-assignment-type

HostPool의 PersonalDesktopAssignment 유형입니다.

허용되는 값: Automatic, Direct

--registration-info

HostPool의 등록 정보입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--ring

HostPool의 링 번호입니다.

--sso-client-id

WVD SSO 인증서를 발급하는 데 사용되는 등록된 신뢰 당사자에 대한 ClientId입니다.

--sso-client-secret-key-vault-path -p

ADFS에 대한 통신에 사용되는 비밀을 저장하는 Azure KeyVault 경로입니다.

--sso-secret-type

Single Sign-On 비밀 형식의 형식입니다.

허용되는 값: Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault

--ssoadfs-authority

WVD SSO 인증서에 서명하기 위한 고객 ADFS 서버에 대한 URL입니다.

--start-vm-on-connect

StartVMOn커넥트 기능을 설정/해제할 플래그입니다.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes

--tags

리소스 태그. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--validation-environment

유효성 검사 환경입니다.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes

--vm-template

hostpool 내에서 sessionhosts 구성을 위한 VM 템플릿입니다.

전역 매개 변수

--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

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

--subscription

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

--verbose

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

az desktopvirtualization hostpool delete

호스트 풀을 삭제합니다.

az desktopvirtualization hostpool delete [--force {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--ids]
                                         [--name]
                                         [--resource-group]
                                         [--subscription]
                                         [--yes]

예제

호스트 풀 삭제

az desktopvirtualization hostpool delete -g rg -n hostpool-name

선택적 매개 변수

--force

sessionHost를 삭제하도록 플래그를 강제 적용합니다.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes

--ids

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

--name -n

지정된 리소스 그룹 내의 호스트 풀 이름입니다.

--resource-group -g

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

--subscription

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

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

기본값: False

전역 매개 변수

--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

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

--subscription

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

--verbose

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

az desktopvirtualization hostpool list

호스트 풀을 나열합니다.

az desktopvirtualization hostpool list [--max-items]
                                       [--next-token]
                                       [--resource-group]

예제

호스트 풀 나열

az desktopvirtualization hostpool list -g rg

선택적 매개 변수

--max-items

명령의 출력에서 반환할 총 항목 수입니다. 사용 가능한 총 항목 수가 지정된 값보다 많으면 명령의 출력에 토큰이 제공됩니다. 페이지 매김을 다시 시작하려면 후속 명령의 인수에 --next-token 토큰 값을 제공합니다.

--next-token

페이지 매김을 시작할 위치를 지정하는 토큰입니다. 이는 이전에 잘린 응답의 토큰 값입니다.

--resource-group -g

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

전역 매개 변수

--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

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

--subscription

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

--verbose

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

az desktopvirtualization hostpool retrieve-registration-token

호스트 풀의 등록 토큰입니다.

az desktopvirtualization hostpool retrieve-registration-token [--ids]
                                                              [--name]
                                                              [--resource-group]
                                                              [--subscription]

예제

호스트 풀의 등록 토큰입니다.

az desktopvirtualization hostpool retrieve-registration-token -n hostpool-name -g rg

선택적 매개 변수

--ids

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

--name -n

지정된 리소스 그룹 내의 호스트 풀 이름입니다.

--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

기본값: json

--query

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

--subscription

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

--verbose

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

az desktopvirtualization hostpool show

호스트 풀을 표시합니다.

az desktopvirtualization hostpool show [--ids]
                                       [--name]
                                       [--resource-group]
                                       [--subscription]

예제

호스트 풀 표시

az desktopvirtualization hostpool show -g rg -n hostpool-name

선택적 매개 변수

--ids

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

--name -n

지정된 리소스 그룹 내의 호스트 풀 이름입니다.

--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

기본값: json

--query

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

--subscription

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

--verbose

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

az desktopvirtualization hostpool update

호스트 풀을 업데이트합니다.

az desktopvirtualization hostpool update [--add]
                                         [--custom-rdp-property]
                                         [--description]
                                         [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--friendly-name]
                                         [--ids]
                                         [--load-balancer-type {BreadthFirst, DepthFirst, Persistent}]
                                         [--max-session-limit]
                                         [--name]
                                         [--personal-desktop-assignment-type {Automatic, Direct}]
                                         [--preferred-app-group-type {Desktop, None, RailApplications}]
                                         [--registration-info]
                                         [--remove]
                                         [--resource-group]
                                         [--ring]
                                         [--set]
                                         [--sso-client-id]
                                         [--sso-client-secret-key-vault-path]
                                         [--sso-secret-type {Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault}]
                                         [--ssoadfs-authority]
                                         [--start-vm-on-connect {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--subscription]
                                         [--tags]
                                         [--validation-environment {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--vm-template]

예제

호스트 풀 업데이트

az desktopvirtualization hostpool update -g rg -n hostpool-name --tags tag=test

선택적 매개 변수

--add

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

--custom-rdp-property

호스트 풀의 사용자 지정 rdp 속성입니다.

--description

HostPool에 대한 설명입니다.

--force-string

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

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes

--friendly-name

HostPool의 이름입니다.

--ids

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

--load-balancer-type

부하 분산 장치의 유형입니다.

허용되는 값: BreadthFirst, DepthFirst, Persistent

--max-session-limit

HostPool의 최대 세션 제한입니다.

--name -n

지정된 리소스 그룹 내의 호스트 풀 이름입니다.

--personal-desktop-assignment-type

HostPool의 PersonalDesktopAssignment 유형입니다.

허용되는 값: Automatic, Direct

--preferred-app-group-type -t

기본 설정 애플리케이션 그룹 유형의 유형으로, 기본적으로 데스크톱 애플리케이션 그룹입니다.

허용되는 값: Desktop, None, RailApplications

--registration-info

HostPool의 등록 정보입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--remove

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

--resource-group -g

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

--ring

HostPool의 링 번호입니다.

--set

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

--sso-client-id

WVD SSO 인증서를 발급하는 데 사용되는 등록된 신뢰 당사자에 대한 ClientId입니다.

--sso-client-secret-key-vault-path -p

ADFS에 대한 통신에 사용되는 비밀을 저장하는 Azure KeyVault 경로입니다.

--sso-secret-type

Single Sign-On 비밀 형식의 형식입니다.

허용되는 값: Certificate, CertificateInKeyVault, SharedKey, SharedKeyInKeyVault

--ssoadfs-authority

WVD SSO 인증서에 서명하기 위한 고객 ADFS 서버에 대한 URL입니다.

--start-vm-on-connect

StartVMOn커넥트 기능을 설정/해제할 플래그입니다.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes

--subscription

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

--tags

리소스 태그. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--validation-environment

유효성 검사 환경입니다.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes

--vm-template

hostpool 내에서 sessionhosts 구성을 위한 VM 템플릿입니다.

전역 매개 변수

--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

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

--subscription

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

--verbose

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