cloudPcOnPremisesConnection-Ressourcentyp

Artikel
04/18/2024

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.

Stellt eine definierte Sammlung von Azure-Ressourceninformationen dar, die zum Einrichten der Azure-Netzwerkkonnektivität für Cloud-PCs verwendet werden können.

Wichtig

Die lokale Netzwerkverbindung wurde in Azure-Netzwerkverbindung umbenannt. cloudPcOnPremisesConnection-Objekte entsprechen hier der Azure-Netzwerkverbindung für das Cloud-PC-Produkt.

Methoden

Methode	Rückgabetyp	Beschreibung
OnPremisesConnections auflisten	cloudPcOnPremisesConnection-Sammlung	Auflisten der Eigenschaften und Beziehungen der cloudPcOnPremisesConnection-Objekte .
Abrufen von cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Lesen der Eigenschaften und Beziehungen des cloudPcOnPremisesConnection-Objekts .
Erstellen von cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Erstellen Sie ein neues cloudPcOnPremisesConnection-Objekt .
Aktualisieren von cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Aktualisieren sie die Eigenschaften eines cloudPcOnPremisesConnection-Objekts .
Löschen von cloudPcOnPremisesConnection	Keine	Löschen sie ein cloudPcOnPremisesConnection-Objekt . Sie können eine verwendete Verbindung nicht löschen.
RunHealthChecks of a cloudPcOnPremisesConnection (RunHealthChecks of a cloudPcOnPremisesConnection)	Keine	Führen Sie Integritätsprüfungen für cloudPcOnPremisesConnection aus.
updateAdDomainPassword	Keine	Aktualisieren Sie das Active Directory-Domänenkennwort für eine erfolgreiche cloudPcOnPremisesConnection. Diese API wird unterstützt, wenn der Typ des cloudPcOnPremisesConnection-Objekts lautet `hybridAzureADJoin`.

Eigenschaften

