cloudPcOnPremisesConnection-Ressourcentyp

Artikel
06/21/2022
3 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt eine definierte Sammlung von Azure-Ressourceninformationen dar, die zum Herstellen 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 Sie die Eigenschaften und Beziehungen des cloudPcOnPremisesConnection-Objekts .
Erstellen von cloudPcOnPremisesConnection	cloudPcOnPremisesConnection	Erstellen Sie ein neues cloudPcOnPremisesConnection-Objekt .
cloudPcOnPremisesConnection aktualisieren	cloudPcOnPremisesConnection	Dient zum Aktualisieren der Eigenschaften eines cloudPcOnPremisesConnection-Objekts .
cloudPcOnPremisesConnection löschen	Keine	Löschen eines cloudPcOnPremisesConnection-Objekts . Sie können eine verwendete Verbindung nicht löschen.
RunHealthChecks von 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 objekts "cloudPcOnPremisesConnection " 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.
displayName	String	Der Anzeigename für die Azure-Netzwerkverbindung.
healthCheckStatus	cloudPcOnPremisesConnectionStatus	Der Status der letzten Integritätsprüfung, die für die Azure-Netzwerkverbindung durchgeführt wurde. Wenn beispielsweise der Status lautet `passed`, hat die Azure-Netzwerkverbindung alle vom Dienst ausgeführten Prüfungen bestanden. Mögliche Werte: `pending`, `running`, `passed`, `failed`, `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.
id	String	Eindeutiger Bezeichner für die Azure-Netzwerkverbindung. Schreibgeschützt.
inUse	Boolesch	Wann `true`wird die Azure-Netzwerkverbindung verwendet. When `false`, the connection is not in use. 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. Die folgenden Werte sind möglich: `windows365`, `devBox,` `unknownFutureValue`. Schreibgeschützt.
Organizationalunit	String	Die Organisationseinheit (OU), in der das Computerkonto erstellt wird. Wenn null gelassen wird, wird die OU verwendet, die als Standard (ein bekannter Computerobjektcontainer) in Ihrer Active Directory-Domäne (OU) konfiguriert ist. Optional.
resourceGroupId	String	Die ID der Zielressourcengruppe. Erforderliches Format: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}`.
subnetz-ID	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.
Typ	cloudPcOnPremisesConnectionType	Gibt an, wie der bereitgestellte Cloud-PC mit Azure Active Directory verknüpft wird. Der Standardwert ist `hybridAzureADJoin`. Mögliche Werte sind: `azureADJoin`, `hybridAzureADJoin` und `unknownFutureValue`.
virtualNetworkId	String	Die ID des virtuellen Zielnetzwerks. Erforderliches Format: `/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}`.

cloudPcManagementService-Werte

Element	Wert	Beschreibung
Windows365	1	Die Azure-Netzwerkverbindung wurde erfolgreich über Windows365 erstellt.
devBox	2	Die Azure-Netzwerkverbindung wurde erfolgreich über Project Fidalgo erstellt.
unknownFutureValue	4	Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

cloudPcOnPremisesConnectionType-Werte

Member	Beschreibung
hybridAzureADJoin	In lokales Active Directory und Azure AD eingebunden. Nur Hybridbenutzer können zugewiesen werden und sich beim Cloud-PC anmelden.
azureADJoin	Nur in Azure AD eingebunden. Nur-Cloud- und Hybridbenutzer können zugewiesen werden und sich beim Cloud-PC anmelden.
unknownFutureValue	Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

cloudPcOnPremisesConnectionStatus-Werte

Member	Beschreibung
Ausstehende	Erstellt und wartet auf Integritätsprüfungen.
Ausgeführte	Integritätsprüfungen werden ausgeführt.
Übergeben	Integritätsprüfungen wurden bestanden.
Fehlgeschlagen	Fehler bei Integritätsprüfungen.
warning	Integritätsprüfungen mit Warnung übergeben.
unknownFutureValue	Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

Beziehungen

Keine.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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