拡張機能のインストールと管理Install and Manage Extensions

適用先:Windows Admin Center、Windows Admin Center PreviewApplies To: Windows Admin Center, Windows Admin Center Preview

Windows Admin Center は拡張可能なプラットフォームとして構築されています。各接続の種類とツールは、個別にインストール、アンインストール、更新が可能な拡張機能です。Windows Admin Center is built as an extensible platform where each connection type and tool is an extension that you can install, uninstall and update individually. Microsoft や他の開発者から発行された新しい拡張機能を検索し、Windows Admin Center インストール全体を更新することなく、個別にインストールおよび更新できます。You can search for new extensions published by Microsoft and other developers, and install and update them individually without having to update the entire Windows Admin Center installation. また、個別の NuGet フィードまたはファイル共有を構成し、組織内で使用する拡張機能を配布することもできます。You can also configure a separate NuGet feed or file share and distribute extensions to use internally within your organization.

拡張機能のインストールInstalling an extension

Windows Admin Center には、指定された NuGet フィードから使用できる拡張機能が表示されます。Windows Admin Center will show extensions available from the specified NuGet feed. 既定で、Windows Admin Center では、Microsoft や他の開発者から発行された拡張機能をホストする Microsoft の公式 NuGet フィードが示されます。By default, Windows Admin Center points to the Microsoft official NuGet feed which hosts extensions published by Microsoft and other developers.

  1. 右上の [設定] ボタンをクリックし、左ペインの [拡張機能] をクリックします。Click the Settings button in the top-right > In the left pane, click Extensions.
  2. [使用可能な拡張機能] タブには、インストールできる拡張機能がフィードに一覧表示されます。The Available Extensions tab will list the extensions on the feed that are available for installation.
  3. 拡張機能をクリックすると、 [詳細] ペインに拡張機能の説明、バージョン、発行元、およびその他の情報が表示されます。Click on an extension to view the extension description, version, publisher and other information in the Details pane.
  4. [インストール] をクリックして拡張機能をインストールします。Click Install to install an extension. この変更を行うために、ゲートウェイを特権モードで実行する必要がある場合は、UAC の昇格プロンプトが表示されます。If the gateway must run in elevated mode to make this change, you will be presented with a UAC elevation prompt. インストールが完了すると、ブラウザーが自動的に更新され、Windows Admin Center に新しい拡張機能がインストールされ、再度読み込まれます。After installation is complete, your browser will automatically be refreshed and Windows Admin Center will be reloaded with the new extension installed. インストール対象の拡張機能が以前にインストールされた拡張機能の更新プログラムである場合、 [Update to latest](最新版への更新) ボタンをクリックして更新プログラムをインストールできます。If the extension you are trying to install is an update to a previously installed extension, you can click the Update to latest button to install the update. また、 [インストール済みの拡張機能] タブにアクセスしてインストールされている拡張機能を表示し、 [状態] 列で更新プログラムがあるかどうかを確認することもできます。You can also go to the Installed Extensions tab to view installed extensions and see if an update is available in the Status column.

別のフィードからの拡張機能のインストールInstalling extensions from a different feed

Windows Admin Center は複数のフィードをサポートしており、一度に複数のフィードからパッケージを表示および管理できます。Windows Admin Center supports multiple feeds and you can view and manage packages from more than one feed at a time. NuGet V2 API またはファイル共有をサポートする NuGet フィードを Windows Admin Center に追加して、拡張機能をインストールできます。Any NuGet feed that supports the NuGet V2 APIs or a file share can be added to Windows Admin Center for installing extensions from.

  1. 右上の [設定] ボタンをクリックし、左ペインの [拡張機能] をクリックします。Click the Settings button in the top-right > In the left pane, click Extensions.
  2. 右側のペインで [フィード] タブをクリックします。On the right pane, click the Feeds tab.
  3. 別のフィードを追加するには [追加] ボタンをクリックします。Click the Add button to add another feed. NuGet フィードの場合は、NuGet V2 フィードの URL を入力します。For a NuGet feed, enter the NuGet V2 feed URL. NuGet フィード プロバイダーまたは管理者は、URL 情報を指定できる必要があります。The NuGet feed provider or administrator should be able to provide the URL information. ファイル共有の場合は、拡張機能パッケージ ファイル (.nupkg) が格納されているファイル共有の完全パスを入力します。For a file share, enter the full path of the file share in which the extension package files (.nupkg) are stored.
  4. [追加] をクリックします。Click Add. この変更を行うために、ゲートウェイを特権モードで実行する必要がある場合は、UAC の昇格プロンプトが表示されます。If the gateway must run in elevated mode to make this change, you will be presented with a UAC elevation prompt.

