cloudPcOnPremisesConnection リソースの種類

名前空間: microsoft.graph

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

重要

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

メソッド

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

プロパティ

プロパティ 型 説明
adDomainName 文字列 参加する Active Directory ドメインの完全修飾ドメイン名 (FQDN)。 最大長は 255 です。 省略可能。
adDomainPassword 文字列 Active Directory アカウントのユーザー名 (adDomainUsername) に関連付けられているパスワード。
adDomainUsername 文字列 Active Directory でコンピューター オブジェクトを作成するアクセス許可を持つ Active Directory アカウント (ユーザーまたはサービス アカウント) のユーザー名。 必須の形式: admin@contoso.com。 省略可能。
alternateResourceUrl 文字列 この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 文字列 Azure ネットワーク接続の表示名。
healthCheckPaused ブール型 ネットワークまたはドメイン構成の定期的な正常性チェックが一時停止されているかアクティブであるかを示します。 false ネットワークまたはドメイン構成の通常の正常性チェックが現在アクティブな場合。 true チェックが一時停止されている場合。 onPremisesNetworkConnection リソースに対して作成または更新操作を実行する場合、この値は 4 週間falseに設定されます。 ネットワークまたはドメイン構成で正常性チェックを再試行する場合、この値は 2 週間falseに設定されます。 onPremisesNetworkConnection リソースが provisioningPolicy にアタッチされているか、過去 4 週間にクラウド PC によって使用された場合、healthCheckPausedは false に設定されます。 読み取り専用です。 既定値は false です。
healthCheckStatus cloudPcOnPremisesConnectionStatus オンプレミス接続で実行された最新の正常性チェックの状態。 たとえば、状態が passedの場合、オンプレミス接続はサービスによって実行されるすべてのチェックに合格します。 使用可能な値: pending、 running、 passed、 failed、 warning、 informational。 既定値は pending です。 読み取り専用です。
healthCheckStatusDetail cloudPcOnPremisesConnectionStatusDetail オンプレミス接続で実行された正常性チェックの結果を示します。 読み取り専用です。 取得するには $select が必要です。 inUse プロパティを取得する方法を示す例については、「例 2: healthCheckStatusDetail など、Azure ネットワーク接続の選択したプロパティを取得する」を参照してください。 読み取り専用です。
id 文字列 Azure ネットワーク接続の一意識別子。 読み取り専用です。
inUse ブール型 trueすると、Azure ネットワーク接続が使用されます。 false場合、接続は使用されていません。 使用中の接続を削除することはできません。 $select でのみ返されます。 inUse プロパティを取得する方法を示す例については、「例 2: healthCheckStatusDetail など、Azure ネットワーク接続の選択したプロパティを取得する」を参照してください。 読み取り専用です。
inUseByCloudPc ブール型 クラウド PC がこのオンプレミス ネットワーク接続を使用しているかどうかを示します。 true 少なくとも 1 つのクラウド PC がそれを使用している場合。 それ以外の場合は、 false。 読み取り専用です。 既定値は false です。
organizationalUnit 文字列 コンピューター アカウントが作成される組織単位 (OU)。 null のままにすると、テナントの Active Directory ドメイン (OU) の既定 (既知のコンピューター オブジェクト コンテナー) として構成された OU が使用されます。 省略可能。
resourceGroupId 文字列 クラウド PC のオンプレミス ネットワーク接続に関連付けられている、使用されるターゲット リソース グループの一意識別子。 必須の形式: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}"
scopeIds String collection 対応するアクセス許可のスコープ ID。 現時点では、Intune スコープ タグ ID です。
subnetId 文字列 クラウド PC のオンプレミス ネットワーク接続に関連付けられているターゲット サブネットの一意識別子。 必須の形式: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkId}/subnets/{subnetName}"
subscriptionId 文字列 テナントに関連付けられているAzure サブスクリプションの一意識別子。
subscriptionName 文字列 Azure サブスクリプションの名前は、Azure ネットワーク接続を作成するために使用されます。 読み取り専用です。
virtualNetworkId 文字列 クラウド PC のオンプレミス ネットワーク接続に関連付けられている、使用されるターゲット仮想ネットワークの一意識別子。 必須の形式: "/subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}"
virtualNetworkLocation 文字列 ターゲット仮想ネットワークのリソースの場所を示します。 たとえば、場所は eastus2、westeurope などです。読み取り専用 (計算値)。

cloudPcOnPremisesConnectionType 値

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

cloudPcOnPremisesConnectionStatus 値

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

リレーションシップ

なし。

JSON 表記

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

{
  "@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
  "adDomainName": "String",
  "adDomainPassword": "String",
  "adDomainUsername": "String",
  "alternateResourceUrl": "String",
  "connectionType": "String",
  "displayName": "String",
  "healthCheckPaused": "Boolean",
  "healthCheckStatus": "String",
  "healthCheckStatusDetail": { "@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetail" },
  "id": "String (identifier)",
  "inUse": "Boolean",
  "inUseByCloudPc": "Boolean",
  "organizationalUnit": "String",
  "resourceGroupId": "String",
  "scopeIds": ["String"],
  "subnetId": "String",
  "subscriptionId": "String",
  "subscriptionName": "String",
  "virtualNetworkId": "String"
}
  • Last updated on