cloudPC: reprovisionar

Namespace: microsoft.graph

Reprovisione um PC na nuvem específico.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global	Governo dos EUA L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	✅	❌	❌

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão	Permissões menos privilegiadas	Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante)	CloudPC.ReadWrite.All	Indisponível.
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	CloudPC.ReadWrite.All	Indisponível.

Solicitação HTTP

Para reprovisionar o cloudPC do usuário especificado (que é o usuário conectado) na organização usando a permissão delegada:

POST /me/cloudPCs/{id}/reprovision
POST /users/{userId}/cloudPCs/{id}/reprovision

Para reprovisionar o cloudPC especificado na organização, usando a permissão delegada (o usuário conectado deve ser o administrador) ou a permissão do aplicativo:

POST /deviceManagement/virtualEndpoint/cloudPCs/{id}/reprovision

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type	application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON dos parâmetros.

A tabela a seguir mostra os parâmetros que podem ser usados com esta ação.

Parâmetro	Tipo	Descrição
osVersion	cloudPcOperatingSystem	A versão do sistema operacional (SO) a ser provisionado em PCs na nuvem. Os valores possíveis são: `windows10`, `windows11`e `unknownFutureValue`.
userAccountType	cloudPcUserAccountType	O tipo de conta do usuário em PCs na nuvem provisionados. Os valores possíveis são: `standardUser`, `administrator`e `unknownFutureValue`.

Valores de cloudPcOperatingSystem

Member	Descrição
Windows10	O sistema operacional Windows 10.
janelas 11	O sistema operacional Windows 11.
unknownFutureValue	Valor sentinela de enumeração evolutiva. Não usar.

valores de cloudPcUserAccountType

Member	Descrição
usuário padrão	Um usuário sem permissões administrativas locais no PC na nuvem. Os usuários Standard só podem instalar conteúdo do aplicativo Microsoft Store, mas não podem modificar as configurações do Windows que exigem privilégios administrativos locais.
de Banco de Dados	Um usuário com permissões administrativas locais completas no PC na nuvem. Os administradores podem instalar qualquer software e modificar qualquer arquivo ou configuração no PC na nuvem.
unknownFutureValue	Valor sentinela de enumeração evolutiva. Não usar.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content.

Exemplos

Exemplo 1: Reprovisionar o cloudPC para o administrador

O exemplo a seguir mostra como reprovisionar o PC na nuvem para o administrador.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/deviceManagement/virtualEndpoint/cloudPCs/4b5ad5e0-6a0b-4ffc-818d-36bb23cf4dbd/reprovision
Content-Type: application/json
Content-length: 61