Eigenschaft	Typ	Beschreibung
adDomainName	String	Der vollqualifizierte Domänenname (FQDN) der Active Directory-Domäne, der Sie beitreten möchten. Optional.
adDomainPassword	String	Das Kennwort, das adDomainUsername zugeordnet ist.
adDomainUsername	String	Der Benutzername eines Active Directory-Kontos (Benutzer- oder Dienstkonto), das über Berechtigungen zum Erstellen von Computerobjekten in Active Directory verfügt. Erforderliches Format: `admin@contoso.com`. Optional.
alternateResourceUrl	String	Die Schnittstellen-URL der Ressource des Partnerdiensts, die mit dieser Azure-Netzwerkverbindung verknüpft ist. Wird nur auf `$select` zurückgegeben.
connectionType	cloudPcOnPremisesConnectionType	Gibt die Methode an, mit der ein bereitgestellter Cloud-PC mit Microsoft Entra verknüpft wird. Die `azureADJoin` Option gibt an, dass im aktuellen Mandanten kein lokales Active Directory (AD) vorhanden ist, was dazu führt, dass das Cloud-PC-Gerät nur mit Microsoft Entra verknüpft wird. Die `hybridAzureADJoin` Option gibt an, dass ein lokales AD im aktuellen Mandanten vorhanden ist und dass der Cloud-PC sowohl mit dem lokalen AD als auch Microsoft Entra verknüpft wird. Die ausgewählte Option bestimmt auch die Benutzertypen, die zugewiesen werden können und sich bei einem Cloud-PC anmelden können. Mit `azureADJoin` der Option können sowohl reine Cloudbenutzer als auch Hybridbenutzer zugewiesen und angemeldet werden, während `hybridAzureADJoin` sie nur auf Hybridbenutzer beschränkt ist. Der Standardwert ist `hybridAzureADJoin`. Die möglichen Werte sind: `hybridAzureADJoin`, `azureADJoin`, `unknownFutureValue`.
displayName	String	Der Anzeigename für die Azure-Netzwerkverbindung.
healthCheckStatus	cloudPcOnPremisesConnectionStatus	Die status der letzten Integritätsprüfung, die für die Azure-Netzwerkverbindung durchgeführt wurde. Wenn die status beispielsweise ist, hat `passed`die Azure-Netzwerkverbindung alle vom Dienst ausgeführten Überprüfungen bestanden. Mögliche Werte: `pending`, `running`, `passed`, `failed`, `warning`, `informational`, `unknownFutureValue`. Schreibgeschützt.
healthCheckStatusDetails	cloudPcOnPremisesConnectionStatusDetails	Die Details der Integritätsprüfungen der Verbindung und die entsprechenden Ergebnisse. Wird nur auf `$select` zurückgegeben. Ein Beispiel zum Abrufen der inUse-Eigenschaft finden Sie unter Beispiel 2: Abrufen der ausgewählten Eigenschaften einer Azure-Netzwerkverbindung, einschließlich healthCheckStatusDetails. Schreibgeschützt.
healthCheckStatusDetails (veraltet)	cloudPcOnPremisesConnectionStatusDetails	Gibt die Integritätsprüfungen für die Verbindung und die entsprechenden Ergebnisse an. Wird nur auf `$select` zurückgegeben. Ein Beispiel zum Abrufen der inUse-Eigenschaft finden Sie unter Beispiel 2: Abrufen der ausgewählten Eigenschaften einer Azure-Netzwerkverbindung, einschließlich healthCheckStatusDetails. Schreibgeschützt. Die HealthCheckStatusDetails-Eigenschaft ist veraltet und gibt am 31. Januar 2024 keine Daten mehr zurück. Goind forward, use the healthCheckStatusDetail property.
healthCheckStatusDetail	cloudPcOnPremisesConnectionStatusDetail	Gibt die Ergebnisse von Integritätsprüfungen an, die für die lokale Verbindung durchgeführt werden. Wird nur auf `$select` zurückgegeben. Ein Beispiel zum Abrufen der inUse-Eigenschaft finden Sie unter Beispiel 2: Abrufen der ausgewählten Eigenschaften einer Azure-Netzwerkverbindung, einschließlich healthCheckStatusDetails. Schreibgeschützt.
id	String	Eindeutiger Bezeichner für die Azure-Netzwerkverbindung. Schreibgeschützt.
inVerwenden	Boolesch	Bei `true`wird die Azure-Netzwerkverbindung verwendet. Bei `false`wird die Verbindung nicht verwendet. Sie können eine verwendete Verbindung nicht löschen. Wird nur auf `$select` zurückgegeben. Ein Beispiel zum Abrufen der inUse-Eigenschaft finden Sie unter Beispiel 2: Abrufen der ausgewählten Eigenschaften einer Azure-Netzwerkverbindung, einschließlich healthCheckStatusDetails. Schreibgeschützt.
Managedby	cloudPcManagementService	Gibt an, welche Dienste die Azure-Netzwerkverbindung verwalten. Mögliche Werte: `windows365`, `devBox`, `unknownFutureValue`, `rpaBox` Sie müssen den `Prefer: include-unknown-enum-members` Anforderungsheader verwenden, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: `rpaBox`. Schreibgeschützt.
Organizationalunit	String	Die Organisationseinheit (OE), in der das Computerkonto erstellt wird. Wenn null gelassen wird, wird die Organisationseinheit verwendet, die als Standard (ein bekannter Computerobjektcontainer) in Ihrer Active Directory-Domäne (OU) konfiguriert ist. Optional.
Organizationalunit	String	Die Organisationseinheit (OE), in der das Computerkonto erstellt wird. Wenn null gelassen wird, wird die organisationseinheit verwendet, die als Standard (ein bekannter Computerobjektcontainer) in Ihrer Active Directory-Domäne (OE) konfiguriert ist. Optional.
virtualNetworkId	String	Die ID des virtuellen Zielnetzwerks. Erforderliches Format: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}`.
virtualNetworkLocation	String	Gibt den Ressourcenspeicherort des virtuellen Zielnetzwerks an. Schreibgeschützter, berechneter Wert.
resourceGroupId	String	Die ID der Zielressourcengruppe. Erforderliches Format: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}`.
subnetId	String	Die ID des Zielsubnetzes. Erforderliches Format: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}`.
subscriptionId	String	Die ID des Azure-Zielabonnements, das Ihrem Mandanten zugeordnet ist.
subscriptionName	String	Der Name des Azure-Zielabonnements. Schreibgeschützt.
type (veraltet)	cloudPcOnPremisesConnectionType	Gibt die Methode an, mit der ein bereitgestellter Cloud-PC mit Microsoft Entra verknüpft wird. Die `azureADJoin` Option gibt an, dass im aktuellen Mandanten kein lokales Active Directory (AD) vorhanden ist, was dazu führt, dass das Cloud-PC-Gerät nur mit Microsoft Entra verknüpft wird. Die `hybridAzureADJoin` Option gibt an, dass ein lokales AD im aktuellen Mandanten vorhanden ist und dass der Cloud-PC sowohl mit dem lokalen AD als auch Microsoft Entra verknüpft wird. Die ausgewählte Option bestimmt auch die Benutzertypen, die zugewiesen werden können und sich bei einem Cloud-PC anmelden können. Mit `azureADJoin` der Option können sowohl reine Cloudbenutzer als auch Hybridbenutzer zugewiesen und angemeldet werden, während `hybridAzureADJoin` sie nur auf Hybridbenutzer beschränkt ist. Der Standardwert ist `hybridAzureADJoin`. Die möglichen Werte sind: `hybridAzureADJoin`, `azureADJoin`, `unknownFutureValue`. Die type-Eigenschaft ist veraltet und gibt am 31. Januar 2024 keine Daten mehr zurück. Gehen Sie vorwärts, verwenden Sie die connectionType-Eigenschaft .

cloudPcManagementService-Werte

Member	Beschreibung
devBox	Die Azure-Netzwerkverbindung wurde erfolgreich über Project Fidalgo erstellt.
rpaBox	Die Azure-Netzwerkverbindung wurde erfolgreich über das Power Automate-Projekt erstellt.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.
Windows365	Die Azure-Netzwerkverbindung wurde erfolgreich über Windows 365 erstellt.

cloudPcOnPremisesConnectionType-Werte

Member	Beschreibung
azureADJoin	Nur mit Microsoft Entra ID verknüpft. Reine Cloud- und Hybridbenutzer können zugewiesen werden und sich beim Cloud-PC anmelden.
hybridAzureADJoin	Mit lokales Active Directory und Microsoft Entra ID verknüpft. Nur Hybridbenutzer können zugewiesen werden und sich beim Cloud-PC anmelden.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

cloudPcOnPremisesConnectionStatus-Werte

Member	Beschreibung
Fehlgeschlagen	Integritätsprüfungen benachrichtigen den Kunden, dass die Azure-Netzwerkverbindung nicht ordnungsgemäß konfiguriert oder funktioniert. Bei der Bereitstellung tritt ein Fehler auf. Der Kunde muss das Problem identifizieren und es mithilfe der Anleitungen der Azure-Netzwerkverbindung beheben, damit die Bereitstellung erfolgreich ist.
Informations	Integritätsprüfungen stellen dem Kunden Informationen zu aktuellen oder zugehörigen Voraussetzungsprüfungen für Cloud PC-Add-On-Features wie einmaliges Anmelden bereit. Dies wirkt sich nicht auf die Bereitstellung des Cloud-PCs des Kunden aus, aber die Informationen sollen die Benutzerfreundlichkeit optimieren.
Übergeben	Integritätsprüfungen benachrichtigen den Kunden, dass die Azure-Netzwerkverbindung wie beabsichtigt funktioniert. Der Kunde kann seinen Cloud-PC problemlos bereitstellen.
Ausstehende	Erstellt und wartet auf Integritätsprüfungen.
Ausgeführte	Integritätsprüfungen werden ausgeführt.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.
warning	Integritätsprüfungen benachrichtigen den Kunden darüber, dass die Azure-Netzwerkverbindung nicht gemäß den Bewährten Methoden von Microsoft konfiguriert ist, z. B. Endpunktkonnektivität. Der Kunde sollte die erforderlichen Cloud-PC-Endpunkte vor der Bereitstellung eines Cloud-PCs konfigurieren. Dies wirkt sich nicht auf die Bereitstellung des Cloud-PCs des Kunden aus, sondern kann sich auf die Benutzerfreundlichkeit des Kunden auswirken.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "adDomainName": "String",
  "adDomainPassword": "String",
  "adDomainUsername": "String",
  "alternateResourceUrl": "String",
  "connectionType": "String",
  "displayName": "String",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail" },
  "healthCheckStatusDetails": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails" },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "managedBy": "String",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "subnetId": "String",
  "subscriptionId": "String",
  "subscriptionName": "String",
  "type": "String",
  "virtualNetworkId": "String",
  "virtualNetworkLocation": "String"
}