Freigeben über


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"
}