Visual Studio を使用して、Azure Cloud Services (クラシック) でロールのリモートデスクトップ接続を有効にする

[アーティクル]
06/15/2023

重要

現在、Cloud Services (クラシック) は新しいお客様に対して非推奨となっており、2024 年 8 月 31 日に、すべてのお客様に対して廃止される予定です。新しいデプロイでは、新しい Azure Resource Manager ベースのデプロイモデル、 Azure Cloud Services (延長サポート) を使用してください。

リモートデスクトップを使用して、Azure で実行されているロールのデスクトップにアクセスできます。リモートデスクトップ接続を使用すると、アプリケーションの実行中にそのアプリケーションの問題のトラブルシューティングや診断を行うことができます。

Visual Studio によってクラウドサービス向けに提供される発行ウィザードでは、発行プロセス中にユーザーが入力した資格情報を利用してリモートデスクトップを有効にできるオプションが含まれています。このオプションは、Visual Studio 2017 バージョン 15.4 以前を使用するときに適しています。

しかしながら、Visual Studio 2017 バージョン 15.5 以降の場合、単独開発者としてのみ作業しているのでなければ、発行ウィザードを使ってリモートデスクトップを有効にする行為は避けることをお勧めします。他の開発者がプロジェクトを開くような状況がある場合、代わりに、Azure Portal、PowerShell、または継続的配置ワークフローのリリースパイプラインからリモートデスクトップを有効にします。このような推奨は、クラウドサービス VM における Visual Studio とリモートデスクトップの通信方法が変わったことによる影響です。これについてはこの記事で説明します。

Visual Studio 2017 バージョン 15.4 以前でリモートデスクトップを構成する

Visual Studio 2017 バージョン 15.4 以前を使用しているとき、発行ウィザードの [すべてのロールに対してリモートデスクトップを有効にする] オプションを使用できます。このウィザードは Visual Studio 2017 バージョン 15.5 以降で引き続き使用できますが、リモートデスクトップオプションは使用しないでください。

Visual Studio のソリューションエクスプローラーでクラウドサービスプロジェクトを右クリックし、[発行] を選択し、発行ウィザードを開始します。
必要に応じて Azure サブスクリプションにサインインし、[次へ] を選択します。
[設定] ページで [すべてのロールに対してリモートデスクトップを有効にする] を選択し、[設定] リンクを設定して [リモートデスクトップ構成] ダイアログボックスを開きます。
ダイアログボックスの一番下にある [その他のオプション] を選択します。これで証明書を作成または選択できるドロップダウンリストが表示されます。リモートデスクトップを使用して接続するときに資格情報を暗号化できます。

Note

リモートデスクトップ接続に必要な証明書は、他の Azure 操作で使用する証明書とは異なります。リモートアクセス証明書には、秘密キーが必要です。
一覧から証明書を選択するか、 <[作成]> を選択します。新しい証明書を作成する場合、入力を求められたら新しい証明書にわかりやすい名前を付け、[OK] を選択します。ドロップダウンリストボックスに新しい証明書が表示されます。
ユーザー名とパスワードを入力します。既存のアカウントを使用することはできません。新しいアカウントのユーザー名として "Administrator" を使用しないでください。
アカウントが期限切れになり、以後リモートデスクトップ接続がブロックされる日付を選択します。
必要な情報をすべて入力したら、[OK] を選択します。 Visual Studio により、リモートデスクトップ設定がプロジェクトの .cscfg ファイルと .csdef ファイルに追加されます。選択した証明書を使用して暗号化されるパスワードが含まれています。
[次へ] ボタンを使用して残りの手順を完了し、クラウドサービスを発行する準備ができたら、[発行] を選択します。発行する準備ができていない場合、[キャンセル] を選択し、変更内容の保存を求められたら [はい] で回答します。後で、保存した設定でクラウドサービスを発行できます。

Visual Studio 2017 バージョン 15.5 以降でリモートデスクトップを構成する

Visual Studio 2017 バージョン 15.5 以降でも引き続き、クラウドサービスプロジェクトで発行ウィザードを使用できます。単独開発者としてのみ作業している場合、[すべてのロールに対してリモートデスクトップを有効にする] オプションも使用できます。

チームの一員として作業している場合、代わりに、Azure Portal か PowerShell を使用し、Azure クラウドサービスでリモートデスクトップを有効にしてください。

この推奨は、Visual Studio 2017 バージョン 15.5 以降とクラウドサービス VM の通信方法が変わったことに起因します。発行ウィザードを使用してリモートデスクトップを有効にすると、以前のバージョンの Visual Studio は、"RDP プラグイン" と呼ばれるものによって VM と通信する必要があります。Visual Studio 2017 バージョン 15.5 以降は、より安全で柔軟性の高い "RDP 拡張機能" を使用して通信します。これは、Azure Portal と PowerShell でリモートデスクトップを有効にする場合にも RDP 拡張が使用されることに伴う変更です。

Visual Studio と RDP 拡張が通信するとき、TLS を介してプレーンテキストパスワードが送信されます。ただし、プロジェクトの構成ファイルは暗号化されたパスワードのみを格納します。元々暗号化に使用されたローカル証明書でのみ、プレーンテキストに復号できます。

