cloudPcOnPremisesConnection リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

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

重要

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

メソッド

メソッド	戻り値の種類	説明
List	cloudPcOnPremisesConnection コレクション	cloudPcOnPremisesConnection オブジェクトのプロパティとリレーションシップを一覧表示します。
Get	cloudPcOnPremisesConnection	cloudPcOnPremisesConnection オブジェクトのプロパティとリレーションシップを読み取ります。
Create	cloudPcOnPremisesConnection	新しい cloudPcOnPremisesConnection オブジェクトを 作成します。
Update	cloudPcOnPremisesConnection	cloudPcOnPremisesConnection オブジェクトのプロパティを更新します。
Delete	なし	cloudPcOnPremisesConnection オブジェクトを削除します。 使用中の接続を削除することはできません。
正常性チェックを実行する	なし	cloudPcOnPremisesConnection で正常性チェックを実行します。
Active Directory ドメイン パスワードを更新する	なし	成功した cloudPcOnPremisesConnection の Active Directory ドメイン パスワードを更新します。 この API は、 cloudPcOnPremisesConnection オブジェクトの型が である hybridAzureADJoin場合にサポートされます。

プロパティ

プロパティ	型	説明
adDomainName	String	参加する Active Directory ドメインの完全修飾ドメイン名 (FQDN)。 省略可能。
adDomainPassword	String	adDomainUsername に関連付けられているパスワード。
adDomainUsername	String	Active Directory でコンピューター オブジェクトを作成するためのアクセス許可を持つ Active Directory アカウント (ユーザーまたはサービス アカウント) のユーザー名。 必須の形式: admin@contoso.com。 省略可能。
alternateResourceUrl	String	この Azure ネットワーク接続にリンクするパートナー サービスのリソースのインターフェイス URL。 でのみ返されます。$select
connectionType	cloudPcOnPremisesConnectionType	プロビジョニングされたクラウド PC をMicrosoft Entraに参加させる方法を指定します。 オプションはazureADJoin、現在のテナントにオンプレミスの Active Directory (AD) が存在しないことを示します。その結果、クラウド PC デバイスはMicrosoft Entraにのみ参加します。 オプションはhybridAzureADJoin、現在のテナントにオンプレミス AD が存在し、クラウド PC がオンプレミス AD とMicrosoft Entraの両方に参加していることを示します。 選択したオプションは、割り当て可能なユーザーの種類と、クラウド PC にサインインできるユーザーの種類も決定します。 オプション azureADJoin を使用すると、クラウド専用ユーザーとハイブリッド ユーザーの両方を割り当ててサインインできますが、 hybridAzureADJoin ハイブリッド ユーザーのみに制限されます。 既定値は hybridAzureADJoin です。 使用可能な値: hybridAzureADJoin、azureADJoin、unknownFutureValue。
displayName	String	Azure ネットワーク接続の表示名。
healthCheckStatus	cloudPcOnPremisesConnectionStatus	Azure ネットワーク接続で実行チェック最新の正常性の状態。 たとえば、状態が の場合、Azure ネットワーク接続は passed、サービスによって実行されるすべてのチェックに合格しました。 可能な値は、pending、running、passed、failed、warning、informational、unknownFutureValue です。 読み取り専用です。
healthCheckStatusDetails	cloudPcOnPremisesConnectionStatusDetails	接続の正常性チェックの詳細と、対応する結果。 でのみ返されます。$select inUse プロパティを取得する方法を示す例については、「例 2: healthCheckStatusDetails など、Azure ネットワーク接続の選択したプロパティを取得する」を参照してください。 読み取り専用です。
healthCheckStatusDetails (非推奨)	cloudPcOnPremisesConnectionStatusDetails	接続の正常性チェックとそれぞれの結果を示します。 でのみ返されます。$select inUse プロパティを取得する方法を示す例については、「例 2: healthCheckStatusDetails など、Azure ネットワーク接続の選択したプロパティを取得する」を参照してください。 読み取り専用です。 healthCheckStatusDetails プロパティは非推奨となり、2024 年 1 月 31 日にデータの返しを停止しました。 今後は、 healthCheckStatusDetail プロパティを 使用します。
healthCheckStatusDetail	cloudPcOnPremisesConnectionStatusDetail	オンプレミス接続で実行された正常性チェックの結果を示します。 でのみ返されます。$select inUse プロパティを取得する方法を示す例については、「例 2: healthCheckStatusDetails など、Azure ネットワーク接続の選択したプロパティを取得する」を参照してください。 読み取り専用です。
id	String	Azure ネットワーク接続の一意識別子。 読み取り専用です。
inUse	ブール型	の場合 true、Azure ネットワーク接続が使用中です。 の場合 false、接続は使用されていません。 使用中の接続を削除することはできません。 でのみ返されます。$select inUse プロパティを取得する方法を示す例については、「例 2: healthCheckStatusDetails など、Azure ネットワーク接続の選択したプロパティを取得する」を参照してください。 読み取り専用です。
inUseByCloudPc	ブール型	クラウド PC がこのオンプレミス ネットワーク接続を使用しているかどうかを示します。 true 少なくとも 1 つのクラウド PC がそれを使用している場合。 それ以外の場合は 。 false 読み取り専用です。 既定値は false です。
healthCheckPaused	ブール型	false ネットワーク/ドメイン構成の通常の正常性チェックが現在アクティブな場合。 true チェックが一時停止されている場合。 onPremisesNetworkConnection リソースに対して作成または更新操作を実行する場合、この値は 4 週間にfalse設定されます。 ネットワーク/ドメイン構成で正常性チェックを再試行する場合、この値は 2 週間にfalse設定されます。 onPremisesNetworkConnection リソースが provisioningPolicy にアタッチされているか、過去 4 週間にクラウド PC によって使用されている場合は、 healthCheckPaused が にfalse設定されます。 読み取り専用です。 既定値は false です。
managedBy	cloudPcManagementService	Azure ネットワーク接続を管理するサービスを指定します。 使用可能な値: windows365、devBox、unknownFutureValue、rpaBox。 要求ヘッダーを使用して、Prefer: include-unknown-enum-membersこの進化可能な列挙型で次の値を取得する必要があります。 rpaBox 読み取り専用です。
organizationalUnit	String	コンピューター アカウントが作成される組織単位 (OU)。 null のままにすると、Active Directory ドメイン (OU) の既定 (既知のコンピューター オブジェクト コンテナー) として構成された OU が使用されます。 省略可能。
organizationalUnit	String	コンピューター アカウントが作成される組織単位 (OU)。 null のままにすると、Active Directory ドメイン (OU) の既定 (既知のコンピューター オブジェクト コンテナー) として構成された OU が使用されます。 省略可能。
virtualNetworkId	String	ターゲット仮想ネットワークの ID。 必須の形式: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}。
virtualNetworkLocation	String	仮想ターゲット ネットワークのリソースの場所を示します。 読み取り専用の計算値。
resourceGroupId	String	ターゲット リソース グループの ID。 必須の形式: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}。
subnetId	String	ターゲット サブネットの ID。 必須の形式: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}。
subscriptionId	String	テナントに関連付けられているターゲット Azure サブスクリプションの ID。
subscriptionName	String	ターゲット Azure サブスクリプションの名前。 読み取り専用です。
type (非推奨)	cloudPcOnPremisesConnectionType	プロビジョニングされたクラウド PC をMicrosoft Entraに参加させる方法を指定します。 オプションはazureADJoin、現在のテナントにオンプレミスの Active Directory (AD) が存在しないことを示します。その結果、クラウド PC デバイスはMicrosoft Entraにのみ参加します。 オプションはhybridAzureADJoin、現在のテナントにオンプレミス AD が存在し、クラウド PC がオンプレミス AD とMicrosoft Entraの両方に参加していることを示します。 選択したオプションは、割り当て可能なユーザーの種類と、クラウド PC にサインインできるユーザーの種類も決定します。 オプション azureADJoin を使用すると、クラウド専用ユーザーとハイブリッド ユーザーの両方を割り当ててサインインできますが、 hybridAzureADJoin ハイブリッド ユーザーのみに制限されます。 既定値は hybridAzureADJoin です。 使用可能な値: hybridAzureADJoin、azureADJoin、unknownFutureValue。 type プロパティは非推奨であり、2024 年 1 月 31 日にデータの返しを停止しました。 今後は、 connectionType プロパティを使用します。