[使用可能な拡張機能] 一覧には、すべての登録済みフィードの拡張機能が表示されます。The Available Extensions list will show extensions from all registered feeds. [Package Feed](パッケージ フィード) 列を使用して、各拡張機能のフィード元を確認できます。You can check which feed each extension is from using the Package Feed column.

拡張機能のアンインストールUninstalling an extension

以前にインストールした拡張機能をアンインストールできます。また、Windows Admin Center のインストールの一部として事前にインストールされていたツールをアンインストールすることもできます。You can uninstall any extensions you have previously installed, or even uninstall any tools that were pre-installed as part of the Windows Admin Center installation.

  1. 右上の [設定] ボタンをクリックし、左ペインの [拡張機能] をクリックします。Click the Settings button in the top-right > In the left pane, click Extensions.
  2. インストールされているすべての拡張機能を表示するには [インストール済みの拡張機能] タブをクリックします。Click the Installed Extensions tab to view all installed extensions.
  3. アンインストールする拡張機能を選択し、 [アンインストール] をクリックします。Choose an extension to uninstall, then click Uninstall.

アンインストールが完了すると、ブラウザーは自動的に更新され、拡張機能が削除された状態で Windows Admin Center が再度読み込まれます。After uninstall is complete, your browser will automatically be refreshed and Windows Admin Center will be reloaded with the extension removed. Windows Admin Center の一部としてプレインストールされたツールをアンインストールした場合、 [使用可能な拡張機能] タブでそのツールを再インストールできます。If you uninstalled a tool that was pre-installed as part of Windows Admin Center, the tool will be available for reinstallation in the Available Extensions tab.

インターネットに接続されていないコンピューターへの拡張機能のインストールInstalling extensions on a computer without internet connectivity

インターネットに接続されていないコンピューターまたはプロキシの背後にあるコンピューターに Windows Admin Center がインストールされている場合、Windows Admin Center フィードから拡張機能にアクセスおよびインストールできない場合があります。If Windows Admin Center is installed on a computer that isn't connected to the internet or is behind a proxy, it may not be able to access and install the extensions from the Windows Admin Center feed. 拡張機能パッケージを手動でまたは PowerShell スクリプトを使用してダウンロードし、ファイル共有またはローカル ドライブからパッケージを取得するように Windows Admin Center を構成できます。You can download extension packages manually or with a PowerShell script, and configure Windows Admin Center to retrieve packages from a file share or local drive.

拡張機能パッケージを手動でダウンロードするManually downloading extension packages

  1. インターネットに接続できる別のコンピューターで Web ブラウザーを開き、https://msft-sme.myget.org/gallery/windows-admin-center-feed の URL に移動します。On another computer that has internet connectivity, open a web browser and navigate to the following URL: https://msft-sme.myget.org/gallery/windows-admin-center-feed

    • 拡張機能パッケージを表示するには、必要に応じて msft-sme.myget.org 上でアカウントを作成し、ログインします。You may need to create an account on msft-sme.myget.org and login to view the extension packages.
  2. インストールするパッケージの名前をクリックすると、パッケージの詳細ページが表示されます。Click on the name of the package you want to install to view the package details page.

  3. パッケージの詳細ページの右側のペインにある [ダウンロード] リンクをクリックし、拡張機能の .nupkg ファイルをダウンロードします。Click on the Download link in the right-side pane of the package details page and download the .nupkg file for the extension.

  4. ダウンロードするすべてのパッケージについて、手順 2 と 3 を繰り返します。Repeat steps 2 and 3 for all the packages you want to download.

  5. Windows Admin Center がインストールされているコンピューターからアクセスできる共有ファイル、またはコンピューターのローカル ディスクにパッケージ ファイルをコピーします。Copy the package files to a file share that can be accessed from the computer Windows Admin Center is installed on, or to the local disk of the computer.

  6. 指示に従って別のフィードから拡張機能をインストールしますFollow the instructions to install extensions from a different feed.

