cloudPcOnPremisesConnection リソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
クラウド PC の Azure ネットワーク接続を確立するために使用できる Azure リソース情報の定義済みのコレクションを表します。
重要
オンプレミスネットワーク接続の 名前が Azure ネットワーク接続 に変更されました。 ここで の cloudPcOnPremisesConnection オブジェクトは、Cloud 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 でのみ返されます。 |
| displayName | String | Azure ネットワーク接続の表示名。 |
| healthCheckStatus | cloudPcOnPremisesConnectionStatus | Azure ネットワーク接続で実行された最新の正常性チェックの状態。 たとえば、状態が [] の場合、 passedAzure ネットワーク接続はサービスによって実行されるすべてのチェックに合格しています。 可能な値は、pending、running、passed、failed、unknownFutureValue です。 読み取り専用です。 |
| healthCheckStatusDetails | cloudPcOnPremisesConnectionStatusDetails | 接続の正常性チェックの詳細と、対応する結果。 $select でのみ返されます。 inUse プロパティを取得する方法を示す例については、「例 2: healthCheckStatusDetails を含む Azure ネットワーク接続の選択したプロパティを取得する」を参照してください。 読み取り専用。 |
| id | String | Azure ネットワーク接続の一意識別子。 読み取り専用。 |
| inUse | ブール値 | Azure ネットワーク接続が使用中の場合 true。 接続が使用されていない場合 false。 使用中の接続を削除することはできません。 $select でのみ返されます。 inUse プロパティを取得する方法を示す例については、「例 2: healthCheckStatusDetails を含む Azure ネットワーク接続の選択したプロパティを取得する」を参照してください。 読み取り専用です。 |
| managedBy | cloudPcManagementService | Azure ネットワーク接続を管理するサービスを指定します。 可能な値は、windows365、devBox, unknownFutureValue です。 読み取り専用です。 |
| organizationalUnit | String | コンピューター アカウントが作成される組織単位 (OU)。 null のままにすると、Active Directory ドメイン (OU) の既定の (既知のコンピューター オブジェクト コンテナー) として構成された OU が使用されます。 省略可能。 |
| 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 をAzure Active Directoryに参加させる方法を指定します。 既定値は、hybridAzureADJoin です。 可能な値は azureADJoin、hybridAzureADJoin、unknownFutureValue です。 |
| virtualNetworkId | String | ターゲット仮想ネットワークの ID。 必要な形式: /subscriptions/{subscription-id}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}. |
cloudPcManagementService の値
| メンバー | 値 | 説明 |
|---|---|---|
| windows365 | 1 | Windows365 を介して Azure ネットワーク接続が正常に作成されました。 |
| devBox | 2 | Project Fidalgo を介して Azure ネットワーク接続が正常に作成されました。 |
| unknownFutureValue | 4 | 進化可能な列挙センチネル値。 使用しないでください。 |
cloudPcOnPremisesConnectionType 値
| メンバー | 説明 |
|---|---|
| hybridAzureADJoin | オンプレミスの Active Directoryと Azure AD に参加しました。 クラウド PC に割り当ててサインインできるのは、ハイブリッド ユーザーのみです。 |
| azureADJoin | Azure AD にのみ参加しました。 クラウドのみのユーザーとハイブリッド ユーザーを割り当てて、クラウド PC にサインインできます。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
cloudPcOnPremisesConnectionStatus 値
| メンバー | 説明 |
|---|---|
| 保留 中 | 正常性チェックを作成して待機しています。 |
| 実行 | 正常性チェックが実行されています。 |
| 渡さ れた | 正常性チェックが渡されました。 |
| 失敗 しました | 正常性チェックに失敗しました。 |
| warning | 警告と共に渡された正常性チェック。 |
| unknownFutureValue | 進化可能な列挙センチネル値。 使用しないでください。 |
リレーションシップ
なし。
JSON 表記
リソースの JSON 表記を次に示します。
{
"@odata.type": "#microsoft.graph.cloudPcOnPremisesConnection",
"adDomainName": "String",
"adDomainPassword": "String",
"adDomainUsername": "String",
"alternateResourceUrl": "String",
"displayName": "String",
"healthCheckStatus": "String",
"healthCheckStatusDetails": {
"@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionStatusDetails",
"endDateTime": "String (timestamp)",
"healthChecks": [
{
"@odata.type": "microsoft.graph.cloudPcOnPremisesConnectionHealthCheck",
"additionalDetails": "String",
"displayName": "String",
"endDateTime": "String (timestamp)",
"errorType": "String",
"recommendedAction": "String",
"startDateTime": "String (timestamp)",
"status": "String"
}
],
"startDateTime": "String (timestamp)"
},
"id": "String (identifier)",
"inUse": "Boolean",
"managedBy": "String",
"organizationalUnit": "String",
"resourceGroupId": "String",
"subnetId": "String",
"subscriptionId": "String",
"subscriptionName": "String",
"type": "String",
"virtualNetworkId": "String"
}
フィードバック
フィードバックの送信と表示