Condividi tramite

Windows 365 (anteprima)

Windows 365 è un servizio basato sul cloud che crea automaticamente un nuovo tipo di macchina virtuale Windows (PC cloud) per gli utenti finali. Ogni PC cloud viene assegnato a un singolo utente come dispositivo Windows dedicato. Windows 365 offre i vantaggi di produttività, sicurezza e collaborazione di Microsoft 365.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio Class Regions
Copilot Studio Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica Normale Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure per enti pubblici
     - Aree di Azure Cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Di alta qualità Tutte le aree di Power Apps , ad eccezione dei seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Contatto
Nome Microsoft
URL https://powerautomate.microsoft.com/en-us/support/
Metadati del connettore
Editore Microsoft
Sito web https://www.microsoft.com/en-us/windows-365
Informativa sulla privacy https://privacy.microsoft.com/en-us/privacystatement
Categorie Operazioni IT; Produttività

Il connettore Windows 365 fornisce azioni per gestire i PC Windows 365 Cloud e i criteri di provisioning all'interno dell'ambiente di Microsoft Intune. Questo connettore consente di automatizzare le operazioni del ciclo di vita di Cloud PC, la gestione dei criteri di provisioning e le attività amministrative tramite i flussi di Power Automate.

Servizio, classe e aree geografiche

Servizio Classe Regions
Copilot Studio Di alta qualità Tutte le aree di Power Automate
App per la logica Di alta qualità Tutte le aree di App per la logica
Power Apps Di alta qualità Tutte le aree di Power Apps
Power Automate Di alta qualità Tutte le aree di Power Automate

Contatto

Contatto
Nome Windows 365
URL https://learn.microsoft.com/en-us/connectors/windows365
Email W365powerplatform@microsoft.com

Prerequisiti

Per usare questo connettore, è necessario:

  • Licenze di Windows 365 per l'organizzazione
  • Sottoscrizione di Microsoft Intune
  • Privilegi sufficienti nel controllo degli accessi in base al ruolo (RBAC) di Microsoft Intune per gestire le risorse di Windows 365
  • Account Azure AD con autorizzazioni appropriate

Autorizzazioni necessarie

Gli utenti devono avere uno dei ruoli di controllo degli accessi in base al ruolo di Intune seguenti:

  • Amministratore globale
  • Amministratore del servizio Intune
  • Amministratore di Windows365 (per operazioni specifiche di Cloud PC)
  • Ruolo personalizzato con autorizzazioni di Windows 365 (richiede Webhook.Create e Webhook.Delete per le operazioni di trigger)

Importante: questo connettore richiede licenze di Windows 365 e autorizzazioni appropriate per il controllo degli accessi in base al ruolo di Microsoft Intune. Tutte le operazioni usano l'API Microsoft Graph e sono soggette ai limiti di limitazione delle richieste dell'API Graph.

Problemi noti e limitazioni

Il connettore Windows 365 è attualmente disponibile in anteprima pubblica.

Microsoft desidera accertarsi che un connettore sia stabile prima del suo rilascio in disponibilità generale. Fino a quel momento, il connettore è in stato di anteprima. Le anteprime vengono fornite "così come sono", "con errori" e "come disponibili". Sono escluse dai contratti di servizio, ma rese disponibili in anteprima per consentire agli utenti di accedere anticipatamente e fornire commenti. Altre informazioni sulle funzionalità di anteprima e su come abilitarle. Le anteprime potrebbero non essere coperte dal supporto tecnico clienti. Potrebbero essere interrotti in qualsiasi momento senza preavviso e potrebbero non essere rilasciati nella disponibilità generale.

Ti invitiamo a provare i connettori di anteprima e a fornire commenti. Questo ci aiuterà a stabilizzare e migliorare i connettori. Puoi utilizzare i forum dei prodotti per condividere problemi e commenti. Il supporto tecnico Microsoft potrebbe non essere disponibile per le funzionalità di anteprima, inclusi i connettori, ma tenteremo di fornire supporto quanto più possiamo. Per altre informazioni, visitare le domande frequenti sui connettori in anteprima.

Limiti generali

  • Le funzionalità e le limitazioni sono coerenti con l'API Graph sottostante.
  • Quando è necessario chiamare qualcosa nell'endpoint beta di Graph, usare l'azione richiesta HTTP.

Azioni

Elencare i PC cloud

ID operazione: ListCloudPCs

Questa azione consente di elencare i PC cloud.

Parametri

Nome Obbligatorio TIPO Description
$select NO corda $select consente di scegliere quali proprietà vengono restituite da Graph.
$filtro NO corda $filter consente di ottenere un solo subset di una raccolta da Graph.

Rendiconto

