レイアウトからクライアント コンピューターに Visual Studio を展開する

  • [アーティクル]

レイアウトをクライアント コンピューターに展開するには、まず次のトピックを考慮する必要があります。

レイアウトからクライアント コンピューターに Visual Studio をインストールする

管理者は、インストール スクリプトの一部としてプログラムで、Visual Studio のレイアウトをクライアント ワークステーションに展開できます。

ネットワーク レイアウトからインストールする

管理者アクセス許可を持つユーザーは、次のコマンドを実行して、無人モードでネットワーク レイアウトから Visual Studio をインストールできます。 レイアウトの response.json では、インストールの既定の構成設定を指定します。

\\server\products\VS\vs_enterprise.exe --quiet --wait

ユーザーがレイアウトで使用 ''できない'' 項目を選択した場合、インストーラーにより、インターネット上の Microsoft でホストされているサーバーからのこれらの追加ファイルの供給が ''試み'' られます。 インストーラーが製品のインストール時にインターネットにアクセスしないようにするには、--noweb スイッチを使用します。 たとえば、このコマンドを使用してインストールを実行し、クライアント コンピューターからインターネットにアクセスできないようにします。

\\server\products\VS\vs_enterprise.exe --noWeb --wait --passive --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --includeOptional

Note

しばらくお待ちください。 インストーラーと製品の両方が完了していることを確認し--waitます。 レイアウトからクライアントをインストールまたは更新する場合、インストーラーは常に最初にインストールまたは更新されます。その後、Visual Studio 製品自体がインストールまたは更新されます。 これらのプロセスはいずれも、正常な更新と見なされるために完了する必要があります。

無人自動バッチファイルの一部としてインストールまたは更新を実行する場合、--waitオプションを選択すると、 インストールが完了するまでプロセスvs_enterprise.exeが待機し、終了コードが返されます。 これは、企業の管理者が完了したインストールでさらにアクションを実行するときに役立ちます (たとえば、インストールの完了後、製品キーを適用する等)。 --wait オプションを使用すると、後続の操作が途中で開始されるのを防ぐことができます。 --wait を使用しない場合、インストールの両方の部分が完了する前に vs_enterprise.exe プロセスが終了し、インストール操作の状態を表していない不正確な終了コードが返されます。

内部イントラネット上の場所からインストールする

一部の企業は、地理的なパフォーマンスのボトルネックをより適切に管理し、Web キャッシュを利用するために、イントラネット上の場所でレイアウトをホストしたいと考えています。 イントラネットでホストされるレイアウトをクライアント コンピューターに展開するには、管理者アクセス許可を持つユーザーが、次のような管理者特権の PowerShell スクリプトを実行して、クライアント コンピューターへのインストールを初期化する必要があります。

    #Do the initial installation from the web hosted layout onto the client in an elevated PowerShell script

    #ADMIN CONFIGURATION
    #Enter layout URI here
    $LayoutUri = "http://MyCompanyIntranetSite/VS2022Enterprise/"

    #Enter bootstrapper name which is present in layout.
    $BootstrapperName = "vs_Enterprise.exe"

    #Add any arguments which you intend to send to bootstrapper.
    $Arguments = "--passive --wait"

    #SCRIPT FUNCTIONALITY
    #Forming URI for bootstrapper
    Write-Verbose "LayoutUri: $LayoutUri"
    $BootstrapperUri = "$LayoutUri/$BootstrapperName"
    Write-Verbose "BootstrapperUri: $BootstrapperUri"

    $Arguments += " --layoutUri $LayoutUri"
    Write-Verbose "Arguments: $Arguments"

    #Creating temp folder and download bootstrapper
    $VSLayoutFolderPath = Join-Path -Path $env:TEMP -ChildPath VSLayout
    $BootstrapperFile = Join-Path -Path $VSLayoutFolderPath -ChildPath $BootstrapperName
    Write-Verbose "The bootstrapper path is: $BootstrapperFile"

    if (Test-Path $VSLayoutFolderPath)
    {
    Write-Verbose "The directory exists - $VSLayoutFolderPath"
    if (Test-Path $BootstrapperFile)
    {
    Write-Verbose "Deleting file - $BootstrapperFile"
    Remove-Item $BootstrapperFile
    }
    }
    else
    {
    Write-Verbose "Creating folder - $VSLayoutFolderPath"
    New-Item -ItemType Directory -Path $VSLayoutFolderPath
    }

    Write-Verbose "Downloading bootstrapper from - $BootstrapperUri to $BootstrapperFile"
    Invoke-WebRequest -Uri $BootstrapperUri -OutFile $BootstrapperFile
    
    Write-Verbose "Starting bootstrapper -$BootstrapperFile with arguments $Arguments"
    start-process $BootstrapperFile $Arguments

