Upgrade Assistant のテレメトリ

アップグレード アシスタントには、使用状況データを収集するテレメトリ機能が含まれています。 テレメトリ データは、ツールを改善する方法を理解するのに役立ちます。

Important

.NET アップグレード アシスタントは正式に非推奨です。 代わりに GitHub Copilot モダン化チャット エージェント を使用します。これは Visual Studio 2026 および Visual Studio 2022 17.14.16 以降に含まれています。 このエージェントは、プロジェクトと依存関係を分析し、ターゲットの推奨事項と自動コード修正を使用して段階的な移行計画を作成し、各変更をコミットして検証またはロールバックできるようにします。 プロジェクト ファイルの更新、非推奨の API の置き換え、ビルドの問題の解決など、一般的な移植タスクが自動化されるため、手動作業を減らすことで、より迅速に最新化できます。

オプトアウトする方法

アップグレード アシスタントのテレメトリ機能は、既定で有効になっています。 テレメトリ機能をオプトアウトするには、 DOTNET_UPGRADEASSISTANT_TELEMETRY_OPTOUT 環境変数を 1 または trueに設定します。

永続化された環境変数を作成して割り当て、値を指定します。

:: Assigns the env var to the value
setx DOTNET_UPGRADEASSISTANT_TELEMETRY_OPTOUT="1"

コマンド プロンプトの新しいインスタンスで、環境変数を読み取ります。

:: Prints the env var value
echo %DOTNET_UPGRADEASSISTANT_TELEMETRY_OPTOUT%

開示

最初にツールを実行すると、アップグレード アシスタントに次のようなテキストが表示されます。 テキストは、実行しているツールのバージョンによって若干異なる場合があります。 この "最初の実行" エクスペリエンスは、Microsoft がデータ収集について通知する方法です。

Telemetry

Upgrade Assistant collects usage data in order to help us improve your experience. The data is collected by Microsoft and shared with the community. You can opt-out of telemetry by setting the DOTNET_UPGRADEASSISTANT_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell.

"最初の実行" エクスペリエンス テキストを非表示にするには、 DOTNET_UPGRADEASSISTANT_SKIP_FIRST_TIME_EXPERIENCE 環境変数を 1 または trueに設定します。

データ ポイント

テレメトリ機能では、次の機能は行われません。

  • コードのサンプルを収集する

データは Microsoft サーバーに安全に送信され、制限付きアクセスで保持されます。

お客様のプライバシーの保護は、当社にとって重要です。 テレメトリ機能が機密データを収集していると思われる場合、またはデータが安全でないか不適切に処理されていると思われる場合は、次のいずれかのアクションを実行します。

テレメトリ機能は、次のデータを収集します。

アシスタントのバージョンをアップグレードする データ
>=0.2.231802 呼び出しのタイムスタンプ。
>=0.2.231802 地理的な場所を決定するために使用される 3 オクテット IP アドレス。
>=0.2.231802 オペレーティング システムとバージョン。
>=0.2.231802 ツールが実行されているランタイム ID (RID)。
>=0.2.231802 ツールがコンテナーで実行されているかどうか。
>=0.2.231802 ハッシュされたメディア アクセス制御 (MAC) アドレス: 暗号化されたハッシュ (SHA256) によるマシンの一意のID。
>=0.2.231802 カーネル バージョン。
>=0.2.231802 アシスタントのバージョンをアップグレードします。
>=0.2.231802 呼び出されたコマンドと引数の名前。 実際の引数の値は収集されません。
>=0.2.231802 MSBuild のバージョンが使用されています。
>=0.2.231802 ハッシュされたソリューション ID (または ID が使用できない場合はハッシュパス)。
>=0.2.231802 各プロジェクトのハッシュされたプロジェクト ID (または ID がない場合はハッシュ パス)。
>=0.2.231802 各エントリ ポイントのハッシュされたプロジェクト ID (または ID がない場合はハッシュパス)。
>=0.2.231802 各ステップについて、ステップを初期化して適用する時間。
>=0.2.231802 各ステップについて、選択された決定 (たとえば、 apply)。

その他のリソース

  • Last updated on