{
  "userAccountType": "administrator",
  "osVersion": "windows10"
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.DeviceManagement.VirtualEndpoint.CloudPCs.Item.Reprovision;
using Microsoft.Graph.Models;

var requestBody = new ReprovisionPostRequestBody
{
	UserAccountType = CloudPcUserAccountType.Administrator,
	OsVersion = CloudPcOperatingSystem.Windows10,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.DeviceManagement.VirtualEndpoint.CloudPCs["{cloudPC-id}"].Reprovision.PostAsync(requestBody);



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphdevicemanagement "github.com/microsoftgraph/msgraph-sdk-go/devicemanagement"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphdevicemanagement.NewReprovisionPostRequestBody()
userAccountType := graphmodels.ADMINISTRATOR_CLOUDPCUSERACCOUNTTYPE 
requestBody.SetUserAccountType(&userAccountType) 
osVersion := graphmodels.WINDOWS10_CLOUDPCOPERATINGSYSTEM 
requestBody.SetOsVersion(&osVersion) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.DeviceManagement().VirtualEndpoint().CloudPCs().ByCloudPCId("cloudPC-id").Reprovision().Post(context.Background(), requestBody, nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.devicemanagement.virtualendpoint.cloudpcs.item.reprovision.ReprovisionPostRequestBody reprovisionPostRequestBody = new com.microsoft.graph.devicemanagement.virtualendpoint.cloudpcs.item.reprovision.ReprovisionPostRequestBody();
reprovisionPostRequestBody.setUserAccountType(CloudPcUserAccountType.Administrator);
reprovisionPostRequestBody.setOsVersion(CloudPcOperatingSystem.Windows10);
graphClient.deviceManagement().virtualEndpoint().cloudPCs().byCloudPCId("{cloudPC-id}").reprovision().post(reprovisionPostRequestBody);


const options = {
	authProvider,
};

const client = Client.init(options);

const reprovision = {
  userAccountType: 'administrator',
  osVersion: 'windows10'
};

await client.api('/deviceManagement/virtualEndpoint/cloudPCs/4b5ad5e0-6a0b-4ffc-818d-36bb23cf4dbd/reprovision')
	.post(reprovision);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\DeviceManagement\VirtualEndpoint\CloudPCs\Item\Reprovision\ReprovisionPostRequestBody;
use Microsoft\Graph\Generated\Models\CloudPcUserAccountType;
use Microsoft\Graph\Generated\Models\CloudPcOperatingSystem;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new ReprovisionPostRequestBody();
$requestBody->setUserAccountType(new CloudPcUserAccountType('administrator'));
$requestBody->setOsVersion(new CloudPcOperatingSystem('windows10'));

$graphServiceClient->deviceManagement()->virtualEndpoint()->cloudPCs()->byCloudPCId('cloudPC-id')->reprovision()->post($requestBody)->wait();


Import-Module Microsoft.Graph.DeviceManagement.Administration

$params = @{
	userAccountType = "administrator"
	osVersion = "windows10"
}

Invoke-MgReprovisionDeviceManagementVirtualEndpointCloudPc -CloudPCId $cloudPCId -BodyParameter $params


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.devicemanagement.virtualendpoint.cloudpcs.item.reprovision.reprovision_post_request_body import ReprovisionPostRequestBody
from msgraph.generated.models.cloud_pc_user_account_type import CloudPcUserAccountType
from msgraph.generated.models.cloud_pc_operating_system import CloudPcOperatingSystem
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ReprovisionPostRequestBody(
	user_account_type = CloudPcUserAccountType.Administrator,
	os_version = CloudPcOperatingSystem.Windows10,
)

await graph_client.device_management.virtual_endpoint.cloud_p_cs.by_cloud_p_c_id('cloudPC-id').reprovision.post(request_body)

Resposta

HTTP/1.1 204 No Content

O exemplo a seguir mostra como reprovisionar o PC na nuvem para o usuário conectado.

Exemplo 2: Reprovisionar o cloudPC para o usuário conectado

O exemplo a seguir mostra como reprovisionar o PC na nuvem para o usuário conectado.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/me/cloudPCs/36bd4942-0ca8-11ed-861d-0242ac120002/reprovision


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Me.CloudPCs["{cloudPC-id}"].Reprovision.PostAsync(null);



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Me().CloudPCs().ByCloudPCId("cloudPC-id").Reprovision().Post(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.me().cloudPCs().byCloudPCId("{cloudPC-id}").reprovision().post(null);


const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/me/cloudPCs/36bd4942-0ca8-11ed-861d-0242ac120002/reprovision')
	.post();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->me()->cloudPCs()->byCloudPCId('cloudPC-id')->reprovision()->post()->wait();

Snippet not available


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.me.cloud_p_cs.by_cloud_p_c_id('cloudPC-id').reprovision.post(None)

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Comentários

Esta página foi útil?

Last updated on 2026-08-24

cloudPC: reprovisionar

Permissões

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Valores de cloudPcOperatingSystem

valores de cloudPcUserAccountType

Resposta

Exemplos

Exemplo 1: Reprovisionar o cloudPC para o administrador

Solicitação

Resposta

Exemplo 2: Reprovisionar o cloudPC para o usuário conectado

Solicitação

Resposta

Comentários

Recursos adicionais