CloudPcProvisioningPolicy erstellen

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Erstellen Sie ein neues cloudPcProvisioningPolicy-Objekt .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ❌ ❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) CloudPC.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application CloudPC.ReadWrite.All Nicht verfügbar.

HTTP-Anforderung

POST /deviceManagement/virtualEndpoint/provisioningPolicies

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des cloudPcProvisioningPolicy-Objekts an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die Sie beim Erstellen der cloudPcProvisioningPolicy einschließen können.

Eigenschaft Typ Beschreibung
description Zeichenfolge Die Beschreibung der Bereitstellungsrichtlinie. Optional.
displayName Zeichenfolge Der Anzeigename für die Bereitstellungsrichtlinie. Erforderlich.
domainJoinConfigurations cloudPcDomainJoinConfiguration collection Gibt eine nach Priorität sortierte Liste an, wie Cloud-PCs der Microsoft Entra ID beitreten. Erforderlich.
imageDisplayName Zeichenfolge Der Anzeigename für das Betriebssystemimage, das Sie bereitstellen. Optional.
imageId Zeichenfolge Erforderlich. Die ID des Betriebssystemimages, das Sie auf Cloud-PCs bereitstellen möchten. Das Format für ein Katalogbild ist: {publisher_offer_sku}. Unterstützte Werte für jeden der Parameter sind wie folgt:
  • Herausgeber: Microsoftwindowsdesktop.
  • Angebot: 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-os19h2-ent-cpc-m365 , und 19h2-ent-cpc-os.
imageType cloudPcProvisioningPolicyImageType Der Typ des Betriebssystemimages (benutzerdefiniert oder Katalog), das Sie auf Cloud-PCs bereitstellen möchten. Die möglichen Werte sind: gallery, custom. Erforderlich.
provisioningType cloudPcProvisioningType Gibt den Lizenztyp an, der beim Bereitstellen von Cloud-PCs mit dieser Richtlinie verwendet wird. Standardmäßig liegt dedicated der Lizenztyp vor, wenn der Bereitstellungstyp beim Erstellen der cloudPcProvisioningPolicy nicht angegeben wird. Sie können diese Eigenschaft nicht mehr ändern, nachdem die cloudPcProvisioningPolicy erstellt wurde. Mögliche Werte sind: dedicated, shared, unknownFutureValue, sharedByUser, sharedByEntraGroup. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte aus dieser entwicklungsfähigen Aufzählung zu erhalten: sharedByUser, sharedByEntraGroup. Das shared Mitglied ist veraltet und kehrt ab dem 30. April 2027 nicht mehr zurück. Verwenden Sie das sharedByUser Mitglied in Zukunft. Optional.
snapshotResetMode cloudPcSnapshotResetMode Gibt an, ob das Zurücksetzen der Momentaufnahme für diese Bereitstellungsrichtlinie verfügbar ist. Mögliche Werte sind: notApplicable, enabled, disabled, unknownFutureValue. Der Standardwert ist notApplicable. Optional.
userSettingsPersistenceConfiguration cloudPcUserSettingsPersistenceConfiguration Gibt bestimmte Einstellungen an, die die Persistenz von Benutzeranwendungseinstellungen zwischen Cloud PC-Sitzungen aktivieren. Der Standardwert ist null. Dieses Feature ist nur für Cloud PC-Bereitstellungsrichtlinien vom Typ sharedByEntraGroup. Unterstützt $select. Optional.
windowsSetting cloudPcWindowsSettings Gibt eine bestimmte Windows-Einstellung an, die während der Erstellung von Cloud-PCs für diese Bereitstellungsrichtlinie konfiguriert werden muss. Unterstützt $select. Optional.
domainJoinConfiguration (veraltet) cloudPcDomainJoinConfiguration Gibt an, wie Cloud-PCs der Microsoft Entra ID beitreten. Die domainJoinConfiguration-Eigenschaft ist veraltet und gibt ab dem 31. Mai 2024 keine Daten mehr zurück. Verwenden Sie in Zukunft die domainJoinConfigurations-Eigenschaft .
onPremisesConnectionId (veraltet) Zeichenfolge Die ID von cloudPcOnPremisesConnection. Um sicherzustellen, dass Cloud-PCs über Netzwerkkonnektivität verfügen und einer Domäne beitreten, wählen Sie eine Verbindung mit einem virtuellen Netzwerk aus, das vom Cloud-PC-Dienst überprüft wurde. Die onPremisesConnectionId-Eigenschaft ist veraltet und gibt ab dem 31. Mai 2024 keine Daten mehr zurück. Verwenden Sie in Zukunft die domainJoinConfigurations-Eigenschaft .
windowsSettings (veraltet) cloudPcWindowsSettings Bestimmte Windows-Einstellungen, die während der Erstellung von Cloud-PCs für diese Bereitstellungsrichtlinie konfiguriert werden müssen. Unterstützt $select. Die windowsSettings-Eigenschaft ist veraltet und gibt ab dem 31. Januar 2024 keine Daten mehr zurück. Verwenden Sie in Zukunft die windowsSetting-Eigenschaft .

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 201 Created Antwortcode und ein cloudPcProvisioningPolicy-Objekt im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/provisioningPolicies
Content-Type: application/json