Nome TIPO Description
aadDeviceId String ID dispositivo Microsoft Entra per Cloud PC, noto anche come ID dispositivo di Azure Active Directory (Azure AD), costituito da 32 caratteri in un formato GUID. Generato in una macchina virtuale aggiunta all'ID Microsoft Entra. Sola lettura.
diskEncryptionState String Mostra lo stato di crittografia del disco.
nome visualizzato String Nome visualizzato per Cloud PC. La lunghezza massima consentita è di 64 caratteri. Sola lettura.
gracePeriodEndDateTime DateTimeOffset Data e ora in cui il periodo di tolleranza termina e viene eseguito il provisioning o il deprovisioning. Obbligatorio solo se lo stato è inGracePeriod. Il timestamp viene visualizzato in formato ISO 8601 e utc (Coordinated Universal Time). Ad esempio, mezzanotte UTC il 1 gennaio 2014 è 2014-01-01T00:00:00Z.
id String Identificatore univoco dell'entità Cloud PC rivolta al cliente costituita da 32 caratteri in un formato GUID. Sola lettura.
imageDisplayName String Nome dell'immagine del sistema operativo usata per Cloud PC. La lunghezza massima è di 50 caratteri. Per questa proprietà sono consentite solo lettere (A-Z, a-z), numeri (0-9) e caratteri speciali (-,_,.). Il valore della proprietà non può iniziare o terminare con un carattere di sottolineatura. Sola lettura.
lastModifiedDateTime DateTimeOffset Data e ora dell'ultima modifica del Cloud PC. Il tipo timestamp rappresenta le informazioni di data e ora usando il formato ISO 8601 ed è sempre in formato UTC. Ad esempio, mezzanotte UTC il 1 gennaio 2014 è 2014-01-01T00:00:00Z.
managedDeviceId String ID dispositivo registrato in Intune per cloud PC costituito da 32 caratteri in un formato GUID. La proprietà managedDeviceId dei PC Windows 365 Business Cloud è sempre Null perché i PC Windows 365 Business Cloud non vengono registrati automaticamente da Windows 365. Sola lettura.
managedDeviceName String Nome del dispositivo registrato in Intune per Cloud PC. La proprietà managedDeviceName dei PC Windows 365 Business Cloud è sempre Null perché i PC Windows 365 Business Cloud non vengono registrati automaticamente da Windows 365. Sola lettura.
onPremisesConnectionName String Connessione locale applicata durante il provisioning dei PC cloud. Sola lettura.
provisioningPolicyId String ID dei criteri di provisioning per Cloud PC costituito da 32 caratteri in un formato GUID. Un criterio definisce il tipo di Cloud PC che l'utente vuole creare. Sola lettura.
provisioningPolicyName String Criteri di provisioning applicati durante il provisioning dei PC cloud. La lunghezza massima è di 120 caratteri. Sola lettura.
provisioningType String Mostra il tipo di provisioning.
servicePlanId String ID del piano di servizio per cloud PC costituito da 32 caratteri in un formato GUID. Per altre informazioni sui piani di servizio, vedere Nomi dei prodotti e identificatori del piano di servizio per le licenze. Sola lettura.
servicePlanName String Nome del piano di servizio per l'entità Cloud PC rivolta al cliente. Sola lettura.
servicePlanType String Mostra il tipo di piano.
userPrincipalName String Nome dell'entità utente (UPN) dell'utente assegnato al Cloud PC. La lunghezza massima è di 113 caratteri. Per altre informazioni sui criteri di nome utente, vedere Criteri password e restrizioni dell'account in Microsoft Entra ID. Sola lettura.

Ottenere i criteri di provisioning

ID operazione: GetProvisioningPoliciesV1

Questa azione consente di restituire informazioni sui criteri di provisioning.

Parametri

Nome Obbligatorio TIPO Description
$select NO String $select consente di scegliere quali proprietà vengono restituite da Graph.
$filtro NO String $filter consente di ottenere un solo subset di una raccolta da Graph.
$expand NO String $expand consente di restituire risorse correlate da Graph.

Rendiconto

Usare $expand con un valore di assegnazioni per visualizzare i valori restituiti di seguito:

