Compartilhar via

cloudPC: reaprovisionar

Namespace: microsoft.graph

Aprovisionar novamente um PC na Cloud específico.

Esta API está disponível nas seguintes implementações de cloud nacionais.

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

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
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 voltar a aprovisionar o cloudPC do utilizador especificado (que é o utilizador com sessão iniciada) na organização com a permissão delegada:

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

Para voltar a aprovisionar o cloudPC especificado na organização, utilizando a permissão delegada (o utilizador com sessão iniciada deve ser o administrador) ou a permissão da aplicação:

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

Nota: apenas as APIs para o corpo do pedido de suporte de administrador .

No corpo do pedido, 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 operativo (SO) a aprovisionar em PCs cloud. Os valores possíveis são: windows10, windows11e unknownFutureValue.
userAccountType cloudPcUserAccountType O tipo de conta do utilizador em PCs cloud aprovisionados. Os valores possíveis são: standardUser, administratore unknownFutureValue.

cloudPcOperatingSystem values

Member Descrição
windows10 O sistema operativo Windows 10.
windows11 O sistema operativo Windows 11.
unknownFutureValue Valor da sentinela de enumeração evoluível. Não usar.

valores cloudPcUserAccountType

Member Descrição
standardUser Um utilizador sem permissões administrativas locais no PC na Cloud. Standard utilizadores só podem instalar conteúdos a partir da aplicação Microsoft Store, mas não podem modificar as definições do Windows que necessitam de privilégios administrativos locais.
administrador Um utilizador com permissões administrativas locais completas no PC na Cloud. Os administradores podem instalar qualquer software e modificar qualquer ficheiro ou definição no CLOUD PC.
unknownFutureValue Valor da sentinela de enumeração evoluível. Não usar.

Resposta

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

Exemplos

Exemplo 1: Aprovisionar novamente o cloudPC para o administrador

O exemplo seguinte mostra como aprovisionar novamente o CLOUD PC 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"
}

Resposta

HTTP/1.1 204 No Content

O exemplo seguinte mostra como voltar a aprovisionar o CLOUD PC para o utilizador com sessão iniciada.

Exemplo 2: Aprovisionar novamente o cloudPC para o utilizador com sessão iniciada

O exemplo seguinte mostra como voltar a aprovisionar o CLOUD PC para o utilizador com sessão iniciada.

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

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content
  • Last updated on