az cloud-service

참고

이 참조는 Azure CLI 대한 클라우드 서비스 확장의 일부이며 버전 2.15.0 이상에 필요합니다. az cloud-service 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

클라우드 서비스(확장 지원)를 관리합니다.

명령

az cloud-service create

클라우드 서비스(확장 지원)를 만듭니다. 일부 속성은 클라우드 서비스를 만드는 동안에만 설정할 수 있습니다.

az cloud-service delete

클라우드 서비스를 삭제합니다.

az cloud-service delete-instance

클라우드 서비스에서 역할 인스턴스를 삭제합니다.

az cloud-service list

리소스 그룹 아래의 모든 클라우드 서비스 목록을 확인합니다.

az cloud-service list-all

연결된 리소스 그룹에 관계없이 구독의 모든 클라우드 서비스 목록을 확인합니다.

az cloud-service power-off

클라우드 서비스의 전원을 끄기. 리소스는 여전히 연결되어 있으며 리소스에 대한 요금이 청구됩니다.

az cloud-service rebuild

역할 인스턴스를 다시 빌드합니다. 웹 역할 또는 작업자 역할의 인스턴스에 운영 체제를 다시 설치하고 사용하는 스토리지 리소스를 초기화합니다. 스토리지 리소스를 초기화하지 않으려면 역할 인스턴스 이미지 다시 추가를 사용할 수 있습니다.

az cloud-service reimage

비동기 이미지 다시 설치 작업은 웹 역할 또는 작업자 역할의 인스턴스에 운영 체제를 다시 설치합니다.

az cloud-service restart

클라우드 서비스에서 하나 이상의 역할 인스턴스를 다시 시작합니다.

az cloud-service role

클라우드 서비스를 통해 클라우드 서비스 역할을 관리합니다.

az cloud-service role list

클라우드 서비스의 모든 역할 목록을 확인합니다.

az cloud-service role show

클라우드 서비스에서 역할을 얻습니다.

az cloud-service role-instance

클라우드 서비스를 사용 하 여 클라우드 서비스 역할 인스턴스를 관리 합니다.

az cloud-service role-instance delete

클라우드 서비스에서 역할 인스턴스를 삭제 합니다.

az cloud-service role-instance list

클라우드 서비스의 모든 역할 인스턴스 목록을 가져옵니다.

az cloud-service role-instance rebuild

역할 인스턴스 다시 빌드 비동기 작업은 웹 역할 또는 작업자 역할의 인스턴스에 운영 체제를 다시 설치 하 고 해당 역할에 사용 되는 저장소 리소스를 초기화 합니다. 저장소 리소스를 초기화 하지 않으려면 이미지로 다시 설치 역할 인스턴스를 사용할 수 있습니다.

az cloud-service role-instance reimage

이미지로 다시 설치 역할 인스턴스 비동기 작업은 웹 역할 또는 작업자 역할의 인스턴스에 운영 체제를 다시 설치 합니다.

az cloud-service role-instance restart

역할 인스턴스 다시 부팅 비동기 작업은 클라우드 서비스에서 역할 인스턴스의 다시 부팅을 요청 합니다.

az cloud-service role-instance show

클라우드 서비스에서 역할 인스턴스를 가져옵니다.

az cloud-service role-instance show-instance-view

클라우드 서비스에서 역할 인스턴스의 런타임 상태에 대 한 정보를 검색 합니다.

az cloud-service role-instance show-remote-desktop-file

클라우드 서비스에서 역할 인스턴스에 대 한 원격 데스크톱 파일을 가져옵니다.

az cloud-service show

클라우드 서비스에 대한 정보를 표시합니다.

az cloud-service show-instance-view

클라우드 서비스의 상태를 확인합니다.

az cloud-service start

클라우드 서비스를 시작합니다.

az cloud-service update

클라우드 서비스를 업데이트합니다.

az cloud-service update-domain

클라우드 서비스를 통해 클라우드 서비스 업데이트 도메인을 관리합니다.

az cloud-service update-domain list-update-domain

클라우드 서비스의 모든 업데이트 도메인 목록을 확인합니다.

az cloud-service update-domain show-update-domain

클라우드 서비스의 지정된 업데이트 도메인을 확인합니다.

az cloud-service update-domain walk-update-domain

