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 | Create ein neues cloudPcOnPremisesConnection-Objekt. |
Update | cloudPcOnPremisesConnection | Aktualisieren sie die Eigenschaften eines cloudPcOnPremisesConnection-Objekts . |
Delete | 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. |
Aktualisieren des Active Directory-Domänenkennworts | 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 passed die 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. Goind forward, use the healthCheckStatusDetail property. |
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 | Boolesch | Bei true wird die Azure-Netzwerkverbindung verwendet. Bei false wird 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. |
Managedby | cloudPcManagementService | Gibt an, welche Dienste die Azure-Netzwerkverbindung verwalten. Mögliche Werte: windows365 , devBox , unknownFutureValue , rpaBox Sie müssen den Prefer: include-unknown-enum-members Anforderungsheader verwenden, um die folgenden Werte 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 (OU) 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. Gehen Sie vorwärts, verwenden Sie 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 |
---|---|
Fehlgeschlagen | 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. |
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. Dies wirkt sich nicht auf die Bereitstellung des Cloud-PCs des Kunden aus, aber die Informationen sollen die Benutzerfreundlichkeit 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 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 zeigt 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",
"managedBy": "String",
"organizationalUnit": "String",
"resourceGroupId": "String",
"subnetId": "String",
"subscriptionId": "String",
"subscriptionName": "String",
"type": "String",
"virtualNetworkId": "String",
"virtualNetworkLocation": "String"
}
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für