Nome TIPO Description
cloudPCNamingTemplate String Modello usato per denominare i PC cloud di cui è stato effettuato il provisioning usando questo criterio. Il modello può contenere token di testo e sostituzione personalizzati, tra cui %USERNAME:x% e %RAND:x%, che rappresentano rispettivamente il nome dell'utente e un numero generato in modo casuale. Ad esempio, CPC-%USERNAME:4%-%RAND:5% significa che il nome del CLOUD PC inizia con CPC-, seguito da un nome utente a quattro caratteri, un carattere e quindi cinque caratteri casuali. La lunghezza totale del testo generato dal modello non può superare i 15 caratteri.
descrizione String Descrizione dei criteri di provisioning.
nome visualizzato String Nome visualizzato per i criteri di provisioning.
domainJoinConfiguration raccolta cloudPcDomainJoinConfiguration Specifica un elenco ordinato per priorità sulla modalità di aggiunta dell'ID Microsoft Entra (Azure AD) ai PC cloud.
enableSingleSignOn Boolean True se è possibile accedere al cloud PC di cui è stato effettuato il provisioning tramite Single Sign-On. False indica che il pc cloud di cui è stato effettuato il provisioning non supporta questa funzionalità. Il valore predefinito è false. Gli utenti di Windows 365 possono usare l'accesso Single Sign-On per l'autenticazione a Microsoft Entra ID con opzioni senza password (ad esempio, chiavi FIDO) per accedere al cloud PC
id String Identificatore univoco associato ai criteri di provisioning. Questo ID viene popolato automaticamente durante la creazione di un nuovo criterio di provisioning. Sola lettura.
imageDisplayName String Nome visualizzato dell'immagine del sistema operativo utilizzata per il provisioning. Ad esempio, Windows 11 Preview + Microsoft 365 Apps 23H2 23H2.
imageId String Identificatore univoco che rappresenta un'immagine del sistema operativo usata per il provisioning di nuovi PC cloud. Il formato per un'immagine del tipo di raccolta è: {publisherName_offerName_skuName}. I valori supportati per ognuno dei parametri sono: publisher: Microsoftwindowsdesktop offer: 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 e 19h2-ent-cpc-os
tipo di immagine cloudPcProvisioningPolicyImageType Tipo di immagine del sistema operativo (personalizzata o raccolta) usata per il provisioning nei PC cloud. I valori possibili sono: raccolta, personalizzata. Il valore predefinito è gallery.

Ottenere un criterio di provisioning

ID operazione: GetAProvisioningPolicyV1

Questa azione consente di ottenere i dettagli di un criterio di provisioning specifico.

Parametri

Nome Obbligatorio TIPO Description
ID criterio di provisioning Yes String ID dei criteri di provisioning. Deve essere incluso.
$select NO String $select consente di scegliere quali proprietà vengono restituite da Graph.
$filtro NO String $filter consente di ottenere un solo subset di una raccolta da Graph.

Rendiconto

Gli output di questa operazione sono dinamici.

Creare un criterio di provisioning

ID operazione: CreateAProvisioningPolicyV1

Questa azione consente di creare un criterio di provisioning.

Parametri

Nome Obbligatorio TIPO Description
Nome Yes String Criteri di provisioning applicati durante il provisioning dei PC cloud. La lunghezza massima è di 120 caratteri
Description Yes String Descrizione dei criteri di provisioning.
Configurazione dell'aggiunta a un dominio Yes
ID immagine Yes String Si tratta dell'ID immagine che si vuole usare per il provisioning di PC cloud.
Nome visualizzato immagine Yes String Nome dell'immagine del sistema operativo usata per Cloud PC. La lunghezza massima è di 50 caratteri. Per questa proprietà sono consentite solo lettere (A-Z, a-z), numeri (0-9) e caratteri speciali (-,_,.). Il valore della proprietà non può iniziare o terminare con un carattere di sottolineatura.
Tipo di immagine Yes String Personalizzata o Raccolta.
Tipo di provisioning Yes String Condiviso o dedicato.
Impostazioni/impostazioni locali di Windows Yes String Specificare la lingua o le impostazioni locali che si vuole usare. Windows 365 offre più di 30 coppie di lingue/aree geografico.

È anche possibile aggiungere altri campi da Graph in Parametri avanzati.

Rendiconto

Gli output di questa operazione sono dinamici.

Assegnare un criterio di provisioning a un gruppo

ID operazione: AssignAProvisioningPolicyToAGroupV1

Questa azione consente di assegnare un gruppo a un criterio di provisioning.

Parametri

Nome Obbligatorio TIPO Description
ID criterio di provisioning Yes String Si tratta dell'ID dei criteri di provisioning a cui si vuole assegnare un gruppo.
Assegnazioni - ID gruppo di destinazione Yes String Gruppo di utenti da Entra ID.
Assegnazioni : ID ServicePlan di destinazione NO String Identificatore univoco per il piano di servizio che indica le dimensioni del PC cloud di cui effettuare il provisioning per l'utente.

Rendiconto

Gli output di questa operazione sono dinamici.

Aggiornare un criterio di provisioning

ID operazione: UpdateAProvisioningPolicyV1

Questa azione consente di aggiornare un criterio di provisioning.

Parametri

Nome Obbligatorio TIPO Description
ID criterio di provisioning Yes String Si tratta dell'ID dei criteri di provisioning dei criteri di provisioning da aggiornare.
Description NO String Questa è la descrizione dei criteri di provisioning a cui verrà aggiornata.