毎回同じ開発コンピューターからクラウドサービスプロジェクトを配置する場合、ローカル証明書が利用できます。この場合も、発行ウィザードの [すべてのロールに対してリモートデスクトップを有効にする] オプションを使用できます。

しかし、ご自分や他の開発者が別のコンピューターからクラウドサービスプロジェクトを配置する場合、その別のコンピューターにはパスワードを復号するために必要な証明書が入っていないことになります。結果として、次のエラーメッセージが表示されます。

Applying remote desktop protocol (RDP) extension.
Certificate with thumbprint [thumbprint] doesn't exist.

クラウドサービスを配置するたびにパスワードを変更することもできますが、それではリモートデスクトップの利用者にとって不便です。

チーム内でプロジェクトを共有している場合、発行ウィザードでオプションを解除し、代わりに Azure Portal または PowerShell から直接、リモートデスクトップを有効にすることをお勧めします。

Visual Studio 2017 バージョン 15.5 以降でビルドサーバーから配置する

Visual Studio 2017 バージョン 15.5 以降がビルドエージェントにインストールされているビルドサーバー (たとえば、Azure DevOps Services で) からクラウドサービスプロジェクトを配置できます。このように手配すると、暗号化証明書が利用できる同じコンピューターから配置されます。

Azure DevOps Services の RDP 拡張を使用するには、ビルドパイプラインに次の詳細を含めます。

RDP プラグインではなく RDP 拡張と配置が連動するように、MSBuild 引数に /p:ForceRDPExtensionOverPlugin=true を追加します。次に例を示します。
```
msbuild AzureCloudService5.ccproj /t:Publish /p:TargetProfile=Cloud /p:DebugType=None
    /p:SkipInvalidConfigurations=true /p:ForceRDPExtensionOverPlugin=true
```
ビルド手順の後で、「Azure Cloud Service の配置」手順を追加し、そのプロパティを設定します。
配置手順の後、「Azure PowerShell」手順を追加し、その [表示名] プロパティを "Azure の配置: RDP 拡張機能を有効にする" (または別の適切な名前) に設定して、適切な Azure サブスクリプションを選びます。

[スクリプトの種類] を "インライン" に設定し、下のコードを [インラインスクリプト] フィールドに貼り付けます。 (このスクリプトでプロジェクトに .ps1 ファイルを作成し、[スクリプトの種類] を "スクリプトファイルパス" に設定し、ファイルを指すように [スクリプトパス] を設定することもできます。)

Param(
    [Parameter(Mandatory=$True)]
    [string]$username,

    [Parameter(Mandatory=$True)]
    [string]$password,

    [Parameter(Mandatory=$True)]
    [string]$serviceName,

    [Datetime]$expiry = ($(Get-Date).AddYears(1))
)

Write-Host "Service Name: $serviceName"
Write-Host "User Name: $username"
Write-Host "Expiry: $expiry"

$securepassword = ConvertTo-SecureString -String $password -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential $username,$securepassword

# Try to remote existing RDP Extensions
try
{
    $existingRDPExtension = Get-AzureServiceRemoteDesktopExtension -ServiceName $servicename
    if ($existingRDPExtension -ne $null)
    {
        Remove-AzureServiceRemoteDesktopExtension -ServiceName $servicename -UninstallConfiguration
    }
}
catch
{
}

Set-AzureServiceRemoteDesktopExtension -ServiceName $servicename -Credential $credential -Expiration $expiry -Verbose

リモートデスクトップを使用して Azure ロールに接続する

Azure でクラウドサービスを発行し、リモートデスクトップを有効にしたら、Visual Studio サーバーエクスプローラーを使用し、クラウドサービス VM にログインできます。

サーバーエクスプローラーで、 [Azure] ノードを展開し、いずれかのクラウドサービスのノードとそのロールを 1 つ展開して、インスタンスの一覧を表示します。
インスタンスノードを右クリックし、[Connect Using Remote Desktop](リモートデスクトップを使用して接続) を選択します。
以前作成したユーザー名とパスワードを入力します。これでリモートセッションにログインした状態になります。

その他のリソース

Cloud Services の構成方法

Visual Studio を使用して、Azure Cloud Services (クラシック) でロールのリモート デスクトップ接続を有効にする

Visual Studio 2017 バージョン 15.4 以前でリモート デスクトップを構成する

Visual Studio 2017 バージョン 15.5 以降でリモート デスクトップを構成する

Visual Studio 2017 バージョン 15.5 以降でビルド サーバーから配置する

リモート デスクトップを使用して Azure ロールに接続する

その他のリソース

その他のリソース

Visual Studio を使用して、Azure Cloud Services (クラシック) でロールのリモートデスクトップ接続を有効にする

Visual Studio 2017 バージョン 15.4 以前でリモートデスクトップを構成する

Visual Studio 2017 バージョン 15.5 以降でリモートデスクトップを構成する

Visual Studio 2017 バージョン 15.5 以降でビルドサーバーから配置する

リモートデスクトップを使用して Azure ロールに接続する