cloudPcOnPremisesConnection-Ressourcentyp

Artikel
11/22/2024

Namespace: microsoft.graph

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
List	cloudPcOnPremisesConnection-Sammlung	Auflisten der Eigenschaften und Beziehungen der cloudPcOnPremisesConnection-Objekte .
Get	cloudPcOnPremisesConnection	Lesen der Eigenschaften und Beziehungen des cloudPcOnPremisesConnection-Objekts .
Create	cloudPcOnPremisesConnection	Erstellen Sie ein neues cloudPcOnPremisesConnection-Objekt .
Update	cloudPcOnPremisesConnection	Aktualisieren sie die Eigenschaften eines cloudPcOnPremisesConnection-Objekts .
Löschen	Keine	Löschen sie ein cloudPcOnPremisesConnection-Objekt . Sie können eine verwendete Verbindung nicht löschen.
Ausführen von Integritätsprüfungen	Keine	Führen Sie Integritätsprüfungen für cloudPcOnPremisesConnection aus.

Eigenschaften

Eigenschaft	Typ	Beschreibung
adDomainName	String	Der vollqualifizierte Domänenname (FQDN) der Active Directory-Domäne, der Sie beitreten möchten. Die maximale Länge beträgt 255. Optional.
adDomainPassword	String	Das Kennwort, das dem Benutzernamen eines Active Directory-Kontos (adDomainUsername) zugeordnet ist.
adDomainUsername	String	Der Benutzername eines Active Directory-Kontos (Benutzer- oder Dienstkonto), das über die Berechtigung 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 an, wie der bereitgestellte Cloud-PC mit Microsoft Entra verknüpft wird. Es umfasst verschiedene Typen, einer ist Microsoft Entra ID Join, was bedeutet, dass es keine lokales Active Directory (AD) im aktuellen Mandanten gibt, und das Cloud-PC-Gerät wird durch Microsoft Entra verbunden. Eine andere ist hybridAzureADJoin, was bedeutet, dass auch ein lokales Active Directory (AD) im aktuellen Mandanten vorhanden ist und das Cloud-PC-Gerät mit lokales Active Directory (AD) und Microsoft Entra verknüpft wird. Der Typ bestimmt auch, welche Benutzertypen zugewiesen werden können und sich bei einem Cloud-PC anmelden können. Der Typ azureADJoin gibt an, dass reine Cloud- und Hybridbenutzer zugewiesen und am Cloud-PC angemeldet werden können. hybridAzureADJoin gibt an, dass nur Hybridbenutzer zugewiesen und am Cloud-PC angemeldet werden können. Der Standardwert ist `hybridAzureADJoin`.
displayName	String	Der Anzeigename für die Azure-Netzwerkverbindung.
healthCheckStatus	cloudPcOnPremisesConnectionStatus	Die status der letzten Integritätsprüfung, die für die lokale Verbindung durchgeführt wurde. Wenn die status beispielsweise ist, hat `passed`die lokale Verbindung alle vom Dienst ausgeführten Überprüfungen bestanden. Mögliche Werte: `pending`, `running`, `passed`, `failed`, `warning`, . `informational` Der Standardwert ist `pending`. Schreibgeschützt.
healthCheckStatusDetail	cloudPcOnPremisesConnectionStatusDetail	Gibt die Ergebnisse von Integritätsprüfungen an, die für die lokale Verbindung durchgeführt werden. Schreibgeschützt. 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 healthCheckStatusDetail. 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 healthCheckStatusDetail. 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 der Active Directory-Domäne (OU) des Mandanten konfiguriert ist. Optional.
resourceGroupId	String	Der eindeutige Bezeichner der Zielressourcengruppe, die der lokalen Netzwerkkonnektivität für Cloud-PCs zugeordnet ist. Erforderliches Format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}"
subnetId	String	Der eindeutige Bezeichner des Zielsubnetzes, das der lokalen Netzwerkkonnektivität für Cloud-PCs zugeordnet ist. Erforderliches Format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}"
subscriptionId	String	Der eindeutige Bezeichner des Azure-Abonnements, das dem Mandanten zugeordnet ist.
subscriptionName	String	Der Name des Azure-Abonnements wird verwendet, um eine Azure-Netzwerkverbindung zu erstellen. Schreibgeschützt.
virtualNetworkId	String	Der eindeutige Bezeichner des virtuellen Zielnetzwerks, das der lokalen Netzwerkkonnektivität für Cloud-PCs zugeordnet ist. Erforderliches Format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}"
virtualNetworkLocation	String	Gibt den Ressourcenspeicherort des virtuellen Zielnetzwerks an. Der Standort kann z. B. eastus2, westeurope usw. sein. Schreibgeschützt (berechneter Wert).

