cloudPcProvisioningPolicy tipo de recurso
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Representa uma política de aprovisionamento de PC na Cloud.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | cloudPcProvisioningPolicy collection (coleção cloudPcProvisioningPolicy ) | Listar propriedades e relações dos objetos cloudPcProvisioningPolicy . |
| Get | cloudPcProvisioningPolicy | Leia as propriedades e relações de um objeto cloudPcProvisioningPolicy . |
| Create | cloudPcProvisioningPolicy | Crie um novo objeto cloudPcProvisioningPolicy . |
| Atualizar | cloudPcProvisioningPolicy | Atualize as propriedades de um objeto cloudPcProvisioningPolicy . |
| Delete | Nenhum | Eliminar um objeto cloudPcProvisioningPolicy . |
| Assign | Nenhum | Atribua um cloudPcProvisioningPolicy a grupos de utilizadores. |
| Apply | Nenhum | Aplique a configuração da política de aprovisionamento atual a todos os dispositivos cloud PC numa política especificada. Atualmente, só pode alterar a região. |
| Aplicar configuração | Nenhum | Atualize a configuração da política de aprovisionamento para um conjunto de dispositivos cloud PC pelos respetivos IDs. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| alternateResourceUrl | Cadeia de caracteres | O URL do recurso alternativo que liga a esta política de aprovisionamento. Somente leitura. |
| bloqueio automático | cloudPcProvisioningPolicyAutopatch | As definições específicas do Windows Autopatch que permitem aos clientes experimentá-lo no Cloud PC. As definições têm efeito quando o inquilino é inscrito no Windows Autopatch e o managedType da propriedade microsoftManagedDesktop é definido como starterManaged. Oferece suporte para $select. |
| AutopilotConfiguration | cloudPcAutopilotConfiguration | As definições específicas do Windows Autopilot que permitem aos clientes Windows 365 experimentá-lo no Cloud PC. Oferece suporte para $select. |
| cloudPcGroupDisplayName | Cadeia de caracteres | O nome a apresentar do grupo de PC na Cloud onde os PCs na Cloud residem. Somente leitura. |
| cloudPcNamingTemplate | Cadeia de caracteres | O modelo utilizado para atribuir o nome PCs cloud aprovisionados com esta política. O modelo pode conter tokens de substituição e texto personalizados, incluindo %USERNAME:x% e %RAND:x%, que representam o nome do utilizador e um número gerado aleatoriamente, respetivamente. Por exemplo, CPC-%USERNAME:4%-%RAND:5% significa que o nome do CLOUD PC começa com CPC-, seguido de um nome de utilizador de quatro carateres, um - caráter e, em seguida, cinco carateres aleatórios. O comprimento total do texto gerado pelo modelo não pode exceder os 15 carateres. Oferece suporte para $filter, $select e $orderby. |
| description | Cadeia de caracteres | A descrição da política de aprovisionamento. Oferece suporte para $filter, $select e $orderBy. |
| displayName | Cadeia de caracteres | O nome a apresentar da política de aprovisionamento. |
| domainJoinConfigurations | cloudPcDomainJoinConfiguration collection | Especifica uma lista ordenada por prioridade sobre a forma como os PCs na Cloud se associam Microsoft Entra ID (Azure AD). Oferece suporte para $select. |
| enableSingleSignOn | Booliano |
True se o início de sessão único puder aceder ao CLOUD PC aprovisionado.
False indica que o CLOUD PC aprovisionado não suporta esta funcionalidade. O valor padrão é false. Windows 365 utilizadores podem utilizar o início de sessão único para se autenticarem no Microsoft Entra ID com opções sem palavra-passe (por exemplo, chaves FIDO) para aceder ao respetivo PC na Cloud. Opcional. |
| gracePeriodInHours | Int32 | O número de horas de espera antes que o reprovisionamento/desprovisionamento aconteça. Somente leitura. |
| id | Cadeia de caracteres | O identificador exclusivo associado à política de aprovisionamento. Este ID é preenchido automaticamente durante a criação de uma nova política de aprovisionamento. Somente leitura. Oferece suporte para $filter, $select e $orderBy. |
| imageDisplayName | Cadeia de caracteres | O nome a apresentar da imagem do sistema operativo utilizada para o aprovisionamento. Por exemplo, Windows 11 Preview + Microsoft 365 Apps 23H2 23H2. Oferece suporte para $filter, $select e $orderBy. |
| imageId | Cadeia de caracteres | O identificador exclusivo que representa uma imagem do sistema operativo que é utilizada para aprovisionar novos PCs na Cloud. O formato de uma imagem de tipo de galeria é: {publisherName_offerName_skuName}. Os valores suportados para cada um dos parâmetros são:
$filter, $select e $orderBy. |
| imageType | cloudPcProvisioningPolicyImageType | O tipo de imagem do sistema operativo (personalizada ou galeria) utilizada para o aprovisionamento em PCs na Cloud. Os valores possíveis são: gallery e custom. O valor padrão é gallery. Suporta $filter, $select e $orderBy. |
| localAdminEnabled | Booliano | Quando true, o administrador local está ativado para PCs na Cloud; false indica que o administrador local não está ativado para PCs na Cloud. O valor padrão é false. Oferece suporte para $filter, $select e $orderBy. |
| managedBy | cloudPcManagementService | Indica o serviço que gere a política de aprovisionamento. Os valores possíveis são: windows365, devBox, unknownFutureValue, rpaBox. O valor padrão é windows365. Tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter o seguinte valor nesta enumeração evoluível: rpaBox. Oferece suporte para $filter, $select e $orderBy. |
| microsoftManagedDesktop | microsoftManagedDesktop | As definições específicas do microsoftManagedDesktop que permitem que os clientes do Microsoft Managed Desktop obtenham experiência gerida pelo dispositivo para o CLOUD PC. Para permitir que o microsoftManagedDesktop forneça mais valor, um administrador tem de especificar determinadas definições no mesmo. Oferece suporte para $filter, $select e $orderBy. |
| provisioningType | cloudPcProvisioningType | Especifica o tipo de licenças a utilizar ao aprovisionar PCs na Cloud com esta política. Os valores possíveis são dedicated, shared, unknownFutureValue, sharedByUser, sharedByEntraGroup. Tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: sharedByUser, sharedByEntraGroup. O shared membro foi preterido e deixará de regressar a 30 de abril de 2027; daqui para a frente, utilize o sharedByUser membro. Por exemplo, um dedicated plano de serviço só pode ser atribuído a um utilizador e aprovisionar apenas um PC na Cloud. Os shared planos e sharedByUser exigem que os clientes comprem um plano de serviço partilhado. Cada licença partilhada comprada pode ativar até três PCs na Cloud, com apenas um utilizador com sessão iniciada de cada vez. O sharedByEntraGroup plano também requer a compra de um plano de serviço partilhado. Cada licença partilhada ao abrigo deste plano pode ativar um PC na Cloud, que é partilhado para o grupo de acordo com as atribuições desta política. Por predefinição, o tipo de licença é dedicated se o provisioningType não for especificado quando cria a cloudPcProvisioningPolicy. Não pode alterar esta propriedade depois de criar cloudPcProvisioningPolicy . |
| windowsSetting | cloudPcWindowsSettings | Indica uma definição específica do Windows para configurar durante a criação de PCs na Cloud para esta política de aprovisionamento. Oferece suporte para $select. |
| domainJoinConfiguration (preterido) | cloudPcDomainJoinConfiguration | Especifica a forma como os PCs cloud se associam Microsoft Entra ID. A propriedade domainJoinConfiguration foi preterida e deixará de devolver dados a 31 de maio de 2024. No futuro, utilize a propriedade domainJoinConfigurations . |
| onPremisesConnectionId (preterido) | Cadeia de caracteres | O ID da cloudPcOnPremisesConnection. Para garantir que os PCs na Cloud têm conectividade de rede e associação a um domínio, escolha uma ligação com uma rede virtual que o serviço cloud PC validou. A propriedade onPremisesConnectionId foi preterida e deixará de devolver dados a 31 de maio de 2024. No futuro, utilize a propriedade domainJoinConfigurations . |
| windowsSettings (preterido) | cloudPcWindowsSettings | Definições específicas do Windows a configurar durante a criação de PCs na Cloud para esta política de aprovisionamento. Oferece suporte para $select. A propriedade windowsSettings foi preterida e deixará de devolver dados a 31 de janeiro de 2024. No futuro, utilize a propriedade windowsSetting . |
valores cloudPcProvisioningType
A tabela seguinte lista os membros de uma enumeração evoluível. Tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores nesta enumeração evoluível: sharedByUser, sharedByEntraGroup.
| Member | Descrição |
|---|---|
| dedicado | Indica que é utilizada uma licença dedicada para aprovisionar PCs na Cloud. Valor predefinido. |
| partilhado (preterido) | Indica que é utilizada uma licença partilhada para aprovisionar PCs na Cloud. O shared membro foi preterido e deixará de regressar a 30 de abril de 2027. No futuro, utilize o sharedByUser membro. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
| sharedByUser | Indica a política de aprovisionamento quando um PC na Cloud dedicado é aprovisionado para cada utilizador no grupo de atribuições. Os utilizadores estão sempre ligados ao mesmo PC na Cloud. No entanto, a disponibilidade do Cloud PC é limitada pelo número total de sessões ativas. |
| sharedByEntraGroup | Indica a política de aprovisionamento associada a PCs na Cloud partilhados por um grupo de Microsoft Entra (Azure AD). Quando um PC na Cloud partilhado é aprovisionado, fica disponível para qualquer utilizador no grupo de atribuição de Microsoft Entra ID ao qual ligar. Os utilizadores podem estar ligados a um PC na Cloud diferente em cada ligação e a disponibilidade é limitada pelo número de PCs na Cloud aprovisionados. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| assignments | cloudPcProvisioningPolicyAssignment collection (coleção cloudPcProvisioningPolicyAssignment) | Uma coleção definida de atribuições de políticas de aprovisionamento. Representa o conjunto de grupos e grupos de segurança do Microsoft 365 no Microsoft Entra ID que têm a política de aprovisionamento atribuída. Retornado apenas em $expand. Para obter um exemplo sobre como obter a relação de atribuições, veja Obter cloudPcProvisioningPolicy. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
"alternateResourceUrl": "String",
"autopatch": {"@odata.type": "microsoft.graph.cloudPcProvisioningPolicyAutopatch"},
"autopilotConfiguration": {"@odata.type": "microsoft.graph.cloudPcAutopilotConfiguration"},
"cloudPcGroupDisplayName": "String",
"cloudPcNamingTemplate": "String",
"description": "String",
"displayName": "String",
"domainJoinConfiguration": {
"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"
},
"domainJoinConfigurations": [{"@odata.type": "microsoft.graph.cloudPcDomainJoinConfiguration"}],
"enableSingleSignOn": "Boolean",
"gracePeriodInHours": "Int32",
"id": "String (identifier)",
"imageDisplayName": "String",
"imageId": "String",
"imageType": "String",
"localAdminEnabled": "Boolean",
"managedBy": "String",
"microsoftManagedDesktop": {
"@odata.type": "microsoft.graph.microsoftManagedDesktop"
},
"onPremisesConnectionId": "String",
"provisioningType": "String",
"windowsSetting": {
"@odata.type": "microsoft.graph.cloudPcWindowsSetting"
},
"windowsSettings": {
"@odata.type": "microsoft.graph.cloudPcWindowsSettings"
}
}