cloudPcManagementService 値

メンバー	説明
devBox	Project Fidalgo を介して Azure ネットワーク接続が正常に作成されました。
rpaBox	Azure ネットワーク接続は、Power Automate プロジェクトを通じて正常に作成されました。
unknownFutureValue	進化可能な列挙センチネル値。 使用しないでください。
windows365	Windows 365を介して Azure ネットワーク接続が正常に作成されました。

cloudPcOnPremisesConnectionType 値

メンバー	説明
azureADJoin	Microsoft Entra IDにのみ結合されます。 クラウド専用ユーザーとハイブリッド ユーザーを割り当てて、クラウド PC にサインインできます。
hybridAzureADJoin	オンプレミスの Active DirectoryとMicrosoft Entra IDに参加しました。 ハイブリッド ユーザーのみが割り当てられ、クラウド PC にサインインできます。
unknownFutureValue	進化可能な列挙センチネル値。 使用しないでください。

cloudPcOnPremisesConnectionStatus 値

メンバー	説明
失敗 しました	正常性チェックは、Azure ネットワーク接続が適切に構成されていないか、機能していないことを顧客に通知します。 プロビジョニングが失敗します。 お客様は、問題を特定し、プロビジョニングを成功させるために Azure ネットワーク接続によって提供されるガイダンスを使用して解決する必要があります。
情報	正常性チェックは、シングル サインオンなどのクラウド PC アドオン機能に関する現在または関連する前提条件チェックに関する情報を顧客に提供します。 情報正常性チェックは、顧客のクラウド PC のプロビジョニングには影響しません。 この情報は、ユーザー エクスペリエンスを最適化することを目的としています。
渡さ れた	正常性チェックは、Azure ネットワーク接続が意図したとおりに動作していることを顧客に通知します。 お客様は、問題なくクラウド PC をプロビジョニングできます。
ペンディング	正常性チェックを作成して待機しています。
ランニング	正常性チェックが実行されています。
unknownFutureValue	進化可能な列挙センチネル値。 使用しないでください。
warning	正常性チェックは、エンドポイント接続など、Microsoft のベスト プラクティス ガイダンスに従って Azure ネットワーク接続が構成されていないことをお客様に通知します。 お客様は、クラウド PC をプロビジョニングする前に、クラウド PC に必要なエンドポイントを構成する必要があります。 お客様のクラウド PC のプロビジョニングには影響しませんが、お客様のエクスペリエンスに影響を与える可能性があります。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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