cloudPcOnPremisesConnection リソースの種類

[アーティクル]
04/01/2024

名前空間: microsoft.graph

クラウド PC の Azure ネットワーク接続を確立するために使用できる Azure リソース情報の定義済みのコレクションを表します。

重要

オンプレミスのネットワーク接続 の名前が Azure ネットワーク接続として変更されました。 cloudPcOnPremisesConnection オブジェクトは、クラウド PC 製品の Azure ネットワーク接続 と同じです。

メソッド

メソッド	戻り値の種類	説明
List onPremisesConnections	cloudPcOnPremisesConnection コレクション	cloudPcOnPremisesConnection オブジェクトのプロパティとリレーションシップを一覧表示します。
cloudPcOnPremisesConnection を取得する	cloudPcOnPremisesConnection	cloudPcOnPremisesConnection オブジェクトのプロパティとリレーションシップを読み取ります。
cloudPcOnPremisesConnection を作成する	cloudPcOnPremisesConnection	新しい cloudPcOnPremisesConnection オブジェクトを作成します。
cloudPcOnPremisesConnection を更新する	cloudPcOnPremisesConnection	cloudPcOnPremisesConnection オブジェクトのプロパティを更新します。
cloudPcOnPremisesConnection を削除する	なし	cloudPcOnPremisesConnection オブジェクトを削除します。使用中の接続を削除することはできません。
cloudPcOnPremisesConnection の RunHealthChecks	なし	cloudPcOnPremisesConnection で正常性チェックを実行します。

プロパティ

プロパティ	型	説明
adDomainName	String	参加する Active Directory ドメインの完全修飾ドメイン名 (FQDN)。最大長は 255 です。省略可能です。
adDomainPassword	String	Active Directory アカウントのユーザー名 (adDomainUsername) に関連付けられているパスワード。
adDomainUsername	String	Active Directory でコンピューターオブジェクトを作成するアクセス許可を持つ Active Directory アカウント (ユーザーまたはサービスアカウント) のユーザー名。必須の形式: `admin@contoso.com`。オプション。
alternateResourceUrl	String	この Azure ネットワーク接続にリンクするパートナーサービスのリソースのインターフェイス URL。でのみ返されます。`$select`
connectionType	cloudPcOnPremisesConnectionType	プロビジョニングされたクラウド PC がMicrosoft Entraに参加する方法を指定します。これにはさまざまな種類が含まれます。1 つはMicrosoft Entra ID参加です。つまり、現在のテナントにオンプレミスの Active Directory (AD) はなく、クラウド PC デバイスはMicrosoft Entraによって参加されます。もう 1 つは hybridAzureADJoin です。つまり、現在のテナントにはオンプレミスの Active Directory (AD) もあり、クラウド PC デバイスはオンプレミスの Active Directory (AD) とMicrosoft Entraに参加します。この型は、割り当て可能なユーザーの種類と、クラウド PC にサインインできるユーザーの種類も決定します。 azureADJoin 型は、クラウド専用ユーザーとハイブリッドユーザーをクラウド PC に割り当ててサインインできることを示します。hybridAzureADJoin は、ハイブリッドユーザーのみがクラウド PC に割り当てられ、サインインできることを示します。既定値は `hybridAzureADJoin` です。
displayName	String	Azure ネットワーク接続の表示名。
healthCheckStatus	cloudPcOnPremisesConnectionStatus	オンプレミス接続で実行された最新の正常性チェックの状態。たとえば、状態がの場合、 `passed`オンプレミス接続は、サービスによって実行されるすべてのチェックに合格しました。使用可能な値: `pending`、、`running`、`passed`、`failed`、`warning`。 `informational` 既定値は `pending` です。読み取り専用。
healthCheckStatusDetail	cloudPcOnPremisesConnectionStatusDetail	オンプレミス接続で実行された正常性チェックの結果を示します。読み取り専用です。でのみ返されます。`$select` inUse プロパティを取得する方法を示す例については、「例 2: healthCheckStatusDetail など、Azure ネットワーク接続の選択したプロパティを取得する」を参照してください。読み取り専用です。
id	String	Azure ネットワーク接続の一意識別子。読み取り専用です。
inUse	ブール型	の場合 `true`、Azure ネットワーク接続が使用中です。の場合 `false`、接続は使用されていません。使用中の接続を削除することはできません。でのみ返されます。`$select` inUse プロパティを取得する方法を示す例については、「例 2: healthCheckStatusDetail など、Azure ネットワーク接続の選択したプロパティを取得する」を参照してください。読み取り専用。
organizationalUnit	String	コンピューターアカウントが作成される組織単位 (OU)。 null のままにすると、テナントの Active Directory ドメイン (OU) の既定 (既知のコンピューターオブジェクトコンテナー) として構成された OU が使用されます。省略可能です。
resourceGroupId	String	クラウド PC のオンプレミスネットワーク接続に関連付けられている、使用されるターゲットリソースグループの一意識別子。必須の形式: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}"
subnetId	String	クラウド PC のオンプレミスネットワーク接続に関連付けられているターゲットサブネットの一意識別子。必須の形式: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}"
subscriptionId	String	テナントに関連付けられている Azure サブスクリプションの一意識別子。
subscriptionName	String	Azure サブスクリプションの名前は、Azure ネットワーク接続の作成に使用されます。読み取り専用です。
virtualNetworkId	String	クラウド PC のオンプレミスネットワーク接続に関連付けられている、使用されるターゲット仮想ネットワークの一意識別子。必須の形式: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}"
virtualNetworkLocation	String	ターゲット仮想ネットワークのリソースの場所を示します。たとえば、場所は eastus2、westeurope などです。読み取り専用 (計算値)。