지정된 업데이트 도메인의 역할 인스턴스를 업데이트합니다.

az cloud-service wait

클라우드 서비스의 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az cloud-service create

클라우드 서비스(확장 지원)를 만듭니다. 일부 속성은 클라우드 서비스를 만드는 동안에만 설정할 수 있습니다.

az cloud-service create --cloud-service-name
                        --resource-group
                        [--configuration]
                        [--configuration-url]
                        [--extensions]
                        [--id]
                        [--lb]
                        [--location]
                        [--no-wait]
                        [--package-url]
                        [--roles]
                        [--secrets]
                        [--start-cloud-service {false, true}]
                        [--tags]
                        [--upgrade-mode {Auto, Manual, Simultaneous}]

예제

2개의 역할, 2개의 부하 분산기(하나는 공용 IP가 있고 다른 하나는 개인 IP가 있음), 비밀 및 확장을 사용하여 클라우드 서비스를 만듭니다.

az cloud-service create -g ResourceGroup -n CloudService --roles ContosoFrontend:Standard_D1_v2:1:Standard ContosoBackend:Standard_D1_v2:1:Standard --package-url PackageURL --configuration Config --load-balancer-configurations MyLoadBalancer:MyFe:PublicIP:: MyLoadBalancer2:MyFe2::SubnetIDd:PrivateIPID --secrets Vault0:Cert0:Cert1 Vault1:Cert2:Cert3:Cert4 --extensions "@extensions.json"

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--configuration

클라우드 서비스에 대한 XML 서비스 구성(.cscfg)을 지정합니다. 예상 값: xml-string/@xml-file .

--configuration-url

Blob service 서비스 구성의 위치를 참조하는 URL을 지정합니다. 서비스 패키지 URL은 모든 스토리지 계정의 SAS(공유 액세스 서명) URI일 수 있습니다. 이 속성은 쓰기 전용 속성이며 GET 호출에서 반환되지 않습니다.

--extensions

클라우드 서비스에 대한 확장 목록입니다. 예상 값: json-string/@json-file . 예: [{"properties": {"type": "RDP", "autoUpgradeMinorVersion": false, "protectedSettings": "settings","publisher": "Microsoft.Windows. Azure.Extensions", "settings": "settings", "typeHandlerVersion": "1.2.1"}, "name": "RDPExtension"}].

--id

리소스 ID입니다.

--lb --load-balancer-configurations

클라우드 서비스에 대한 공간으로 구분된 부하 분산기 구성 목록입니다. 공용 IP는 필수 필드입니다. 형식: LBName:FrontendIPConfiguration:PublicIPAddress:Subnet:PrivateIP.

--location -l

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

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--package-url

Blob service 서비스 패키지의 위치를 참조하는 URL을 지정합니다. 서비스 패키지 URL은 모든 스토리지 계정의 SAS(공유 액세스 서명) URI일 수 있습니다. 이 속성은 쓰기 전용 속성이며 GET 호출에서 반환되지 않습니다.

--roles

클라우드 서비스에 대한 공간으로 구분된 역할 목록입니다. 형식: RoleName:SkuName:SkuCapacity:SkuTier.

--secrets

역할 인스턴스에 설치해야 하는 공간으로 구분된 인증서를 지정합니다. 형식: KeyVaultName:CertificateUrl:CertificateUrl2:...:CertificateUrlN.

--start-cloud-service

클라우드 서비스를 만든 직후에 시작할지 여부를 나타냅니다. 기본값은 true입니다. false이면 서비스 모델이 계속 배포되지만 코드가 즉시 실행되지는 않습니다. 대신 서비스를 시작할 때 Start를 호출할 때까지 서비스는 PoweredOff입니다. 배포된 서비스는 전원이 공급되더라도 요금이 계속 부과됩니다.

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

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

--upgrade-mode

클라우드 서비스에 대한 업데이트 모드입니다. 서비스가 배포될 때 업데이트 도메인에 역할 인스턴스가 할당됩니다. 업데이트는 각 업데이트 도메인에서 수동으로 시작되거나 모든 업데이트 도메인에서 자동으로 시작될 수 있습니다. 가능한 값은 자동, 수동, 동시입니다. 지정하지 않으면 기본값은 Auto입니다. 수동으로 설정하면 PUT UpdateDomain을 호출하여 업데이트를 적용해야 합니다. Auto로 설정하면 업데이트가 각 업데이트 도메인에 순서대로 자동으로 적용됩니다.

