다음을 통해 공유

Windows 365(미리 보기)

Windows 365는 최종 사용자를 위해 새로운 유형의 Windows 가상 머신(클라우드 PC)을 자동으로 만드는 클라우드 기반 서비스입니다. 각 클라우드 PC는 개별 사용자에게 전용 Windows 디바이스로 할당됩니다. Windows 365는 Microsoft 365의 생산성, 보안 및 공동 작업 이점을 제공합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate (파워 오토메이트) Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 Microsoft
URL https://powerautomate.microsoft.com/en-us/support/
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://www.microsoft.com/en-us/windows-365
개인 정보 보호 정책 https://privacy.microsoft.com/en-us/privacystatement
카테고리 IT 작업; 생산력

Windows 365 커넥터는 Microsoft Intune 환경 내에서 Windows 365 클라우드 PC 및 프로비저닝 정책을 관리하는 작업을 제공합니다. 이 커넥터를 사용하면 Power Automate 흐름을 통해 클라우드 PC 수명 주기 작업, 프로비전 정책 관리 및 관리 작업을 자동화할 수 있습니다.

서비스, 클래스 및 지역

서비스 클래스 Regions
Copilot Studio Premium 모든 Power Automate 지역
논리 앱 Premium 모든 Logic Apps 지역
Power Apps Premium 모든 Power Apps 지역
Power Automate (파워 오토메이트) Premium 모든 Power Automate 지역

연락처

연락처
이름 Windows 365
URL https://learn.microsoft.com/en-us/connectors/windows365
전자 메일 W365powerplatform@microsoft.com

필수 조건

이 커넥터를 사용하려면 다음이 필요합니다.

  • 조직의 Windows 365 라이선스
  • Microsoft Intune 구독
  • Windows 365 리소스를 관리하기 위한 Microsoft Intune RBAC(역할 기반 액세스 제어)의 충분한 권한
  • 적절한 권한이 있는 Azure AD 계정

필요한 권한

사용자에게는 다음 Intune RBAC 역할 중 하나가 있어야 합니다.

  • 글로벌 관리자
  • Intune 서비스 관리자
  • Windows365 관리자(클라우드 PC 관련 작업용)
  • Windows 365 권한이 있는 사용자 지정 역할(트리거 작업 필요 Webhook.Create 및 Webhook.Delete 필요)

중요: 이 커넥터에는 Windows 365 라이선스와 적절한 Microsoft Intune RBAC 권한이 필요합니다. 모든 작업은 Microsoft Graph API를 사용하며 Graph API 제한 제한의 적용을 받습니다.

알려진 문제 및 제한 사항

Windows 365 커넥터는 현재 공개 미리 보기로 제공됩니다.

Microsoft는 일반 공급으로 릴리스하기 전에 커넥터가 안정적인지 확인하려고 합니다. 그때까지 커넥터는 프리뷰 상태입니다. 프리뷰는 "있는 그대로", "모든 결함이 있는 상태로", "사용 가능한 상태로" 제공됩니다. SLA(서비스 수준 약정)에서 제외되지만 조기 액세스를 얻고 피드백을 제공할 수 있도록 프리뷰로 제공됩니다. 미리 보기 기능 및 이를 사용하도록 설정하는 방법에 대해 자세히 알아봅니다. 미리 보기는 고객 지원에서 다루지 않을 수 있습니다. 예고 없이 언제든지 중단될 수 있으며 일반 공급으로 출시되지 않을 수 있습니다.

미리 보기 커넥터를 사용해 보고 피드백을 제공할 것을 권장합니다. 이렇게 하면 커넥터를 안정화하고 개선하는 데 도움이 됩니다. 제품 포럼을 사용하여 문제와 피드백을 공유할 수 있습니다. 커넥터를 포함한 프리뷰 기능에 대해 Microsoft 지원이 제공되지 않을 수 있지만 최선을 다해 지원을 제공하도록 노력할 것입니다. 자세한 내용은 미리 보기 FAQ의 커넥터를 방문하세요.

일반 제한

  • 기능 및 제한 사항은 기본 Graph API와 일치합니다.
  • Graph 베타 엔드포인트에서 무언가를 호출해야 하는 경우 HTTP 요청 작업을 사용합니다.

활동

클라우드 PC 나열

작업 ID: ListCloudPCs

이 작업을 통해 클라우드 PC를 나열할 수 있습니다.

매개 변수

이름 필수 유형 Description
$select 아니오 문자열 $select 그래프에서 반환되는 속성을 선택할 수 있습니다.
$필터 아니오 문자열 $filter 사용하면 Graph에서 컬렉션의 하위 집합만 가져올 수 있습니다.

반환