È anche possibile aggiungere altri campi da Graph in Parametri avanzati.

Rendiconto

Gli output di questa operazione sono dinamici.

Ottenere un criterio di provisioning

ID operazione: GetAProvisoningPolicyV1

Questa azione consente di ottenere i dettagli di un criterio di provisioning.

Parametri

Nome Obbligatorio TIPO Description
ID criterio di provisioning Yes String ID dei criteri di provisioning per Cloud PC costituito da 32 caratteri in un formato GUID. Un criterio definisce il tipo di Cloud PC che l'utente vuole creare.
$select NO String $select consente di scegliere quali proprietà vengono restituite da Graph.
$expand NO String $expand consente di restituire risorse correlate da Graph.

È anche possibile aggiungere altri campi da Graph in Parametri avanzati.

Rendiconto

Gli output di questa operazione sono dinamici.

Avviare un'azione remota

ID operazione: RemoteActions

Questa azione consente di avviare un'azione remota in un PC cloud.

Parametri

Nome Obbligatorio TIPO Description
Cloud PC ID Yes String In questo modo è possibile specificare l'ID pc cloud di destinazione con un'azione remota.
Azione remota Yes String In questo modo è possibile scegliere quando si vuole eseguire un'azione remota su un PC cloud.
Azione remota - ID snapshot NO String Se si sceglie di ripristinare un PC cloud, è necessario specificare anche un ID snapshot.
Azione remota - Nome visualizzato NO String Se si sceglie di rinominare un CLOUD PC, è necessario specificare anche un nome visualizzato.

Rendiconto

In caso di esito positivo, viene restituito un codice di risposta 204 Nessun contenuto.

Inviare una richiesta HTTP di Microsoft Graph

ID operazione: HttpRequest

Questa azione consente di chiamare Graph direttamente e personalizzare la chiamata.

Parametri

Nome Obbligatorio TIPO Description
URI (Identificatore Uniforme delle Risorse) Yes String In questo modo è possibile specificare l'URI da chiamare, ad esempio: https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/auditEvents
Metodo Yes String In questo modo è possibile definire il metodo di chiamata.

È anche possibile aggiungere altri campi (intestazioni, corpo e così via) in Parametri avanzati.

Rendiconto

Gli output di questa operazione sono dinamici.

Attivatori

Tutti gli scenari fanno parte di un trigger, che è selezionabile nel corpo del trigger stesso.

Nome trigger Descrizione
Quando viene attivata un'azione remota in un CLOUD PC Consente di attivare un flusso quando viene attivata un'azione remota.
Al termine di un'azione remota in un CLOUD PC Consente di attivare un flusso quando viene completata un'azione remota in un PC cloud.
Quando un criterio di provisioning viene aggiornato Consente di attivare un flusso quando un criterio di provisioning viene aggiornato.
Quando viene creato un nuovo criterio di provisioning Consente di avviare un flusso quando viene creato un criterio di provisioning.
Quando viene creato un CLOUD PC Questo trigger consente di avviare un flusso quando viene creato un Cloud PC.

Quando vengono aggiornati criteri di provisioning o Cloud PC

  • ID operazione: Webhook
  • Descrizione: Questo trigger viene attivato quando vengono aggiornati criteri di provisioning o Cloud PC.

Parametri

Nome Obbligatorio TIPO Description
Scenario Yes Menu a discesa È possibile scegliere tra gli scenari supportati:
- Quando viene creato un Cloud PC
- Quando viene creato un nuovo criterio di provisioning
- Quando un criterio di provisioning viene aggiornato
- Al termine di un'azione remota in un PC cloud
- Quando viene attivata un'azione remota in un CLOUD PC

Rendiconto

Gli output di questa operazione sono dinamici.

Limiti per la limitazione delle richieste

Nome Chiamate Periodo di rinnovo
Chiamate API per connessione 100 60 secondi

Azioni

Aggiornare un criterio di provisioning

Aggiorna un criterio di provisioning.
Assegnare un criterio di provisioning a un gruppo

Assegnare un criterio di provisioning a un gruppo.
Avviare un'azione remota

Avviare un'azione remota in un Cloud PC.
Creare un criterio di provisioning

Crea un criterio di provisioning.
Elencare i PC cloud

Elencare i cloudPC
Eliminare un criterio di provisioning

Elimina un criterio di provisioning.
Inviare una richiesta HTTP di Microsoft Graph (anteprima)

Creare una richiesta dell'API REST di Microsoft Graph
Ottenere i criteri di provisioning

Ottiene un elenco di criteri di provisioning.
Ottenere un criterio di provisioning

Ottiene un criterio di provisioning specifico.
Ottenere un PC cloud

