cloudPcOnPremisesConnection リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
クラウド 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 で正常性チェックを実行します。 |
| updateAdDomainPassword | なし | 成功した 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 ネットワーク接続の選択したプロパティを取得する」を参照してください。 読み取り専用です。 |
| 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 日にデータの返しを停止しました。 Goind forward では、 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",
"managedBy": "String",
"organizationalUnit": "String",
"resourceGroupId": "String",
"subnetId": "String",
"subscriptionId": "String",
"subscriptionName": "String",
"type": "String",
"virtualNetworkId": "String",
"virtualNetworkLocation": "String"
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示