이름 유형 Description
aadDeviceId String 클라우드 PC의 Microsoft Entra 디바이스 ID(Azure AD(Azure Active Directory) 디바이스 ID라고도 하며 GUID 형식으로 32자로 구성됩니다. Microsoft Entra ID에 조인된 VM에서 생성됩니다. 읽기 전용입니다.
diskEncryptionState String 디스크 암호화 상태를 표시합니다.
표시 이름 String 클라우드 PC의 표시 이름입니다. 최대 길이는 64자입니다. 읽기 전용입니다.
gracePeriodEndDateTime DateTimeOffset 유예 기간이 종료되고 다시 프로비전 또는 프로비전 해제가 발생하는 날짜와 시간입니다. 상태가 inGracePeriod인 경우에만 필요합니다. 타임스탬프는 ISO 8601 형식 및 UTC(협정 세계시)로 표시됩니다. 예를 들어 2014년 1월 1일 자정 UTC는 2014-01-01T00:00:00Z입니다.
아이디 String GUID 형식으로 32자로 구성된 고객용 클라우드 PC 엔터티의 고유 식별자입니다. 읽기 전용입니다.
imageDisplayName String 클라우드 PC에 사용되는 운영 체제 이미지의 이름입니다. 최대 길이는 50자입니다. 이 속성에는 문자(A-Z, a-z), 숫자(0-9) 및 특수 문자(-,_,.)만 허용됩니다. 속성 값은 밑줄로 시작하거나 끝낼 수 없습니다. 읽기 전용입니다.
lastModifiedDateTime DateTimeOffset 클라우드 PC의 마지막으로 수정된 날짜 및 시간입니다. 타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC로 표시됩니다. 예를 들어 2014년 1월 1일 자정 UTC는 2014-01-01T00:00:00Z입니다.
managedDeviceId String GUID 형식으로 32자로 구성된 클라우드 PC의 Intune 등록 디바이스 ID입니다. Windows 365 Business Cloud PC는 Windows 365에서 Intune에 자동으로 등록되지 않으므로 Windows 365 Business Cloud PC의 managedDeviceId 속성은 항상 null입니다. 읽기 전용입니다.
managedDeviceName String 클라우드 PC의 Intune 등록 디바이스 이름입니다. Windows 365 Business Cloud PC는 Windows 365에서 Intune에 자동으로 등록되지 않으므로 Windows 365 Business Cloud PC의 managedDeviceName 속성은 항상 null입니다. 읽기 전용입니다.
onPremisesConnectionName String 클라우드 PC를 프로비전하는 동안 적용된 온-프레미스 연결입니다. 읽기 전용입니다.
provisioningPolicyId String GUID 형식으로 32자로 구성된 클라우드 PC의 프로비저닝 정책 ID입니다. 정책은 사용자가 만들려는 클라우드 PC의 유형을 정의합니다. 읽기 전용입니다.
provisioningPolicyName String 클라우드 PC를 프로비전하는 동안 적용되는 프로비저닝 정책입니다. 최대 길이는 120자입니다. 읽기 전용입니다.
provisioningType String 프로비전 유형을 표시합니다.
servicePlanId String GUID 형식으로 32자로 구성된 클라우드 PC의 서비스 계획 ID입니다. 서비스 계획에 대한 자세한 내용은 라이선스에 대한 제품 이름 및 서비스 계획 식별자를 참조하세요. 읽기 전용입니다.
servicePlanName String 고객용 클라우드 PC 엔터티의 서비스 계획 이름입니다. 읽기 전용입니다.
servicePlanType String 계획 유형을 표시합니다.
userPrincipalName String 클라우드 PC에 할당된 사용자의 UPN(사용자 계정 이름)입니다. 최대 길이는 113자입니다. 사용자 이름 정책에 대한 자세한 내용은 Microsoft Entra ID의 암호 정책 및 계정 제한을 참조하세요. 읽기 전용입니다.

프로비저닝 정책 가져오기

작업 ID: GetProvisioningPoliciesV1

이 작업을 사용하면 프로비저닝 정책에 대한 정보를 반환할 수 있습니다.

매개 변수

이름 필수 유형 Description
$select 아니오 String $select 그래프에서 반환되는 속성을 선택할 수 있습니다.
$필터 아니오 String $filter 사용하면 Graph에서 컬렉션의 하위 집합만 가져올 수 있습니다.
$expand 아니오 String $expand Graph에서 관련 리소스를 반환할 수 있습니다.

반환

할당 값과 함께 $expand 사용하여 아래 반환된 값을 확인합니다.

이름 유형 Description
cloudPCNamingTemplate String 이 정책을 사용하여 프로비전된 클라우드 PC의 이름을 지정하는 데 사용되는 템플릿입니다. 템플릿에는 사용자 이름과 임의로 생성된 숫자를 나타내는 %USERNAME:x% 및 %RAND:x%포함하여 사용자 지정 텍스트 및 대체 토큰이 포함될 수 있습니다. 예를 들어 CPC-%USERNAME:4%-%RAND:5% 클라우드 PC의 이름은 CPC-로 시작하고 4자 사용자 이름, a - 문자 및 5개의 임의 문자가 잇는 것을 의미합니다. 템플릿에서 생성된 텍스트의 총 길이는 15자를 초과할 수 없습니다.
description String 프로비저닝 정책 설명입니다.
표시 이름 String 프로비저닝 정책의 표시 이름입니다.
domainJoinConfiguration cloudPcDomainJoinConfiguration 컬렉션 클라우드 PC가 Microsoft Entra ID(Azure AD)에 조인하는 방법에 대해 우선 순위에 따라 정렬된 목록을 지정합니다.
enableSingleSignOn 불리언 (Boolean) True이면 Single Sign-On으로 프로비전된 클라우드 PC에 액세스할 수 있습니다. False는 프로비전된 클라우드 PC가 이 기능을 지원하지 않음을 나타냅니다. 기본값은 false입니다. Windows 365 사용자는 Single Sign-On을 사용하여 암호 없는 옵션(예: FIDO 키)을 사용하여 Microsoft Entra ID에 인증하여 클라우드 PC에 액세스할 수 있습니다.
아이디 String 프로비저닝 정책과 연결된 고유 식별자입니다. 이 ID는 새 프로비저닝 정책을 만드는 동안 자동으로 채워집니다. 읽기 전용입니다.
imageDisplayName String 프로비전에 사용되는 운영 체제 이미지의 표시 이름입니다. 예를 들어 Windows 11 미리 보기 + Microsoft 365 앱 23H2 23H2입니다.
imageId String 새 클라우드 PC를 프로비전하는 데 사용되는 운영 체제 이미지를 나타내는 고유 식별자입니다. 갤러리 형식 이미지의 형식은 {publisherName_offerName_skuName}입니다. 각 매개 변수에 대해 지원되는 값은 게시자: Microsoftwindowsdesktop 제품: windows-ent-cpc sku: 21h1-ent-cpc-m365, 21h1-ent-cpc-os, 20h2-ent-cpc-m365, 20h2-ent-cpc-os, 20h1-ent-cpc-m365, 20h1-ent-cpc-os, 19h2-ent-cpc-m365 및 19h2-ent-cpc-os
이미지 유형 cloudPcProvisioningPolicyImageType 클라우드 PC에서 프로비전하는 데 사용되는 운영 체제 이미지(사용자 지정 또는 갤러리)의 유형입니다. 가능한 값은 갤러리, 사용자 지정입니다. 기본값은 갤러리입니다.

프로비저닝 정책 가져오기

작업 ID: GetAProvisioningPolicyV1

이 작업을 통해 특정 프로비저닝 정책의 세부 정보를 가져올 수 있습니다.

매개 변수

이름 필수 유형 Description
프로비저닝 정책 ID Yes String 프로비저닝 정책의 ID입니다. 포함해야 합니다.
$select 아니오 String $select 그래프에서 반환되는 속성을 선택할 수 있습니다.
$필터 아니오 String $filter 사용하면 Graph에서 컬렉션의 하위 집합만 가져올 수 있습니다.

반환

이 작업의 출력은 동적입니다.

프로비저닝 정책 만들기

작업 ID: CreateAProvisioningPolicyV1

이 작업을 통해 프로비저닝 정책을 만들 수 있습니다.

매개 변수

이름 필수 유형 Description
이름 Yes String 클라우드 PC를 프로비전하는 동안 적용되는 프로비저닝 정책입니다. 최대 길이는 120자입니다.
Description Yes String 프로비저닝 정책 설명입니다.
도메인 가입 구성 Yes
이미지 ID Yes String 클라우드 PC를 프로비전하는 데 사용할 이미지 ID입니다.
이미지 표시 이름 Yes String 클라우드 PC에 사용되는 운영 체제 이미지의 이름입니다. 최대 길이는 50자입니다. 이 속성에는 문자(A-Z, a-z), 숫자(0-9) 및 특수 문자(-,_,.)만 허용됩니다. 속성 값은 밑줄로 시작하거나 끝낼 수 없습니다.
이미지 형식 Yes String 사용자 지정 또는 갤러리.
프로비전 유형 Yes String 공유 또는 전용입니다.
Windows 설정/로캘 Yes String 사용하려는 언어/로캘을 제공합니다. Windows 365는 이러한 30개 이상의 언어/지역 쌍을 제공합니다.

고급 매개 변수 아래에 그래프의 다른 필드를 추가할 수도 있습니다.

반환

이 작업의 출력은 동적입니다.

그룹에 프로비저닝 정책 할당

작업 ID: AssignAProvisioningPolicyToAGroupV1

이 작업을 통해 프로비저닝 정책에 그룹을 할당할 수 있습니다.

매개 변수

이름 필수 유형 Description
프로비저닝 정책 ID Yes String 그룹을 할당하려는 프로비전 정책 ID입니다.
할당 – 대상 그룹 ID Yes String Entra ID의 사용자 그룹입니다.
할당 – 대상 ServicePlan ID 아니오 String 사용자를 위해 프로비전할 클라우드 PC의 크기를 나타내는 서비스 계획의 고유 식별자입니다.

반환

이 작업의 출력은 동적입니다.

프로비저닝 정책 업데이트

작업 ID: UpdateAProvisioningPolicyV1

이 작업을 통해 프로비저닝 정책을 업데이트할 수 있습니다.

매개 변수

이름 필수 유형 Description
프로비저닝 정책 ID Yes String 업데이트하려는 프로비저닝 정책의 프로비저닝 정책 ID입니다.
Description 아니오 String 이것이 프로비저닝 정책 설명이 업데이트되는 내용입니다.

고급 매개 변수 아래에 그래프의 다른 필드를 추가할 수도 있습니다.

반환

이 작업의 출력은 동적입니다.

프로비저닝 정책 가져오기

작업 ID: GetAProvisoningPolicyV1

이 작업을 통해 프로비저닝 정책의 세부 정보를 가져올 수 있습니다.

매개 변수

이름 필수 유형 Description
프로비저닝 정책 ID Yes String GUID 형식으로 32자로 구성된 클라우드 PC의 프로비저닝 정책 ID입니다. 정책은 사용자가 만들려는 클라우드 PC의 유형을 정의합니다.
$select 아니오 String $select 그래프에서 반환되는 속성을 선택할 수 있습니다.
$expand 아니오 String $expand Graph에서 관련 리소스를 반환할 수 있습니다.

고급 매개 변수 아래에 그래프의 다른 필드를 추가할 수도 있습니다.

반환

이 작업의 출력은 동적입니다.

원격 작업 시작

작업 ID: RemoteActions

이 작업을 사용하면 클라우드 PC에서 원격 작업을 시작할 수 있습니다.

매개 변수

이름 필수 유형 Description
클라우드 PC ID Yes String 이렇게 하면 원격 작업으로 대상으로 지정할 클라우드 PC ID를 지정할 수 있습니다.
원격 작업 Yes String 이렇게 하면 클라우드 PC에서 수행할 원격 작업을 선택할 수 있습니다.
원격 작업 – 스냅샷 ID 아니오 String 클라우드 PC를 복원하도록 선택하는 경우 스냅샷 ID도 제공해야 합니다.
원격 작업 – 표시 이름 아니오 String 클라우드 PC의 이름을 바꾸려면 표시 이름도 제공해야 합니다.

반환

성공하면 204 콘텐츠 없음 응답 코드가 반환됩니다.

Microsoft Graph HTTP 요청 보내기

작업 ID: HttpRequest

이 작업을 통해 Graph를 직접 호출하고 호출을 사용자 지정할 수 있습니다.

매개 변수

이름 필수 유형 Description
URI Yes String 이렇게 하면 호출할 URI를 지정할 수 있습니다. 예를 들면 다음과 같습니다. https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents
메서드 Yes String 이렇게 하면 호출 메서드를 정의할 수 있습니다.

고급 매개 변수 아래에 다른 필드(머리글, 본문 등)를 추가할 수도 있습니다.

반환

이 작업의 출력은 동적입니다.

유발 요소

모든 시나리오는 트리거 본문 자체에서 선택할 수 있는 하나의 트리거의 일부입니다.

트리거 이름 설명
클라우드 PC에서 원격 작업이 트리거되는 경우 원격 작업이 트리거될 때 흐름을 트리거할 수 있습니다.
클라우드 PC에서 원격 작업이 완료되는 경우 클라우드 PC에서 원격 작업이 완료되면 흐름을 트리거할 수 있습니다.
프로비저닝 정책이 업데이트되는 경우 프로비저닝 정책이 업데이트되면 흐름을 트리거할 수 있습니다.
새 프로비저닝 정책이 만들어지는 경우 프로비저닝 정책을 만들 때 흐름을 시작할 수 있습니다.
클라우드 PC를 만드는 경우 이 트리거를 사용하면 클라우드 PC를 만들 때 흐름을 시작할 수 있습니다.

프로비저닝 정책 또는 클라우드 PC가 업데이트되는 경우

  • 작업 ID: 웹후크
  • 설명: 이 트리거는 프로비전 정책 또는 클라우드 PC가 업데이트되면 발생합니다.

매개 변수

이름 필수 유형 Description
Scenario Yes 드롭다운 지원되는 시나리오 중에서 선택할 수 있습니다.
- 클라우드 PC를 만드는 경우
- 새 프로비저닝 정책이 만들어지는 경우
- 프로비전 정책이 업데이트되는 경우
- 클라우드 PC에서 원격 작업이 완료되는 경우
- 클라우드 PC에서 원격 작업이 트리거되는 경우

반환

이 작업의 출력은 동적입니다.

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

Microsoft Graph HTTP 요청 보내기(미리 보기)

Microsoft Graph REST API 요청 생성
그룹에 프로비저닝 정책 할당

그룹에 프로비저닝 정책을 할당합니다.
원격 작업 시작

클라우드 PC에서 원격 작업을 시작합니다.
클라우드 PC 가져오기

클라우드 PC를 가져옵니다.
클라우드 PC 나열

CloudPC 나열
프로비저닝 정책 가져오기

특정 프로비저닝 정책을 가져옵니다.
프로비저닝 정책 가져오기

프로비저닝 정책 목록을 가져옵니다.
프로비저닝 정책 만들기

프로비저닝 정책을 만듭니다.
프로비저닝 정책 삭제

프로비저닝 정책을 삭제합니다.
프로비저닝 정책 업데이트

프로비저닝 정책을 업데이트합니다.

Microsoft Graph HTTP 요청 보내기(미리 보기)

작업 ID:
HttpRequest

Microsoft Graph REST API 요청 생성

매개 변수

Name 키 필수 형식 Description
URI
 Uri True string

전체 또는 상대 URI입니다. 예: https://graph.microsoft.com/{version}/{resource}
메서드
 Method True string

HTTP 메서드(기본값: GET)
몸
 Body binary

요청 본문 콘텐츠
콘텐츠 유형 (Content-Type)
 ContentType string

본문의 콘텐츠 형식 헤더(기본값: application/json)
CustomHeader1
 CustomHeader1 string

사용자 지정 헤더 1. 형식으로 지정: header-name: header-value
CustomHeader2
 CustomHeader2 string

사용자 지정 헤더 2. 형식으로 지정: header-name: header-value
CustomHeader3
 CustomHeader3 string

사용자 지정 헤더 3. 형식으로 지정: header-name: header-value
CustomHeader4
 CustomHeader4 string

사용자 지정 헤더 4. 형식으로 지정: header-name: header-value
CustomHeader5
 CustomHeader5 string

사용자 지정 헤더 5. 형식으로 지정: header-name: header-value

반환

response
ObjectWithoutType

그룹에 프로비저닝 정책 할당

작업 ID:
AssignAProvisioningPolicyToAGroupV1

그룹에 프로비저닝 정책을 할당합니다.

매개 변수

Name 키 필수 형식 Description
프로비저닝 정책 ID
 id True string

아이디
프로비저닝 정책 ID
 id string

그룹을 할당하려는 프로비저닝 정책 ID입니다.
그룹 아이디
 groupId True string

groupId
servicePlanId
 servicePlanId string

대상 ServicePlan ID

원격 작업 시작

작업 ID:
RemoteActions

클라우드 PC에서 원격 작업을 시작합니다.

매개 변수

Name 키 필수 형식 Description
클라우드 PC ID
 cloudPcId True string

클라우드 PC의 고유 식별자입니다.
원격 작업
 remoteAction True string

클라우드 PC에서 수행할 원격 작업입니다.
클라우드 PC 스냅샷 ID
 cloudPcSnapshotId string

복원에 필요
표시 이름
 displayName string

이름 바꾸기에 필요

클라우드 PC 가져오기

작업 ID:
GetACloudPCObject

클라우드 PC를 가져옵니다.

매개 변수

Name 키 필수 형식 Description
클라우드 PC ID
 cloudPcId True string

클라우드 PC의 고유 식별자입니다.
선택
 $select string

반환할 속성을 선택합니다.

반환

Name 경로 형식 Description
아이디
 id string

GUID 형식으로 32자로 구성된 고객용 클라우드 PC 엔터티의 고유 식별자입니다.
Entra 디바이스 ID
 aadDeviceId string

클라우드 PC의 Microsoft Entra 디바이스 ID(Azure AD(Azure Active Directory) 디바이스 ID라고도 하며 GUID 형식으로 32자로 구성됩니다. Microsoft Entra ID에 조인된 VM에서 생성됩니다. 읽기 전용입니다.
표시 이름
 displayName string

클라우드 PC의 표시 이름입니다. 최대 길이는 64자입니다. 읽기 전용입니다.
이미지 표시 이름
 imageDisplayName string

클라우드 PC에 사용되는 운영 체제 이미지의 이름입니다. 최대 길이는 50자입니다.
프로비저닝 정책 ID
 provisioningPolicyId string

GUID 형식으로 32자로 구성된 클라우드 PC의 프로비저닝 정책 ID입니다. 정책은 사용자가 만들려는 클라우드 PC의 유형을 정의합니다.
프로비전 정책 이름
 provisioningPolicyName string

클라우드 PC를 프로비전하는 동안 적용되는 프로비저닝 정책입니다.
온-프레미스 연결 이름
 onPremisesConnectionName string

클라우드 PC를 프로비전하는 동안 적용된 Azure 네트워크 연결입니다.
서비스 계획 ID
 servicePlanId string

GUID 형식으로 32자로 구성된 클라우드 PC의 서비스 계획 ID입니다.
서비스 계획 이름
 servicePlanName string

고객싱 클라우드 PC 엔터티의 서비스 계획 이름입니다.
status
 status string

status
사용자 주 이름
 userPrincipalName string

클라우드 PC에 할당된 사용자의 UPN(사용자 계정 이름)입니다.
마지막으로 수정한 날짜/시간
 lastModifiedDateTime string

클라우드 PC의 마지막으로 수정된 날짜 및 시간입니다. 타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC로 표시됩니다.
관리되는 디바이스 ID
 managedDeviceId string

GUID 형식으로 32자로 구성된 클라우드 PC의 Intune 등록 디바이스 ID입니다.
관리되는 디바이스 이름
 managedDeviceName string

클라우드 PC의 Intune 등록 디바이스 이름입니다.
유예 기간 종료 날짜/시간
 gracePeriodEndDateTime string

유예 기간이 종료되고 다시 프로비전 또는 프로비전 해제가 발생하는 날짜와 시간입니다.
디스크 암호화 상태
 diskEncryptionState string

디스크 암호화 상태
프로비전 유형
 provisioningType string

이 정책을 사용하여 클라우드 PC를 프로비전할 때 사용할 라이선스 유형입니다.
할당 표시 이름
 allotmentDisplayName string

할당 표시 이름
상태 세부 정보
 statusDetail string

상태 세부 정보
Single Sign-On 활성화
 connectionSetting.enableSingleSignOn boolean

Single Sign-On 활성화
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

클라우드 PC 나열

작업 ID:
ListCloudPCs

CloudPC 나열

매개 변수

Name 키 필수 형식 Description
선택
 $select string

반환할 속성을 선택합니다.
Filter
 $filter string

예: provisioningPolicyName eq 'XXX' 및 userPrincipalName eq 'XXX'

반환

Name 경로 형식 Description
아이디
 id string

GUID 형식으로 32자로 구성된 고객용 클라우드 PC 엔터티의 고유 식별자입니다.
Entra 디바이스 ID
 aadDeviceId string

클라우드 PC의 Microsoft Entra 디바이스 ID(Azure AD(Azure Active Directory) 디바이스 ID라고도 하며 GUID 형식으로 32자로 구성됩니다. Microsoft Entra ID에 조인된 VM에서 생성됩니다. 읽기 전용입니다.
표시 이름
 displayName string

클라우드 PC의 표시 이름입니다. 최대 길이는 64자입니다. 읽기 전용입니다.
이미지 표시 이름
 imageDisplayName string

클라우드 PC에 사용되는 운영 체제 이미지의 이름입니다. 최대 길이는 50자입니다.
프로비저닝 정책 ID
 provisioningPolicyId string

GUID 형식으로 32자로 구성된 클라우드 PC의 프로비저닝 정책 ID입니다. 정책은 사용자가 만들려는 클라우드 PC의 유형을 정의합니다.
프로비전 정책 이름
 provisioningPolicyName string

클라우드 PC를 프로비전하는 동안 적용되는 프로비저닝 정책입니다.
온-프레미스 연결 이름
 onPremisesConnectionName string

클라우드 PC를 프로비전하는 동안 적용된 Azure 네트워크 연결입니다.
서비스 계획 ID
 servicePlanId string

GUID 형식으로 32자로 구성된 클라우드 PC의 서비스 계획 ID입니다.
서비스 계획 이름
 servicePlanName string

고객싱 클라우드 PC 엔터티의 서비스 계획 이름입니다.
status
 status string

status
사용자 주 이름
 userPrincipalName string

클라우드 PC에 할당된 사용자의 UPN(사용자 계정 이름)입니다.
마지막으로 수정한 날짜/시간
 lastModifiedDateTime string

클라우드 PC의 마지막으로 수정된 날짜 및 시간입니다. 타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC로 표시됩니다.
관리되는 디바이스 ID
 managedDeviceId string

GUID 형식으로 32자로 구성된 클라우드 PC의 Intune 등록 디바이스 ID입니다.
관리되는 디바이스 이름
 managedDeviceName string

클라우드 PC의 Intune 등록 디바이스 이름입니다.
유예 기간 종료 날짜/시간
 gracePeriodEndDateTime string

유예 기간이 종료되고 다시 프로비전 또는 프로비전 해제가 발생하는 날짜와 시간입니다.
디스크 암호화 상태
 diskEncryptionState string

디스크 암호화 상태
프로비전 유형
 provisioningType string

이 정책을 사용하여 클라우드 PC를 프로비전할 때 사용할 라이선스 유형입니다.
할당 표시 이름
 allotmentDisplayName string

할당 표시 이름
상태 세부 정보
 statusDetail string

상태 세부 정보
Single Sign-On 활성화
 connectionSetting.enableSingleSignOn boolean

프로비저닝 정책에서 클라우드 PC에 대해 SSO를 사용하도록 설정했는지 여부를 지정합니다.
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

프로비저닝 정책 가져오기

작업 ID:
GetAProvisioningPolicyV1

특정 프로비저닝 정책을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
프로비저닝 정책 ID
 id True string

아이디
선택
 $select string

지정되지 않은 경우 기본 속성을 반환합니다. 첫 번째 옵션은 모든 속성을 반환합니다.
확장하다
 $expand string

관련 엔터티를 인라인으로 확장합니다.

반환

Name 경로 형식 Description
assignments
 assignments array of object
items
 assignments object
Description
 description string

프로비저닝 정책 설명입니다.
표시 이름
 displayName string

프로비저닝 정책 표시 이름입니다.
도메인 조인 구성
 domainJoinConfigurations array of object

클라우드 PC가 Microsoft Entra ID를 조인하는 방법에 대해 우선 순위에 따라 정렬된 목록을 지정합니다.
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
type
 domainJoinConfigurations.type string

type
managedType
 microsoftManagedDesktop.managedType string

managedType
프로필
 microsoftManagedDesktop.profile string

프로필
autopatchGroupId
 autopatch.autopatchGroupId string

autopatchGroupId
devicePreparationProfileId
 autopilotConfiguration.devicePreparationProfileId string

devicePreparationProfileId
applicationTimeoutInMinutes
 autopilotConfiguration.applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
onFailureDeviceAccessDenied
 autopilotConfiguration.onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
Single Sign-On 활성화
 enableSingleSignOn boolean

프로비저닝 정책에서 클라우드 PC에 대해 SSO를 사용하도록 설정했는지 여부를 지정합니다.
아이디
 id string

아이디
이미지 표시 이름
 imageDisplayName string

프로비전하는 OS 이미지의 표시 이름입니다.
이미지 ID
 imageId string

클라우드 PC에서 프로비전하려는 운영 체제 이미지의 ID입니다.
이미지 형식
 imageType string

클라우드 PC에서 프로비전하려는 OS 이미지(사용자 지정 또는 갤러리)의 유형입니다.
지역 설정
 windowsSetting.locale string

지역 설정
managedBy
 managedBy string

managedBy
프로비전 유형
 provisioningType string

이 정책을 사용하여 클라우드 PC를 프로비전할 때 사용되는 라이선스 유형을 지정합니다.

프로비저닝 정책 가져오기

작업 ID:
GetProvisioningPoliciesV1

프로비저닝 정책 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
선택
 $select string

지정되지 않은 경우 기본 속성을 반환합니다. 첫 번째 옵션은 모든 속성을 반환합니다.
Filter
 $filter string

속성 값을 사용하여 항목을 필터링합니다.
확장하다
 $expand string

관련 엔터티를 인라인으로 확장합니다.

반환

Name 경로 형식 Description
value
 value array of object

value
assignments
 value.assignments array of object
items
 value.assignments object
Description
 value.description string

프로비저닝 정책 설명입니다.
표시 이름
 value.displayName string

프로비저닝 정책 표시 이름입니다.
도메인 조인 구성
 value.domainJoinConfigurations array of object

클라우드 PC가 Microsoft Entra ID를 조인하는 방법에 대해 우선 순위에 따라 정렬된 목록을 지정합니다.
onPremisesConnectionId
 value.domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
type
 value.domainJoinConfigurations.type string

type
managedType
 value.microsoftManagedDesktop.managedType string

managedType
프로필
 value.microsoftManagedDesktop.profile string

프로필
autopatchGroupId
 value.autopatch.autopatchGroupId string

autopatchGroupId
devicePreparationProfileId
 value.autopilotConfiguration.devicePreparationProfileId string

devicePreparationProfileId
applicationTimeoutInMinutes
 value.autopilotConfiguration.applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
onFailureDeviceAccessDenied
 value.autopilotConfiguration.onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
Single Sign-On 활성화
 value.enableSingleSignOn boolean

프로비저닝 정책에서 클라우드 PC에 대해 SSO를 사용하도록 설정했는지 여부를 지정합니다.
아이디
 value.id string

아이디
이미지 표시 이름
 value.imageDisplayName string

프로비전하는 OS 이미지의 표시 이름입니다.
이미지 ID
 value.imageId string

클라우드 PC에서 프로비전하려는 운영 체제 이미지의 ID입니다.
이미지 형식
 value.imageType string

클라우드 PC에서 프로비전하려는 OS 이미지(사용자 지정 또는 갤러리)의 유형입니다.
지역 설정
 value.windowsSetting.locale string

지역 설정
managedBy
 value.managedBy string

managedBy
프로비전 유형
 value.provisioningType string

이 정책을 사용하여 클라우드 PC를 프로비전할 때 사용되는 라이선스 유형을 지정합니다.

프로비저닝 정책 만들기

작업 ID:
CreateAProvisioningPolicyV1

프로비저닝 정책을 만듭니다.

매개 변수

Name 키 필수 형식 Description
이름
 displayName True string

표시 이름
Description
 description True string

description
domainJoinType
 domainJoinType string
type
 type string
지역 이름
 regionName string
onPremisesConnectionId
 onPremisesConnectionId string
regionGroup
 regionGroup string
기타 필드
 otherFields object

기타 필드
Single Sign-On 활성화
 enableSingleSignOn boolean

enableSingleSignOn
이미지 ID
 imageId True string

imageId
이미지 표시 이름
 imageDisplayName True string

imageDisplayName
이미지 형식
 imageType True string

이미지 유형
프로비전 유형
 provisioningType True string

provisioningType
로케일
 locale True string

지역 설정
관리되는 형식
 managedType string

managedType
프로필
 profile string

프로필

반환

Name 경로 형식 Description
아이디
 id string

아이디
표시 이름
 displayName string

프로비저닝 정책 표시 이름입니다.
Description
 description string

프로비저닝 정책 설명입니다.
이미지 ID
 imageId string

클라우드 PC에서 프로비전하려는 운영 체제 이미지의 ID입니다.
이미지 표시 이름
 imageDisplayName string

프로비전하는 OS 이미지의 표시 이름입니다.
이미지 형식
 imageType string

클라우드 PC에서 프로비전하려는 OS 이미지(사용자 지정 또는 갤러리)의 유형입니다.
Single Sign-On 활성화
 enableSingleSignOn boolean

프로비저닝 정책에서 클라우드 PC에 대해 SSO를 사용하도록 설정했는지 여부를 지정합니다.
클라우드 PC 명명 템플릿
 cloudPcNamingTemplate string

이 정책을 사용하여 프로비전된 클라우드 PC의 이름을 지정하는 데 사용되는 템플릿입니다.
프로비전 유형
 provisioningType string

이 정책을 사용하여 클라우드 PC를 프로비전할 때 사용되는 라이선스 유형을 지정합니다.
managedBy
 managedBy string

managedBy
scopeIds
 scopeIds array of

scopeIds
자동 일치 설정
 autopatch string

이 프로비저닝 정책을 사용하여 클라우드 PC에 대한 Windows 자동 패치 설정을 나타냅니다.
autopilotConfiguration
 autopilotConfiguration string

autopilotConfiguration
domainJoinConfigurations
 domainJoinConfigurations array of object

domainJoinConfigurations
domainJoinType
 domainJoinConfigurations.domainJoinType string

domainJoinType
type
 domainJoinConfigurations.type string

type
지역 이름
 domainJoinConfigurations.regionName string

지역 이름
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
regionGroup
 domainJoinConfigurations.regionGroup string

regionGroup
managedType
 microsoftManagedDesktop.managedType string

managedType
type
 microsoftManagedDesktop.type string

type
프로필
 microsoftManagedDesktop.profile string

프로필
지역 설정
 windowsSetting.locale string

지역 설정
language
 windowsSettings.language string

language

프로비저닝 정책 삭제

작업 ID:
DeleteAProvisioningPolicyV1

프로비저닝 정책을 삭제합니다.

매개 변수

Name 키 필수 형식 Description
프로비저닝 정책 ID
 id True string

아이디

프로비저닝 정책 업데이트

작업 ID:
UpdateAProvisioningPolicyV1

프로비저닝 정책을 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
프로비저닝 정책 ID
 id True string

아이디
그룹 아이디
 autopatchGroupId string

autopatchGroupId
디바이스 준비 프로필 ID
 devicePreparationProfileId string

devicePreparationProfileId
애플리케이션 시간 제한(분)
 applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
오류 발생시 디바이스 액세스가 거부됨
 onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
Description
 description string

description
표시 이름
 displayName string

표시 이름
도메인 가입 유형
 domainJoinType string

domainJoinType
온-프레미스 연결 ID
 onPremisesConnectionId string

onPremisesConnectionId
지역 그룹
 regionGroup string

regionGroup
지역 이름
 regionName string

지역 이름
유형
 type string

type
Single Sign-On 사용
 enableSingleSignOn boolean

enableSingleSignOn
이미지 표시 이름
 imageDisplayName string

imageDisplayName
이미지 ID
 imageId string

imageId
이미지 형식
 imageType string

이미지 유형
관리되는 형식
 managedType string

managedType
프로필
 profile string

프로필
로케일
 locale string

지역 설정
기타 필드
 otherFields object

기타 필드

트리거

프로비저닝 정책 또는 클라우드 PC가 업데이트되는 경우

프로비저닝 정책 또는 클라우드 PC가 업데이트되는 경우

프로비저닝 정책 또는 클라우드 PC가 업데이트되는 경우

작업 ID:
Webhook

프로비저닝 정책 또는 클라우드 PC가 업데이트되는 경우

매개 변수

Name 키 필수 형식 Description
시나리오
 scenario True string

시나리오

정의

ObjectWithoutType