다음을 통해 공유


az desktopvirtualization hostpool

Note

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

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

명령

Name Description 형식 상태
az desktopvirtualization hostpool create

호스트 풀을 만듭니다.

Extension GA
az desktopvirtualization hostpool delete

호스트 풀을 삭제합니다.

Extension GA
az desktopvirtualization hostpool list

호스트 풀을 나열합니다.

Extension GA
az desktopvirtualization hostpool retrieve-registration-token

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

Extension GA
az desktopvirtualization hostpool show

호스트 풀을 표시합니다.

Extension GA
az desktopvirtualization hostpool update

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

Extension 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>사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

StartVMOnConnect 기능을 설정/해제할 플래그입니다.

속성
허용되는 값: 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

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

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

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--force

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

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

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

속성
Parameter group: Resource Id Arguments
--name -n

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

속성
Parameter group: Resource Id Arguments
--resource-group -g

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

속성
Parameter group: Resource Id Arguments
--subscription

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

속성
Parameter group: Resource Id Arguments
--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/ 참조하세요.

--verbose

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

속성
Default value: False

az desktopvirtualization hostpool list

호스트 풀을 나열합니다.

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

예제

호스트 풀 나열

az desktopvirtualization hostpool list -g rg

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--max-items

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

속성
Parameter group: Pagination Arguments
--next-token

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

속성
Parameter group: Pagination Arguments
--resource-group -g

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

전역 매개 변수
--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 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

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

속성
Parameter group: Resource Id Arguments
--name -n

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

속성
Parameter group: Resource Id Arguments
--resource-group -g

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

속성
Parameter group: Resource Id Arguments
--subscription

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

속성
Parameter group: Resource Id Arguments
전역 매개 변수
--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/ 참조하세요.

--verbose

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

속성
Default value: False

az desktopvirtualization hostpool show

호스트 풀을 표시합니다.

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

예제

호스트 풀 표시

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

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

속성
Parameter group: Resource Id Arguments
--name -n

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

속성
Parameter group: Resource Id Arguments
--resource-group -g

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

속성
Parameter group: Resource Id Arguments
--subscription

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

속성
Parameter group: Resource Id Arguments
전역 매개 변수
--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/ 참조하세요.

--verbose

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

속성
Default value: False

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

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--add

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

속성
Parameter group: Generic Update Arguments
--custom-rdp-property

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

--description

HostPool에 대한 설명입니다.

--force-string

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

속성
Parameter group: Generic Update Arguments
허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--friendly-name

HostPool의 이름입니다.

--ids

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

속성
Parameter group: Resource Id Arguments
--load-balancer-type

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

속성
허용되는 값: BreadthFirst, DepthFirst, Persistent
--max-session-limit

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

--name -n

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

속성
Parameter group: Resource Id Arguments
--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 <indexToRemove> OR --remove propertyToRemove.

속성
Parameter group: Generic Update Arguments
--resource-group -g

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

속성
Parameter group: Resource Id Arguments
--ring

HostPool의 링 번호입니다.

--set

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

속성
Parameter group: Generic Update Arguments
--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

StartVMOnConnect 기능을 설정/해제할 플래그입니다.

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

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

속성
Parameter group: Resource Id Arguments
--tags

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

--validation-environment

유효성 검사 환경입니다.

속성
허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--vm-template

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

전역 매개 변수
--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/ 참조하세요.

--verbose

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

속성
Default value: False