cloudPcOnPremisesConnection-Ressourcentyp

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 Azure Ressourceninformationen dar, die zum Herstellen 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 Listen Sie Eigenschaften und Beziehungen der cloudPcOnPremisesConnection-Objekte auf.
Get cloudPcOnPremisesConnection Lesen Sie die 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 . Eine verwendete Verbindung kann nicht gelöscht werden.
Ausführen von Integritätsprüfungen Keine Führen Sie Integritätsprüfungen für die cloudPcOnPremisesConnection aus.
Active Directory-Domänenkennwort aktualisieren Keine Aktualisieren Sie das Active Directory-Domänenkennwort für eine erfolgreiche cloudPcOnPremisesConnection.

Eigenschaften

Eigenschaft Typ Beschreibung
adDomainName Zeichenfolge Der vollqualifizierte Domänenname (Fully Qualified Domain Name, FQDN) der Active Directory-Domäne, der Sie beitreten möchten. Optional.
adDomainPassword Zeichenfolge Das mit adDomainUsername verknüpfte Kennwort.
adDomainUsername Zeichenfolge 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 Zeichenfolge Die Schnittstellen-URL der Ressource des Partnerdiensts, die mit dieser Azure-Netzwerkverbindung verknüpft ist. Erfordert $select zum Abrufen.
connectionType cloudPcOnPremisesConnectionType Gibt die Methode an, mit der ein bereitgestellter Cloud-PC mit Microsoft Entra verbunden 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 verbunden wird. Die hybridAzureADJoin Option gibt an, ob im aktuellen Mandanten ein lokales AD vorhanden ist und dass der Cloud-PC sowohl dem lokalen AD als auch Microsoft Entra beitritt. Die ausgewählte Option bestimmt auch die Benutzertypen, die zugewiesen werden können und sich bei einem Cloud-PC anmelden können. Mit dieser azureADJoin Option können sowohl Nur-Cloud- als auch Hybridbenutzer zugewiesen werden und sich anmelden, während hybridAzureADJoin sie nur Hybridbenutzern vorbehalten ist. Der Standardwert ist hybridAzureADJoin. Die möglichen Werte sind: hybridAzureADJoin, azureADJoin, unknownFutureValue.
displayName Zeichenfolge Der Anzeigename für die Azure-Netzwerkverbindung.
healthCheckPaused Boolean Gibt an, ob regelmäßige Integritätsprüfungen für die Netzwerk- oder Domänenkonfiguration angehalten oder aktiv sind. false ob die regelmäßigen Integritätsprüfungen der Netzwerk- oder Domänenkonfiguration derzeit aktiv sind. true wenn die Überprüfungen angehalten werden. Wenn Sie einen Erstellungs- oder Aktualisierungsvorgang für eine onPremisesNetworkConnection-Ressource ausführen, wird dieser Wert auf vier Wochen festgelegt false . Wenn Sie erneut eine Integritätsprüfung der Netzwerk- oder Domänenkonfiguration durchführen, wird dieser Wert auf zwei Wochen festgelegt false . Wenn die onPremisesNetworkConnection-Ressource in eine ProvisioningPolicy angefügt oder in den letzten vier Wochen von einem Cloud-PC verwendet wurde, healthCheckPaused wird auf falsefestgelegt. Schreibgeschützt. Der Standardwert ist false.
healthCheckStatus cloudPcOnPremisesConnectionStatus Der Status der letzten Integritätsprüfung, die für die Azure-Netzwerkverbindung durchgeführt wurde. Wenn der Status passedbeispielsweise lautet, hat die Azure-Netzwerkverbindung alle vom Dienst ausgeführten Prüfungen bestanden. Mögliche Werte sind: 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, das zeigt, wie Sie die inUse-Eigenschaft erhalten, finden Sie in Beispiel 2: Abrufen der ausgewählten Eigenschaften einer Azure-Netzwerkverbindung, einschließlich healthCheckStatusDetails. Schreibgeschützt.
healthCheckStatusDetail cloudPcOnPremisesConnectionStatusDetail Gibt die Ergebnisse von Integritätsprüfungen an, die für die lokale Verbindung durchgeführt wurden. Wird nur auf $select zurückgegeben. Ein Beispiel, das zeigt, wie Sie die inUse-Eigenschaft erhalten, finden Sie in Beispiel 2: Abrufen der ausgewählten Eigenschaften einer Azure-Netzwerkverbindung, einschließlich healthCheckStatusDetails. Schreibgeschützt.
id Zeichenfolge Eindeutiger Bezeichner für die Azure-Netzwerkverbindung. Schreibgeschützt.
inUse Boolean When true, wird die Azure-Netzwerkverbindung verwendet. Wenn false, wird die Verbindung nicht verwendet. Eine verwendete Verbindung kann nicht gelöscht werden. Wird nur auf $select zurückgegeben. Ein Beispiel, das zeigt, wie Sie die inUse-Eigenschaft erhalten, finden Sie in Beispiel 2: Abrufen der ausgewählten Eigenschaften einer Azure-Netzwerkverbindung, einschließlich healthCheckStatusDetails. Schreibgeschützt.
inUseByCloudPc Boolean Gibt an, ob ein Cloud-PC diese lokale Netzwerkverbindung verwendet. true wenn dieser von mindestens einem Cloud-PC verwendet wird. Andernfalls false. Schreibgeschützt. Der Standardwert ist false.
managedBy cloudPcManagementService Gibt an, welche Dienste die Azure-Netzwerkverbindung verwalten. Mögliche Werte sind: windows365, devBox, unknownFutureValue, rpaBox, microsoft365Opal, microsoft365BizChat. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Member in dieser entwicklungsfähigen Aufzählung abzurufen: rpaBox, microsoft365Opal, microsoft365BizChat. Schreibgeschützt.
Organizationalunit Zeichenfolge Die Organisationseinheit (OU), in der das Computerkonto erstellt wird. Wenn NULL verbleibt, wird die OU verwendet, die als Standard (ein bekannter Computerobjektcontainer) in Ihrer Active Directory-Domäne (OU) konfiguriert ist. Optional.
resourceGroupId Zeichenfolge Die ID der Zielressourcengruppe. Erforderliches Format: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}.
scopeIds String collection Die Bereichs-IDs der entsprechenden Berechtigung. Derzeit ist dies die ID des Intune-Bereichstags.
subnetId Zeichenfolge Die ID des Zielsubnetzes. Erforderliches Format: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}.
subscriptionId Zeichenfolge Die ID des Azure-Zielabonnements, das Ihrem Mandanten zugeordnet ist.
subscriptionName Zeichenfolge Der Name des Azure-Zielabonnements. Schreibgeschützt.
virtualNetworkId Zeichenfolge Die ID des virtuellen Zielnetzwerks. Erforderliches Format: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}.
virtualNetworkLocation Zeichenfolge Gibt den Ressourcenstandort des virtuellen Zielnetzwerks an. Schreibgeschützter, berechneter Wert.
healthCheckStatusDetails (veraltet) cloudPcOnPremisesConnectionStatusDetails Gibt die Integritätsprüfungen für die Verbindung und deren Ergebnisse an. Wird nur auf $select zurückgegeben. Ein Beispiel, das zeigt, wie Sie die inUse-Eigenschaft erhalten, finden Sie in Beispiel 2: Abrufen der ausgewählten Eigenschaften einer Azure-Netzwerkverbindung, einschließlich healthCheckStatusDetails. Schreibgeschützt. Die healthCheckStatusDetails-Eigenschaft ist veraltet und gibt seit dem 31. Januar 2024 keine Daten mehr zurück. Verwenden Sie in Zukunft die healthCheckStatusDetail-Eigenschaft .
Typ (veraltet) cloudPcOnPremisesConnectionType Gibt die Methode an, mit der ein bereitgestellter Cloud-PC mit Microsoft Entra verbunden 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 verbunden wird. Die hybridAzureADJoin Option gibt an, ob im aktuellen Mandanten ein lokales AD vorhanden ist und dass der Cloud-PC sowohl dem lokalen AD als auch Microsoft Entra beitritt. Die ausgewählte Option bestimmt auch die Benutzertypen, die zugewiesen werden können und sich bei einem Cloud-PC anmelden können. Mit dieser azureADJoin Option können sowohl Nur-Cloud- als auch Hybridbenutzer zugewiesen werden und sich anmelden, während hybridAzureADJoin sie nur Hybridbenutzern vorbehalten ist. Der Standardwert ist hybridAzureADJoin. Die möglichen Werte sind: hybridAzureADJoin, azureADJoin, unknownFutureValue. Die type-Eigenschaft ist veraltet und gibt seit dem 31. Januar 2024 keine Daten mehr zurück. Verwenden Sie in Zukunft die connectionType-Eigenschaft .
subnetPrivateIpDetail cloudPcOnPremisesConnectionSubnetIpDetail Enthält ausführliche Informationen zu den privaten IP-Adressen, die dem Subnetz zugeordnet sind. Wird nur auf $select zurückgegeben. Ein Beispiel, das zeigt, wie bestimmte Eigenschaften mit $selectabgerufen werden, finden Sie unter Beispiel 2: Abrufen der ausgewählten Eigenschaften einer Azure-Netzwerkverbindung, einschließlich healthCheckStatusDetails. Schreibgeschützt.