Ottiene un PC cloud

Aggiornare un criterio di provisioning

ID operazione:
UpdateAProvisioningPolicyV1

Aggiorna un criterio di provisioning.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID criterio di provisioning
 id True string

id
ID del Gruppo
 autopatchGroupId string

autopatchGroupId
ID profilo preparazione del dispositivo
 devicePreparationProfileId string

devicePreparationProfileId
Timeout dell'applicazione in minuti
 applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
Accesso negato al dispositivo in caso di errore
 onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
Description
 description string

descrizione
Nome visualizzato
 displayName string

nome visualizzato
Tipo di aggiunta a un dominio
 domainJoinType string

domainJoinType
ID connessione locale
 onPremisesConnectionId string

onPremisesConnectionId
Gruppo di aree
 regionGroup string

regionGroup
Nome della regione
 regionName string

regionName
TIPO
 type string

type
Abilitare l'accesso Single Sign-On
 enableSingleSignOn boolean

enableSingleSignOn
Nome visualizzato immagine
 imageDisplayName string

imageDisplayName
ID immagine
 imageId string

imageId
Tipo di immagine
 imageType string

tipo di immagine
Tipo gestito
 managedType string

managedType
Profile
 profile string

profile
Luogo
 locale string

locale
Altri campi
 otherFields object

Altri campi

Assegnare un criterio di provisioning a un gruppo

ID operazione:
AssignAProvisioningPolicyToAGroupV1

Assegnare un criterio di provisioning a un gruppo.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID criterio di provisioning
 id True string

id
ID criterio di provisioning
 id string

Si tratta dell'ID dei criteri di provisioning a cui si vuole assegnare un gruppo
ID del Gruppo
 groupId True string

groupId
servicePlanId
 servicePlanId string

ID ServicePlan di destinazione

Avviare un'azione remota

ID operazione:
RemoteActions

Avviare un'azione remota in un Cloud PC.

Parametri

Nome Chiave Necessario Tipo Descrizione
Cloud PC ID
 cloudPcId True string

Identificatore univoco del Cloud PC.
Azione remota
 remoteAction True string

Azione remota da eseguire nel Cloud PC.
Cloud PC snapshot Id
 cloudPcSnapshotId string

Obbligatorio per il ripristino
Nome visualizzato
 displayName string

Obbligatorio per la ridenominazione

Creare un criterio di provisioning

ID operazione:
CreateAProvisioningPolicyV1

Crea un criterio di provisioning.

Parametri

Nome Chiave Necessario Tipo Descrizione
Nome
 displayName True string

nome visualizzato
Description
 description True string

descrizione
domainJoinType
 domainJoinType string
type
 type string
regionName
 regionName string
onPremisesConnectionId
 onPremisesConnectionId string
regionGroup
 regionGroup string
Altri campi
 otherFields object

Altri campi
Abilita l'accesso singolo
 enableSingleSignOn boolean

enableSingleSignOn
ID immagine
 imageId True string

imageId
Nome visualizzato immagine
 imageDisplayName True string

imageDisplayName
Tipo di immagine
 imageType True string

tipo di immagine
Tipo di provisioning
 provisioningType True string

provisioningType
Luogo
 locale True string

locale
Tipo gestito
 managedType string

managedType
Profile
 profile string

profile

Restituisce

Nome Percorso Tipo Descrizione
id
 id string

id
Nome visualizzato
 displayName string

Nome visualizzato dei criteri di provisioning.
Description
 description string

Descrizione dei criteri di provisioning.
ID immagine
 imageId string

ID dell'immagine del sistema operativo di cui si vuole eseguire il provisioning nei PC cloud.
Nome visualizzato immagine
 imageDisplayName string

Nome visualizzato per l'immagine del sistema operativo di cui si sta eseguendo il provisioning.
Tipo di immagine
 imageType string

Tipo di immagine del sistema operativo (personalizzata o raccolta) di cui si vuole eseguire il provisioning nei PC cloud.
Abilita l'accesso singolo
 enableSingleSignOn boolean

Specifica se il criterio di provisioning ha abilitato l'accesso SSO per PC cloud.
Modello di denominazione di Cloud PC
 cloudPcNamingTemplate string

Modello usato per denominare i PC cloud di cui è stato effettuato il provisioning usando questo criterio.
Tipo di provisioning
 provisioningType string

Specifica il tipo di licenza usato durante il provisioning di PC cloud usando questo criterio.
managedBy
 managedBy string

managedBy
scopeIds
 scopeIds array of

scopeIds
Impostazioni di aggiornamento automatico
 autopatch string

Indica le impostazioni di Windows Autopatch per i PC cloud che usano questo criterio di provisioning.
autopilotConfiguration
 autopilotConfiguration string

