Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Stellt eine definierte Auflistung von Azure Ressourceninformationen dar, die zum Einrichten Azure Netzwerkkonnektivität für Cloud-PCs verwendet werden können.
Wichtig
Die lokale Netzwerkverbindung wurde in Azure Netzwerkverbindung umbenannt. cloudPcOnPremisesConnection-Objekte entsprechen hier 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 | Zeichenfolge | Der vollqualifizierte Domänenname (FQDN) der Active Directory-Domäne, der Sie beitreten möchten. Die maximale Länge beträgt 255. Optional. |
| adDomainPassword | Zeichenfolge | Das Kennwort, das dem Benutzernamen eines Active Directory-Kontos (adDomainUsername) zugeordnet ist. |
| adDomainUsername | Zeichenfolge | 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 | Zeichenfolge | Die Schnittstellen-URL der Ressource des Partnerdiensts, die mit dieser Azure Netzwerkverbindung verknüpft ist. Erfordert $select den Abruf. |
| 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 | Zeichenfolge | 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 passeddie 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. Erfordert $select den Abruf. 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 | Zeichenfolge | Eindeutiger Bezeichner für die Azure Netzwerkverbindung. Schreibgeschützt. |
| inVerwenden | Boolean | Bei truewird die Azure Netzwerkverbindung verwendet. Bei falsewird die Verbindung nicht verwendet. Sie können eine verwendete Verbindung nicht löschen. Erfordert $select den Abruf. 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 | Zeichenfolge | 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 | Zeichenfolge | Der eindeutige Bezeichner der Zielressourcengruppe, die der lokalen Netzwerkkonnektivität für Cloud-PCs zugeordnet ist. Erforderliches Format: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}" |
| subnetId | Zeichenfolge | 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 | Zeichenfolge | Der eindeutige Bezeichner des Azure Abonnement, das dem Mandanten zugeordnet ist. |
| subscriptionName | Zeichenfolge | Der Name des Azure-Abonnements wird verwendet, um eine Azure Netzwerkverbindung zu erstellen. Schreibgeschützt. |
| virtualNetworkId | Zeichenfolge | 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 | Zeichenfolge | 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 |
|---|---|
| Fehlgeschlagen | Gibt an, dass die Integritätsprüfungen der Cloud-PC-Azure Netzwerkverbindung 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. |
| Informations | Gibt an, dass die Integritätsprüfungen der Cloud-PC-Azure Netzwerkverbindung mit Informationen zur Integritätsprüfung jetzt abgeschlossen sind. 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. |
| Übergeben | Gibt an, dass die Integritätsprüfungen der Cloud-PC-Azure Netzwerkverbindung abgeschlossen und bestanden wurden. Der Kunde kann seinen Cloud-PC problemlos bereitstellen. |
| Ausstehende | Standard. Gibt an, dass Azure Integritätsprüfung der Netzwerkverbindung initiiert wurde und auf den Abschluss wartet. |
| Ausgeführte | Gibt an, dass die Integritätsprüfungen der Cloud-PC-Azure Netzwerkverbindung noch ausgeführt werden. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
| warning | Gibt an, dass die Integritätsprüfungen der Cloud-PC-Azure Netzwerkverbindung 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"
}