cloudPcManagementService-Werte

Member Beschreibung
Windows 365 Azure-Netzwerkverbindung wurde erfolgreich über Windows 365 erstellt.
devBox Azure-Netzwerkverbindung wurde erfolgreich über Projekt Fidalgo erstellt.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.
rpaBox Die Azure-Netzwerkverbindung wurde erfolgreich über das Power Automate-Projekt erstellt.
Microsoft365Opal Gibt an, dass die Azure-Netzwerkverbindung des Cloud-PCs erfolgreich über Project Opal erstellt wurde.
microsoft365BizChat Gibt an, dass die Azure-Netzwerkverbindung des Cloud-PCs erfolgreich über Project Biz-Chat erstellt wurde.

cloudPcOnPremisesConnectionType-Werte

Member Beschreibung
azureADJoin Nur mit Microsoft Entra ID verknüpft. Nur- und Hybridbenutzer können zugewiesen werden und sich am Cloud-PC anmelden.
hybridAzureADJoin Mit lokalem Active Directory und Microsoft Entra ID verknüpft. Nur Hybridbenutzer können zugewiesen werden und sich beim Cloud-PC anmelden.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.

cloudPcOnPremisesConnectionStatus-Werte

Member Beschreibung
Fehler Integritätsprüfungen benachrichtigen den Kunden, dass die Azure-Netzwerkverbindung nicht ordnungsgemäß konfiguriert ist oder nicht ordnungsgemäß funktioniert. Die Bereitstellung schlägt fehl. Der Kunde muss das Problem identifizieren und anhand der von der Azure-Netzwerkverbindung bereitgestellten Anleitung beheben, damit die Bereitstellung erfolgreich ist.
informativ Integritätsprüfungen liefern dem Kunden Informationen über aktuelle oder zugehörige Voraussetzungsprüfungen für Cloud PC-Add-On-Features wie einmaliges Anmelden. Informationsbasierte Integritätsprüfungen wirken sich nicht auf die Bereitstellung des Cloud-PCs des Kunden aus. Die Informationen sollen die User Experience optimieren.
bestanden Integritätsprüfungen informieren den Kunden, dass die Azure-Netzwerkverbindung wie vorgesehen funktioniert. Der Kunde kann seinen Cloud-PC problemlos bereitstellen.
ausstehend Erstellt und wartet auf Integritätsprüfungen.
Wird ausgeführt Integritätsprüfungen werden ausgeführt.
unknownFutureValue Evolvable Enumeration Sentinel-Wert. Nicht verwenden.
warning Integritätsprüfungen benachrichtigen den Kunden, dass die Azure-Netzwerkverbindung nicht gemäß den bewährten Methoden von Microsoft konfiguriert ist, z. B. Endpunktkonnektivität. Der Kunde sollte erforderliche Endpunkte für den Cloud-PC konfigurieren, bevor er einen Cloud-PC bereitstellt. Dies hat keine Auswirkungen auf die Bereitstellung des Cloud-PCs des Kunden, kann sich aber auf die Erfahrung des Kunden auswirken.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "adDomainName": "String",
  "adDomainPassword": "String",
  "adDomainUsername": "String",
  "alternateResourceUrl": "String",
  "connectionType": "String",
  "displayName": "String",
  "healthCheckPaused": "Boolean",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail" },
  "healthCheckStatusDetails": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails" },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "inUseByCloudPc": "Boolean",
  "managedBy": "String",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "scopeIds": ["String"],
  "subnetId": "String",
  "subnetPrivateIpDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionSubnetIpDetail" },
  "subscriptionId": "String",
  "subscriptionName": "String",
  "type": "String",
  "virtualNetworkId": "String",
  "virtualNetworkLocation": "String"
}
  • Last updated on