autopilotConfiguration
domainJoinConfigurations
 domainJoinConfigurations array of object

domainJoinConfigurations
domainJoinType
 domainJoinConfigurations.domainJoinType string

domainJoinType
type
 domainJoinConfigurations.type string

type
regionName
 domainJoinConfigurations.regionName string

regionName
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
regionGroup
 domainJoinConfigurations.regionGroup string

regionGroup
managedType
 microsoftManagedDesktop.managedType string

managedType
type
 microsoftManagedDesktop.type string

type
profile
 microsoftManagedDesktop.profile string

profile
locale
 windowsSetting.locale string

locale
language
 windowsSettings.language string

language

Elencare i PC cloud

ID operazione:
ListCloudPCs

Elencare i cloudPC

Parametri

Nome Chiave Necessario Tipo Descrizione
Seleziona
 $select string

Selezionare le proprietà da restituire.
Filter
 $filter string

Ex. provisioningPolicyName eq 'XXX' e userPrincipalName eq 'XXX'

Restituisce

Nome Percorso Tipo Descrizione
Documento d'identità
 id string

Identificatore univoco dell'entità Cloud PC rivolta al cliente costituita da 32 caratteri in un formato GUID.
ENTRA ID dispositivo
 aadDeviceId string

ID dispositivo Microsoft Entra per Cloud PC, noto anche come ID dispositivo di Azure Active Directory (Azure AD), costituito da 32 caratteri in un formato GUID. Generato in una macchina virtuale aggiunta all'ID Microsoft Entra. Sola lettura.
Nome visualizzato
 displayName string

Nome visualizzato per Cloud PC. La lunghezza massima consentita è di 64 caratteri. Sola lettura.
Nome visualizzato immagine
 imageDisplayName string

Nome dell'immagine del sistema operativo usata per Cloud PC. La lunghezza massima è di 50 caratteri.
ID criterio di provisioning
 provisioningPolicyId string

ID dei criteri di provisioning per Cloud PC costituito da 32 caratteri in un formato GUID. Un criterio definisce il tipo di Cloud PC che l'utente vuole creare.
Nome dei criteri di provisioning
 provisioningPolicyName string

Criteri di provisioning applicati durante il provisioning dei PC cloud.
Nome della connessione locale
 onPremisesConnectionName string

Connessione di rete di Azure applicata durante il provisioning dei PC cloud.
ID piano di servizio
 servicePlanId string

ID del piano di servizio per cloud PC costituito da 32 caratteri in un formato GUID.
Nome del piano di servizio
 servicePlanName string

Nome del piano di servizio per l'entità Cloud PC a livello di cliente.
status
 status string

status
Nome principale utente
 userPrincipalName string

Nome dell'entità utente (UPN) dell'utente assegnato al Cloud PC.
Data/ora ultima modifica
 lastModifiedDateTime string

Data e ora dell'ultima modifica del Cloud PC. Il tipo timestamp rappresenta le informazioni di data e ora usando il formato ISO 8601 ed è sempre in formato UTC.
ID dispositivo gestito
 managedDeviceId string

ID dispositivo registrato in Intune per cloud PC costituito da 32 caratteri in un formato GUID.
Nome del dispositivo gestito
 managedDeviceName string

Nome del dispositivo registrato in Intune per Cloud PC.
Data/ora di fine del periodo di tolleranza
 gracePeriodEndDateTime string

Data e ora in cui il periodo di tolleranza termina e viene eseguito il provisioning o il deprovisioning.
Stato di crittografia del disco
 diskEncryptionState string

Stato di crittografia del disco
Tipo di provisioning
 provisioningType string

Tipo di licenze da usare durante il provisioning di PC cloud che usano questo criterio.
Nome visualizzato dell'allocazione
 allotmentDisplayName string

Nome visualizzato dell'allocazione
Dettagli stato
 statusDetail string

Dettagli stato
Abilita l'accesso singolo
 connectionSetting.enableSingleSignOn boolean

Specifica se il criterio di provisioning ha abilitato l'accesso SSO per PC cloud.
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

Eliminare un criterio di provisioning

ID operazione:
DeleteAProvisioningPolicyV1

Elimina un criterio di provisioning.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID criterio di provisioning
 id True string

id

Inviare una richiesta HTTP di Microsoft Graph (anteprima)

ID operazione:
HttpRequest

Creare una richiesta dell'API REST di Microsoft Graph

Parametri

Nome Chiave Necessario Tipo Descrizione
URI (Identificatore Uniforme delle Risorse)
 Uri True string

URI completo o relativo. Esempio: https://graph.microsoft.com/{version}/{resource}
Metodo
 Method True string

Il metodo HTTP (il valore predefinito è GET)
Corpo
 Body binary