허용되는 값: Auto, Manual, Simultaneous

az cloud-service delete

클라우드 서비스를 삭제합니다.

az cloud-service delete --cloud-service-name
                        --resource-group
                        [--no-wait]
                        [--yes]

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--yes -y

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

az cloud-service delete-instance

클라우드 서비스에서 역할 인스턴스를 삭제합니다.

az cloud-service delete-instance --cloud-service-name
                                 --resource-group
                                 [--no-wait]
                                 [--role-instances]
                                 [--yes]

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--role-instances

클라우드 서비스 역할 인스턴스 이름 목록입니다. '' * 값은 클라우드 서비스의 모든 역할 인스턴스를 의미합니다.

--yes -y

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

az cloud-service list

리소스 그룹 아래의 모든 클라우드 서비스 목록을 확인합니다.

az cloud-service list --resource-group

필수 매개 변수

--resource-group -g

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

az cloud-service list-all

연결된 리소스 그룹에 관계없이 구독의 모든 클라우드 서비스 목록을 확인합니다.

az cloud-service list-all

az cloud-service power-off

클라우드 서비스의 전원을 끄기. 리소스는 여전히 연결되어 있으며 리소스에 대한 요금이 청구됩니다.

az cloud-service power-off --cloud-service-name
                           --resource-group
                           [--no-wait]

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

az cloud-service rebuild

역할 인스턴스를 다시 빌드합니다. 웹 역할 또는 작업자 역할의 인스턴스에 운영 체제를 다시 설치하고 사용하는 스토리지 리소스를 초기화합니다. 스토리지 리소스를 초기화하지 않으려면 역할 인스턴스 이미지 다시 추가를 사용할 수 있습니다.

az cloud-service rebuild --cloud-service-name
                         --resource-group
                         [--no-wait]
                         [--role-instances]

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--role-instances

클라우드 서비스 역할 인스턴스 이름 목록입니다. '' * 값은 클라우드 서비스의 모든 역할 인스턴스를 의미합니다.

az cloud-service reimage

비동기 이미지 다시 설치 작업은 웹 역할 또는 작업자 역할의 인스턴스에 운영 체제를 다시 설치합니다.

az cloud-service reimage --cloud-service-name
                         --resource-group
                         [--no-wait]
                         [--role-instances]

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--role-instances

클라우드 서비스 역할 인스턴스 이름 목록입니다. '' * 값은 클라우드 서비스의 모든 역할 인스턴스를 의미합니다.

az cloud-service restart

클라우드 서비스에서 하나 이상의 역할 인스턴스를 다시 시작합니다.

az cloud-service restart --cloud-service-name
                         --resource-group
                         [--no-wait]
                         [--role-instances]

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--role-instances

클라우드 서비스 역할 인스턴스 이름 목록입니다. '' * 값은 클라우드 서비스의 모든 역할 인스턴스를 의미합니다.

az cloud-service show

클라우드 서비스에 대한 정보를 표시합니다.

az cloud-service show --cloud-service-name
                      --resource-group

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

az cloud-service show-instance-view

클라우드 서비스의 상태를 확인합니다.

az cloud-service show-instance-view --cloud-service-name
                                    --resource-group

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

az cloud-service start

클라우드 서비스를 시작합니다.

az cloud-service start --cloud-service-name
                       --resource-group
                       [--no-wait]

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

az cloud-service update

클라우드 서비스를 업데이트합니다.

az cloud-service update --cloud-service-name
                        --resource-group
                        [--no-wait]
                        [--tags]

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--tags

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

az cloud-service wait

클라우드 서비스의 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az cloud-service wait --cloud-service-name
                      --resource-group
                      [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--interval]
                      [--timeout]
                      [--updated]

필수 매개 변수

--cloud-service-name --name -n

클라우드 서비스의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 통해 생성될 때까지 기다립니다.

--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예를 들어 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

--exists

리소스가 존재할 때까지 기다립니다.

--interval

폴링 간격(초)입니다.

기본값: 30
--timeout

최대 대기 시간(초)입니다.

기본값: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.