az desktopvirtualization hostpool

참고

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

Desktopvirtualization hostpool.

명령

az desktopvirtualization hostpool create

호스트 풀을 만듭니다.

az desktopvirtualization hostpool delete

호스트 풀을 제거합니다.

az desktopvirtualization hostpool list

구독에 hostPools를 나열합니다.

az desktopvirtualization hostpool retrieve-registration-token

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

az desktopvirtualization hostpool show

호스트 풀을 가져옵니다.

az desktopvirtualization hostpool update

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

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 {false, true}]
                                         [--tags]
                                         [--validation-environment {false, true}]
                                         [--vm-template]

예제

HostPool_Create

az desktopvirtualization hostpool create --location "centralus" --description "des1" --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="2020-10-01T14:01:54.9571247Z" registration-token-operation="Update" --sso-client-id "client" --sso-client-secret-key-vault-path "https://keyvault/secret" --sso-secret-type "SharedKey" --ssoadfs-authority "https://adfs" --start-vm-on-connect false --vm-template "{json:json}" --tags tag1="value1" tag2="value2" --name "MyHostPool" --resource-group "MyResourceGroup"

필수 매개 변수

--host-pool-type

데스크톱용 HostPool 유형입니다.

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

HostPool의 사용자 지정 rdp 속성입니다.

--description

HostPool에 대한 설명입니다.

--friendly-name

HostPool의 이름입니다.

--location -l

위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--max-session-limit

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

--personal-desktop-assignment-type

HostPool에 대한 PersonalDesktopAssignment 유형입니다.

허용되는 값: Automatic, Direct
--registration-info

HostPool의 등록 정보입니다.

--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 기능을 설정/해제할 플래그입니다.

허용되는 값: false, true
--tags

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

--validation-environment

유효성 검사 환경입니다.

허용되는 값: false, true
--vm-template

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

az desktopvirtualization hostpool delete

호스트 풀을 제거합니다.

az desktopvirtualization hostpool delete --name
                                         --resource-group
                                         [--force {false, true}]

예제

HostPool_Delete

az desktopvirtualization hostpool delete --force true --name "MyHostPool" --resource-group "MyResourceGroup"

필수 매개 변수

--name -n

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

--resource-group -g

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

선택적 매개 변수

--force

sessionHost를 삭제하려면 플래그를 강제 적용합니다.

허용되는 값: false, true

az desktopvirtualization hostpool list

구독에 hostPools를 나열합니다.

az desktopvirtualization hostpool list [--resource-group]

예제

HostPool_ListByResourceGroup

az desktopvirtualization hostpool list --resource-group "MyResourceGroup"

선택적 매개 변수

--resource-group -g

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

az desktopvirtualization hostpool retrieve-registration-token

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

az desktopvirtualization hostpool retrieve-registration-token --name
                                                              --resource-group

예제

HostPools_RetrieveRegistrationToken_Post

az desktopvirtualization hostpool retrieve-registration-token --name "MyHostPool" --resource-group "MyResourceGroup"

필수 매개 변수

--name -n

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

--resource-group -g

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

az desktopvirtualization hostpool show

호스트 풀을 가져옵니다.

az desktopvirtualization hostpool show --name
                                       --resource-group

예제

HostPool_Get

az desktopvirtualization hostpool show --name "MyHostPool" --resource-group "MyResourceGroup"

필수 매개 변수

--name -n

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

--resource-group -g

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

az desktopvirtualization hostpool update

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

az desktopvirtualization hostpool update --name
                                         --resource-group
                                         [--custom-rdp-property]
                                         [--description]
                                         [--friendly-name]
                                         [--load-balancer-type {BreadthFirst, DepthFirst, Persistent}]
                                         [--max-session-limit]
                                         [--personal-desktop-assignment-type {Automatic, Direct}]
                                         [--preferred-app-group-type {Desktop, None, RailApplications}]
                                         [--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 {false, true}]
                                         [--tags]
                                         [--validation-environment {false, true}]
                                         [--vm-template]

예제

HostPool_Update

az desktopvirtualization hostpool update --description "des1" --friendly-name "friendly" --load-balancer-type "BreadthFirst" --max-session-limit 999999 --personal-desktop-assignment-type "Automatic" --registration-info expiration-time="2020-10-01T15:01:54.9571247Z" registration-token-operation="Update" --sso-client-id "client" --sso-client-secret-key-vault-path "https://keyvault/secret" --sso-secret-type "SharedKey" --ssoadfs-authority "https://adfs" --start-vm-on-connect false --vm-template "{json:json}" --tags tag1="value1" tag2="value2" --name "MyHostPool" --resource-group "MyResourceGroup"

필수 매개 변수

--name -n

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

--resource-group -g

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

선택적 매개 변수

--custom-rdp-property

HostPool의 사용자 지정 rdp 속성입니다.

--description

HostPool에 대한 설명입니다.

--friendly-name

HostPool의 이름입니다.

--load-balancer-type

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

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

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

--personal-desktop-assignment-type

HostPool에 대한 PersonalDesktopAssignment 유형입니다.

허용되는 값: Automatic, Direct
--preferred-app-group-type -t

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

허용되는 값: Desktop, None, RailApplications
--registration-info

HostPool의 등록 정보입니다.

--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 기능을 설정/해제할 플래그입니다.

허용되는 값: false, true
--tags

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

--validation-environment

유효성 검사 환경입니다.

허용되는 값: false, true
--vm-template

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