PowerShell スクリプトを使用したパッケージのダウンロードDownloading packages with a PowerShell script

NuGet フィードから NuGet パッケージをダウンロードするためにインターネット上で利用できるスクリプトは多数あります。There are many scripts available on the Internet for downloading NuGet packages from a NuGet feed. ここでは、Microsoft のシニア プログラム マネージャーである Jon Galloway が提供しているスクリプトを使用します。We'll use the script provided by Jon Galloway, Senior Program Manager at Microsoft.

  1. ブログ投稿で説明されているように、このスクリプトを NuGet パッケージとしてインストールするか、スクリプトをコピーして PowerShell ISE に貼り付けます。As described in the blog post, install the script as a NuGet package, or copy and paste the script into the PowerShell ISE.
  2. スクリプトの最初の行を NuGet フィードの v2 URL に変更します。Edit the first line of the script to your NuGet feed's v2 URL. Windows Admin Center の公式フィードからパッケージをダウンロードする場合は、以下の URL を使用します。If you are downloading packages from the Windows Admin Center official feed, use the URL below.
$feedUrlBase = "https://aka.ms/sme-extension-feed"
  1. スクリプトを実行すると、フィードからローカル フォルダー %USERPROFILE%\Documents\NuGetLocal にすべての NuGet パッケージがダウンロードされます。Run the script and it will download all the NuGet packages from the feed to the following local folder: %USERPROFILE%\Documents\NuGetLocal
  2. 指示に従って別のフィードから拡張機能をインストールしますFollow the instructions to install extensions from a different feed.

PowerShell を使用して拡張機能を管理するManage extensions with PowerShell

Windows Admin Center プレビューには、ゲートウェイ拡張機能を管理する PowerShell モジュールが含まれています。Windows Admin Center Preview includes a PowerShell module to manage your gateway extensions.

# Add the module to the current session
Import-Module "$env:ProgramFiles\windows admin center\PowerShell\Modules\ExtensionTools"
# Available cmdlets: Get-Feed, Add-Feed, Remove-Feed, Get-Extension, Install-Extension, Uninstall-Extension, Update-Extension

# List feeds
Get-Feed "https://wac.contoso.com"

# Add a new extension feed
Add-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# Remove an extension feed
Remove-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# List all extensions
Get-Extension "https://wac.contoso.com"

# Install an extension (locate the latest version from all feeds and install it)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers"

# Install an extension (latest version from a specific feed, if the feed is not present, it will be added)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers" -Feed "https://aka.ms/sme-extension-feed"

# Install an extension (install a specific version)
Install-Extension "https://wac.contoso.com" "msft.sme.certificate-manager" "0.133.0"

# Uninstall-Extension
Uninstall-Extension "https://wac.contoso.com" "msft.sme.containers"

# Update-Extension
Update-Extension "https://wac.contoso.com" "msft.sme.containers"

注意

PowerShell を使用して Windows Admin Center の拡張機能を変更するには、ゲートウェイ管理者である必要があります。You must be gateway administrator to modify Windows Admin Center extensions with PowerShell.

Windows Admin Center SDK を使用した拡張機能の構築の詳細については、こちらを参照してくださいLearn more about building an extension with the Windows Admin Center SDK.