クライアント コンピューターを準備する

アクセス許可

インストールを実行しているユーザーまたはシステム アカウントが、レイアウトを含むネットワーク共有に適切にアクセスできることを確認します。 詳細については、「Visual Studio をインストールまたは使用するときのネットワーク関連のエラーのトラブルシューティング」ページを参照してください。

インターネットにアクセスできないクライアントにインストールする

オフライン クライアント コンピューターに適切な証明書がインストールされていることを確認する必要があります。

レイアウトからインストールすると、クライアント上のインストーラーによって、常にレイアウトの場所で Visual Studio パッケージが検索されます。 ただし、インストーラーによって、レイアウトに含まれて ''いない'' コンポーネントのインストールが試みられると、更新ソースから Visual Studio パッケージの取得が試みられます。多くの場合、管理者がそれ自体を指すように構成します。

Visual Studio インストーラーによる、Web 上の Microsoft でホストされているサーバーからの欠落しているコンテンツのダウンロードの試行を明示的に禁止する場合は、--noWeb パラメーターを使用できます。 --noWeb が使用されていて、インストール対象として選択されているコンピューターがレイアウトにない場合、セットアップは失敗します。 また、--noWeb が使用されていて、レイアウトがファイル ネットワーク共有ではなくイントラネット Web サーバーでホストされている場合、セットアップは失敗します。

多くの場合、--noweb スイッチを使用すると、"次のパラメーターと一致する製品が見つかりません" というエラー メッセージが修正されます。

コンピューター リソース

完全なインストール パスが 80 文字未満であり、コンピューターに十分な記憶域があることを確認します。 Visual Studio の完全なインストールでは、少なくとも 45 から 50 GB のディスク領域が必要です。

エラー コード

--wait パラメーターを使用した場合、操作の結果に応じて、%ERRORLEVEL% 環境変数は次のいずれかの値に設定されます。

値 結果
0 操作は正常に終了しました
740 昇格が必要
1001 Visual Studio インストーラー プロセスが実行中です
1003 Visual Studio が使用中です
1602 操作が取り消されました
1618 別のインストールを実行しています
1641 操作が正常に完了し、再起動が開始されました
3010 操作は正常に完了しましたが、インストールした製品を使用する前に再起動が必要です
5003 ブートストラップによるインストーラーのダウンロードが失敗しました
5004 操作が取り消されました
5005 ブートストラップのコマンドライン解析エラー
5007 操作がブロックされました - コンピューターが要件を満たしていません
8001 Arm マシン チェックの失敗
8002 バックグラウンド ダウンロードの事前チェックの失敗
8003 サポート外の選択可能エラー
8004 ターゲット ディレクトリのエラー
8005 ソース ペイロードの有効性検証失敗
8006 Visual Studio プロセスを実行しています
8010 オペレーティング システムがサポートされていません。 システム要件 を参照してください
-1073720687 接続エラー
-1073741510 Microsoft Visual Studio インストーラーが終了しました (ユーザーか外部プロセスにより)
その他
(例:
-1、1、1603)		 失敗の状態が発生しました。詳細については、ログを参照してください

レイアウトの展開のサポートを受ける

レイアウトをクライアント コンピューターに展開するときに問題が発生した場合は、Microsoft にお知らせください。 Visual Studio インストーラーおよび Visual Studio IDE の両方に表示される [問題の報告] ツールから、製品の問題を Microsoft に報告してください。 自分は IT 管理者であるのに、Visual Studio がインストールされていない場合は、こちらで IT 管理者フィードバックを送信できます。 このツールを使用すると、問題の診断と解決に役立つ VS 収集ツールからログを送信できる場合に便利です。

インストール関連の問題については、インストール チャット (英語のみ) のサポート オプションも用意されています。

他にも利用可能なサポート オプションがあります。 「Visual Studio 開発者コミュニティ」を参照してください。

関連するコンテンツ