Contenuto del corpo della richiesta
Content-Type
 ContentType string

Intestazione content-type per il corpo (il valore predefinito è application/json)
CustomHeader1
 CustomHeader1 string

Intestazione personalizzata 1. Specificare in formato: header-name: header-value
CustomHeader2
 CustomHeader2 string

Intestazione personalizzata 2. Specificare in formato: header-name: header-value
CustomHeader3
 CustomHeader3 string

Intestazione personalizzata 3. Specificare in formato: header-name: header-value
CustomHeader4
 CustomHeader4 string

Intestazione personalizzata 4. Specificare in formato: header-name: header-value
CustomHeader5
 CustomHeader5 string

Intestazione personalizzata 5. Specificare in formato: header-name: header-value

Restituisce

response
ObjectWithoutType

Ottenere i criteri di provisioning

ID operazione:
GetProvisioningPoliciesV1

Ottiene un elenco di criteri di provisioning.

Parametri

Nome Chiave Necessario Tipo Descrizione
Seleziona
 $select string

Restituisce le proprietà predefinite se non specificate; la prima opzione restituisce tutte le proprietà.
Filter
 $filter string

Filtrare gli elementi in base ai valori delle proprietà.
Espandi
 $expand string

Espande le entità correlate in linea.

Restituisce

Nome Percorso Tipo Descrizione
value
 value array of object

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

Descrizione dei criteri di provisioning.
Nome visualizzato
 value.displayName string

Nome visualizzato dei criteri di provisioning.
Configurazioni di aggiunta a un dominio
 value.domainJoinConfigurations array of object

Specifica un elenco ordinato per priorità sul modo in cui i PC cloud vengono aggiunti a Microsoft Entra ID.
onPremisesConnectionId
 value.domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
type
 value.domainJoinConfigurations.type string

type
managedType
 value.microsoftManagedDesktop.managedType string

managedType
profile
 value.microsoftManagedDesktop.profile string

profile
autopatchGroupId
 value.autopatch.autopatchGroupId string

autopatchGroupId
devicePreparationProfileId
 value.autopilotConfiguration.devicePreparationProfileId string

devicePreparationProfileId
applicationTimeoutInMinutes
 value.autopilotConfiguration.applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
onFailureDeviceAccessDenied
 value.autopilotConfiguration.onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
Abilita l'accesso singolo
 value.enableSingleSignOn boolean

Specifica se il criterio di provisioning ha abilitato l'accesso SSO per PC cloud.
id
 value.id string

id
Nome visualizzato immagine
 value.imageDisplayName string

Nome visualizzato per l'immagine del sistema operativo di cui si sta eseguendo il provisioning.
ID immagine
 value.imageId string

ID dell'immagine del sistema operativo di cui si vuole eseguire il provisioning nei PC cloud.
Tipo di immagine
 value.imageType string

Tipo di immagine del sistema operativo (personalizzata o raccolta) di cui si vuole eseguire il provisioning nei PC cloud.
locale
 value.windowsSetting.locale string

locale
managedBy
 value.managedBy string

managedBy
Tipo di provisioning
 value.provisioningType string

Specifica il tipo di licenza usato durante il provisioning di PC cloud usando questo criterio.

Ottenere un criterio di provisioning

ID operazione:
GetAProvisioningPolicyV1

Ottiene un criterio di provisioning specifico.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID criterio di provisioning
 id True string

id
Seleziona
 $select string

Restituisce le proprietà predefinite se non specificate; la prima opzione restituisce tutte le proprietà.
Espandi
 $expand string

Espande le entità correlate in linea.

Restituisce

Nome Percorso Tipo Descrizione
assegnazioni
 assignments array of object
items
 assignments object
Description
 description string

Descrizione dei criteri di provisioning.
Nome visualizzato
 displayName string

Nome visualizzato dei criteri di provisioning.
Configurazioni di aggiunta a un dominio
 domainJoinConfigurations array of object

Specifica un elenco ordinato per priorità sul modo in cui i PC cloud vengono aggiunti a Microsoft Entra ID.
onPremisesConnectionId
 domainJoinConfigurations.onPremisesConnectionId string

onPremisesConnectionId
type
 domainJoinConfigurations.type string

type
managedType
 microsoftManagedDesktop.managedType string

managedType
profile
 microsoftManagedDesktop.profile string

profile
autopatchGroupId
 autopatch.autopatchGroupId string

autopatchGroupId
devicePreparationProfileId
 autopilotConfiguration.devicePreparationProfileId string

devicePreparationProfileId
applicationTimeoutInMinutes
 autopilotConfiguration.applicationTimeoutInMinutes integer

applicationTimeoutInMinutes
onFailureDeviceAccessDenied
 autopilotConfiguration.onFailureDeviceAccessDenied boolean

