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 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.
Active Directory-Domänenkennwort aktualisieren Keine Aktualisieren Sie das Active Directory-Domänenkennwort für eine erfolgreiche cloudPcOnPremisesConnection.Update the Active Directory domain password for a successful cloudPcOnPremisesConnection.

Eigenschaften

Eigenschaft Typ Beschreibung
adDomainName Zeichenfolge Der vollqualifizierte Domänenname (FQDN) der Active Directory-Domäne, der Sie beitreten möchten. Optional.
adDomainPassword Zeichenfolge Das Kennwort, das adDomainUsername zugeordnet ist.
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 den Abruf.
connectionType cloudPcOnPremisesConnectionType Gibt die Methode an, mit der ein bereitgestellter Cloud-PC mit Microsoft Entra verknüpft wird. Die azureADJoin Option gibt das Fehlen eines lokales Active Directory (AD) im aktuellen Mandanten an, 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 Zeichenfolge Der Anzeigename für die Azure Netzwerkverbindung.
healthCheckPaused Boolean Gibt an, ob regelmäßige Integritätsprüfungen in der Netzwerk- oder Domänenkonfiguration angehalten oder aktiv sind. false , wenn die regulären Integritätsprüfungen für die 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 für vier Wochen auf false festgelegt. Wenn Sie eine Integritätsprüfung für die Netzwerk- oder Domänenkonfiguration wiederholen, wird dieser Wert für zwei Wochen auf false festgelegt. Wenn die onPremisesNetworkConnection-Ressource in einer 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 Die status der letzten Integritätsprüfung, die für die Azure Netzwerkverbindung durchgeführt wurde. Wenn die status beispielsweise ist, hat passeddie Azure Netzwerkverbindung alle vom Dienst ausgeführten Überprü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 zum Abrufen der inUse-Eigenschaft finden Sie unter 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 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 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. 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.
inUseByCloudPc Boolean Gibt an, ob ein Cloud-PC diese lokale Netzwerkverbindung verwendet. true , wenn mindestens ein Cloud-PC es verwendet. falseAndernfalls . 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 Anforderungsheader Prefer: include-unknown-enum-members , um die folgenden Member in dieser verwertbaren Enumeration abzurufen: rpaBox, microsoft365Opal, microsoft365BizChat. 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 Ihrer Active Directory-Domäne (OE) konfiguriert ist. Optional.
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 Ihrer Active Directory-Domäne (OE) 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 Intune Bereichstag-ID.
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 Zielabonnements Azure, das Ihrem Mandanten zugeordnet ist.
subscriptionName Zeichenfolge Der Name des Zielabonnements Azure. 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 Ressourcenspeicherort des virtuellen Zielnetzwerks an. Schreibgeschützter, berechneter Wert.
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. Verwenden Sie in Zukunft die HealthCheckStatusDetail-Eigenschaft .
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. 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 zum Abrufen bestimmter Eigenschaften mit $selectfinden Sie unter Beispiel 2: Abrufen der ausgewählten Eigenschaften einer Azure Netzwerkverbindung, einschließlich healthCheckStatusDetails. Schreibgeschützt.

cloudPcManagementService-Werte

Member Beschreibung
Windows365 Azure Netzwerkverbindung wurde erfolgreich über Windows 365 erstellt.
devBox Azure Netzwerkverbindung wurde erfolgreich über Project Fidalgo erstellt.
unknownFutureValue Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.
rpaBox Die Azure Netzwerkverbindung wurde erfolgreich über das Power Automate-Projekt erstellt.
microsoft365Opal Gibt an, dass die Cloud-PC-Azure Netzwerkverbindung erfolgreich über das Projekt Opal erstellt wurde.
microsoft365BizChat Gibt an, dass die Cloud-PC-Azure Netzwerkverbindung erfolgreich über den Project Biz Chat erstellt wurde.

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 ist oder nicht ordnungsgemäß funktioniert. Bei der Bereitstellung tritt ein Fehler auf. Der Kunde muss das Problem identifizieren und mithilfe der Anleitungen von 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. Informationsintegritätsprüfungen wirken sich nicht auf die Bereitstellung des Cloud-PCs des Kunden aus. Die Informationen sollen die Benutzererfahrung 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, dass die Azure Netzwerkverbindung nicht gemäß den Best Practices 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 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