{
    "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
    "description": "Description value",
    "displayName": "Display Name value",
    "domainJoinConfiguration": {
        "domainJoinType": "hybridAzureADJoin",
        "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff"
    },
    "domainJoinConfigurations": [
      {
        "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff",
        "type": "hybridAzureADJoin"
      },
      {
        "onPremisesConnectionId": "26e16c71-f210-438b-88ac-d481ccafffff",
        "type": "hybridAzureADJoin"
      }
    ],
    "id": "1d164206-bf41-4fd2-8424-a3192d39ffff",
    "enableSingleSignOn": true,
    "imageDisplayName": "Windows-10 19h1-evd",
    "imageId": "MicrosoftWindowsDesktop_Windows-10_19h1-evd",
    "imageType":"gallery",
    "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
    "windowsSettings": {
        "language": "en-US"
    },
    "windowsSetting": {
        "locale": "en-US"
    },
    "provisioningType": "dedicated",
    "userExperienceType": "cloudPc",
    "userSettingsPersistenceConfiguration": {
        "userSettingsPersistenceEnabled": true,
        "userSettingsPersistenceStorageSizeCategory": "fourGB"
    }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.cloudPcProvisioningPolicy",
  "description": "Description value",
  "displayName": "Display Name value",
  "domainJoinConfiguration": {
      "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
      "type": "hybridAzureADJoin"
  },
  "domainJoinConfigurations": [
    {
      "onPremisesConnectionId": "16ee6c71-fc10-438b-88ac-daa1ccafffff",
      "type": "hybridAzureADJoin"
    },
    {
      "onPremisesConnectionId": "26e16c71-f210-438b-88ac-d481ccafffff",
      "type": "hybridAzureADJoin"
    }
  ],
  "microsoftManagedDesktop": {
      "managedType": "notManaged",
      "profile": null
  },
  "autopatch": {
      "autopatchGroupId": null
  },
  "autopilotConfiguration": null,
  "enableSingleSignOn": true,
  "id": "1d164206-bf41-4fd2-8424-a3192d39ffff",
  "imageDisplayName": "Windows-10 19h1-evd",
  "imageId": "MicrosoftWindowsDesktop_Windows-10_19h1-evd",
  "imageType":"gallery",
  "onPremisesConnectionId": "4e47d0f6-6f77-44f0-8893-c0fe1701ffff",
  "windowsSettings": {
    "language": "en-US"
  },
  "windowsSetting": {
      "locale": "en-US"
  },
  "managedBy": "windows365",
  "provisioningType": "dedicated",
  "userSettingsPersistenceConfiguration": {
      "userSettingsPersistenceEnabled": true,
      "userSettingsPersistenceStorageSizeCategory": "fourGB"
  }
}