onFailureDeviceAccessDenied
Abilita l'accesso singolo
 enableSingleSignOn boolean

Specifica se il criterio di provisioning ha abilitato l'accesso SSO per PC cloud.
id
 id string

id
Nome visualizzato immagine
 imageDisplayName string

Nome visualizzato per l'immagine del sistema operativo di cui si sta eseguendo il provisioning.
ID immagine
 imageId string

ID dell'immagine del sistema operativo di cui si vuole eseguire il provisioning nei PC cloud.
Tipo di immagine
 imageType string

Tipo di immagine del sistema operativo (personalizzata o raccolta) di cui si vuole eseguire il provisioning nei PC cloud.
locale
 windowsSetting.locale string

locale
managedBy
 managedBy string

managedBy
Tipo di provisioning
 provisioningType string

Specifica il tipo di licenza usato durante il provisioning di PC cloud usando questo criterio.

Ottenere un PC cloud

ID operazione:
GetACloudPCObject

Ottiene un PC cloud

Parametri

Nome Chiave Necessario Tipo Descrizione
Cloud PC ID
 cloudPcId True string

Identificatore univoco del Cloud PC.
Seleziona
 $select string

Selezionare le proprietà da restituire.

Restituisce

Nome Percorso Tipo Descrizione
Documento d'identità
 id string

Identificatore univoco dell'entità Cloud PC rivolta al cliente costituita da 32 caratteri in un formato GUID.
ENTRA ID dispositivo
 aadDeviceId string

ID dispositivo Microsoft Entra per Cloud PC, noto anche come ID dispositivo di Azure Active Directory (Azure AD), costituito da 32 caratteri in un formato GUID. Generato in una macchina virtuale aggiunta all'ID Microsoft Entra. Sola lettura.
Nome visualizzato
 displayName string

Nome visualizzato per Cloud PC. La lunghezza massima consentita è di 64 caratteri. Sola lettura.
Nome visualizzato immagine
 imageDisplayName string

Nome dell'immagine del sistema operativo usata per Cloud PC. La lunghezza massima è di 50 caratteri.
ID criterio di provisioning
 provisioningPolicyId string

ID dei criteri di provisioning per Cloud PC costituito da 32 caratteri in un formato GUID. Un criterio definisce il tipo di Cloud PC che l'utente vuole creare.
Nome dei criteri di provisioning
 provisioningPolicyName string

Criteri di provisioning applicati durante il provisioning dei PC cloud.
Nome della connessione locale
 onPremisesConnectionName string

Connessione di rete di Azure applicata durante il provisioning dei PC cloud.
ID piano di servizio
 servicePlanId string

ID del piano di servizio per cloud PC costituito da 32 caratteri in un formato GUID.
Nome del piano di servizio
 servicePlanName string

Nome del piano di servizio per l'entità Cloud PC a livello di cliente.
status
 status string

status
Nome principale utente
 userPrincipalName string

Nome dell'entità utente (UPN) dell'utente assegnato al Cloud PC.
Data/ora ultima modifica
 lastModifiedDateTime string

Data e ora dell'ultima modifica del Cloud PC. Il tipo timestamp rappresenta le informazioni di data e ora usando il formato ISO 8601 ed è sempre in formato UTC.
ID dispositivo gestito
 managedDeviceId string

ID dispositivo registrato in Intune per cloud PC costituito da 32 caratteri in un formato GUID.
Nome del dispositivo gestito
 managedDeviceName string

Nome del dispositivo registrato in Intune per Cloud PC.
Data/ora di fine del periodo di tolleranza
 gracePeriodEndDateTime string

Data e ora in cui il periodo di tolleranza termina e viene eseguito il provisioning o il deprovisioning.
Stato di crittografia del disco
 diskEncryptionState string

Stato di crittografia del disco
Tipo di provisioning
 provisioningType string

Tipo di licenze da usare durante il provisioning di PC cloud che usano questo criterio.
Nome visualizzato dell'allocazione
 allotmentDisplayName string

Nome visualizzato dell'allocazione
Dettagli stato
 statusDetail string

Dettagli stato
Abilita l'accesso singolo
 connectionSetting.enableSingleSignOn boolean

Abilita l'accesso singolo
partnerAgentInstallResults
 partnerAgentInstallResults array of string

partnerAgentInstallResults

Trigger

Quando vengono aggiornati criteri di provisioning o Cloud PC

Quando vengono aggiornati criteri di provisioning o Cloud PC

Quando vengono aggiornati criteri di provisioning o Cloud PC

ID operazione:
Webhook

Quando vengono aggiornati criteri di provisioning o Cloud PC

Parametri

Nome Chiave Necessario Tipo Descrizione
situazione
 scenario True string

situazione

Definizioni

ObjectWithoutType