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 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. |
| Active Directory-Domänenkennwort aktualisieren | Keine | Aktualisieren Sie das Active Directory-Domänenkennwort für eine erfolgreiche cloudPcOnPremisesConnection. Diese API wird unterstützt, wenn der Typ des cloudPcOnPremisesConnection-Objekts lautet hybridAzureADJoin. |
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. Wird nur auf $select zurückgegeben. |
| connectionType | 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. |
| displayName | Zeichenfolge | Der Anzeigename für die Azure-Netzwerkverbindung. |
| 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: 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. |
| 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 . |
| 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 | Boolescher Wert | 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 | Boolescher Wert | 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“. |
| healthCheckPaused | Boolescher Wert |
false , wenn die regulären Integritätsprüfungen für die Netzwerk-/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 festgelegt false . Wenn Sie eine Integritätsprüfung für die Netzwerk-/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. |
| managedBy | cloudPcManagementService | Gibt an, welche Dienste die Azure-Netzwerkverbindung verwalten. Mögliche Werte: windows365, devBox, unknownFutureValue, rpaBox Sie müssen den Anforderungsheader Prefer: include-unknown-enum-members verwenden, um den folgenden Wert in dieser verteilbaren Enumeration abzurufen: rpaBox. 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. |
| 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. |
| resourceGroupId | Zeichenfolge | Die ID der Zielressourcengruppe. Erforderliches Format: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}. |
| 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. |
| 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 . |
cloudPcManagementService-Werte
| Member | Beschreibung |
|---|---|
| devBox | Die Azure-Netzwerkverbindung wurde erfolgreich über Project Fidalgo erstellt. |
| rpaBox | Die Azure-Netzwerkverbindung wurde erfolgreich über das Power Automate-Projekt erstellt. |
| unknownFutureValue | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
| Windows365 | Die Azure-Netzwerkverbindung wurde erfolgreich über Windows 365 erstellt. |
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 |
|---|---|
| misslungen | Integritätsprüfungen benachrichtigen den Kunden, dass die Azure-Netzwerkverbindung nicht ordnungsgemäß konfiguriert oder funktioniert. Bei der Bereitstellung tritt ein Fehler auf. Der Kunde muss das Problem identifizieren und es mithilfe der Anleitungen der Azure-Netzwerkverbindung beheben, damit die Bereitstellung erfolgreich ist. |
| mitteilsam | 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. |
| verabschiedet | Integritätsprüfungen benachrichtigen den Kunden, dass die Azure-Netzwerkverbindung wie beabsichtigt funktioniert. Der Kunde kann seinen Cloud-PC problemlos bereitstellen. |
| anhängig | 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 darüber, dass die Azure-Netzwerkverbindung nicht gemäß den Bewährten Methoden 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",
"healthCheckStatus": "String",
"healthCheckStatusDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail" },
"healthCheckStatusDetails": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails" },
"id": "String (identifier)",
"inUse": "Boolean",
"inUseByCloudPc": "Boolean",
"healthCheckPaused": "Boolean",
"managedBy": "String",
"organizationalUnit": "String",
"resourceGroupId": "String",
"subnetId": "String",
"subscriptionId": "String",
"subscriptionName": "String",
"type": "String",
"virtualNetworkId": "String",
"virtualNetworkLocation": "String"
}