cloudPcOnPremisesConnectionType 値

メンバー	説明
azureADJoin	クラウド PC デバイスがMicrosoft Entra IDにのみ参加していることを示します。
hybridAzureADJoin	クラウド PC デバイスがオンプレミスの Active Directoryに参加し、Microsoft Entra IDに登録されていることを示します。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。

cloudPcOnPremisesConnectionStatus 値

メンバー	説明
失敗しました	Cloud PC Azure ネットワーク接続の正常性チェックが完了し、エラーが発生したことを示します。お客様の環境が正しく構成されていないため、クラウド PC のプロビジョニングに失敗します。お客様は、問題を特定し、オンプレミス接続によって提供されるガイダンスを使用して問題を解決して、プロビジョニングを正常に行う必要があります。
情報	Cloud PC Azure ネットワーク接続の正常性チェックが完了し、正常性チェック情報が表示されたことを示します。正常性チェックは、シングルサインオンなどのクラウド PC アドオン機能の現在または関連する前提条件チェックの状態に関する情報を顧客に提供します。お客様のクラウド PC のプロビジョニングには影響しませんが、ユーザーエクスペリエンスを最適化する予定です。
渡された	Cloud PC Azure ネットワーク接続の正常性チェックが完了し、合格したことを示します。お客様は、問題なくクラウド PC をプロビジョニングできます。
保留中	既定値。 Cloud PC Azure ネットワーク接続の正常性チェックが開始され、完了を待機中であることを示します。
実行	Cloud PC Azure ネットワーク接続の正常性チェックがまだ実行されていることを示します。
unknownFutureValue	進化可能な列挙センチネル値。使用しないでください。
warning	Cloud PC Azure ネットワーク接続の正常性チェックが完了し、エラーが発生したことを示します。お客様の環境が適切に構成されていないため、クラウド PC のプロビジョニングに失敗します。お客様は、問題を特定し、オンプレミス接続によって提供されるガイダンスを使用して問題を解決して、プロビジョニングを正常に行う必要があります。

リレーションシップ

なし。

JSON 表記

リソースの種類の例を次に示します。

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "adDomainName": "String",
  "adDomainPassword": "String",
  "adDomainUsername": "String",
  "alternateResourceUrl": "String",
  "displayName": "String",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": {
    "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail",
    "endDateTime": "String (timestamp)",
    "healthChecks": [
      { 
        "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionHealthCheck",
        "additionalDetail": "String",
        "displayName": "String",
        "endDateTime": "String (timestamp)",
        "errorType": "String",
        "recommendedAction": "String",
        "correlationId": "String",
        "startDateTime": "String (timestamp)",
        "status": "String"
      }
    ],
    "startDateTime": "String (timestamp)"
  },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "subnetId": "String",
  "subscriptionId": "String",
  "subscriptionName": "String",
  "connnecetionType": "String",
  "virtualNetworkId": "String"
}