cloudPcOnPremisesConnectionType-Werte

Member	Beschreibung
azureADJoin	Gibt an, dass Cloud-PC-Geräte nur mit Microsoft Entra ID verknüpft sind.
hybridAzureADJoin	Gibt an, dass Cloud-PC-Geräte mit lokales Active Directory verknüpft und bei Microsoft Entra ID registriert sind.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

cloudPcOnPremisesConnectionStatus-Werte

Member	Beschreibung
misslungen	Gibt an, dass die Integritätsprüfungen der Azure-Netzwerkverbindung für Cloud-PC jetzt mit Fehlern abgeschlossen wurden. Die Umgebung des Kunden ist nicht ordnungsgemäß konfiguriert, was zu einem Fehler bei der Bereitstellung von Cloud-PCs führt. Der Kunde muss das Problem anhand der Anleitungen der lokalen Verbindung für die erfolgreiche Bereitstellung identifizieren und beheben.
mitteilsam	Gibt an, dass die Integritätsprüfungen der Azure-Netzwerkverbindung für Cloud-PC mit Informationen zur Integritätsprüfung jetzt abgeschlossen wurden. Integritätsprüfungen stellen Kunden Informationen zu aktuellen oder zugehörigen Voraussetzungsprüfungen status Add-On-Features für Cloud-PC bereit, z. B. einmaliges Anmelden. Dies wirkt sich nicht auf die Bereitstellung der Cloud-PCs unserer Kunden aus, beabsichtigt jedoch die Optimierung der Benutzerfreundlichkeit.
verabschiedet	Gibt an, dass die Integritätsprüfungen der Azure-Netzwerkverbindung für Cloud-PC abgeschlossen und bestanden wurden. Der Kunde kann seinen Cloud-PC problemlos bereitstellen.
anhängig	Standard. Gibt an, dass die Integritätsprüfung der Azure-Netzwerkverbindung für Cloud-PC initiiert wurde und auf den Abschluss wartet.
Ausgeführte	Gibt an, dass die Integritätsprüfungen der Azure-Netzwerkverbindung für Cloud-PC noch ausgeführt werden.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.
warning	Gibt an, dass die Integritätsprüfungen der Azure-Netzwerkverbindung für Cloud-PC jetzt mit Fehlern abgeschlossen wurden. Die Umgebung des Kunden ist nicht ordnungsgemäß konfiguriert, was zu einem Fehler bei der Bereitstellung von Cloud-PCs führt. Der Kunde muss das Problem anhand der Anleitungen der lokalen Verbindung für die erfolgreiche Bereitstellung identifizieren und beheben.

Beziehungen

Keine.

JSON-Darstellung

Das folgende Beispiel zeigt den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "adDomainName": "String",
  "adDomainPassword": "String",
  "adDomainUsername": "String",
  "alternateResourceUrl": "String",
  "displayName": "String",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": {
    "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail",
    "endDateTime": "String (timestamp)",
    "healthChecks": [
      {
        "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionHealthCheck",
        "additionalDetail": "String",
        "displayName": "String",
        "endDateTime": "String (timestamp)",
        "errorType": "String",
        "recommendedAction": "String",
        "correlationId": "String",
        "startDateTime": "String (timestamp)",
        "status": "String"
      }
    ],
    "startDateTime": "String (timestamp)"
  },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "subnetId": "String",
  "subscriptionId": "String",
  "subscriptionName": "String",
  "connnecetionType": "String",
  "virtualNetworkId": "String"
}

Freigeben über