次の方法で共有

拡張機能のインストールと管理

  • 適用対象: ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Windows Admin Center は拡張可能なプラットフォームとして構築されています。各接続の種類とツールは、個別にインストール、アンインストール、更新が可能な拡張機能です。 Microsoft や他の開発者から発行された新しい拡張機能を検索し、Windows Admin Center インストール全体を更新することなく、個別にインストールおよび更新できます。 また、個別の NuGet フィードまたはファイル共有を構成し、組織内で使用する拡張機能を配布することもできます。

拡張機能のインストール

Windows Admin Center には、指定された NuGet フィードから使用できる拡張機能が表示されます。 既定で、Windows Admin Center では、Microsoft や他の開発者から発行された拡張機能をホストする Microsoft の公式 NuGet フィードが示されます。

  1. 右上の [設定] ボタンを選択 > 左側のウィンドウで、[ 拡張機能] を選択します。
  2. [ 利用可能な拡張機能 ] タブには、インストールに使用できるフィードの拡張機能が一覧表示されます。
  3. 拡張機能を選択して、[ 詳細 ] ウィンドウで拡張機能の説明、バージョン、発行元、およびその他の情報を表示します。
  4. [ インストール] を選択して拡張機能をインストールします。 この変更を行うために、ゲートウェイを特権モードで実行する必要がある場合は、ユーザー アカウント制御 (UAC) の昇格プロンプトが表示されます。 インストールが完了すると、ブラウザーが自動的に更新され、Windows Admin Center に新しい拡張機能がインストールされ、再度読み込まれます。 インストールしようとしている拡張機能が以前にインストールされた拡張機能の更新プログラムである場合は、[ 最新の拡張機能に更新 ] ボタンを選択して更新プログラムをインストールできます。 [ インストールされている拡張機能 ] タブに移動して、インストールされている拡張機能を表示し、[ 状態] 列で更新プログラムを使用できるかどうかを確認することもできます。

別のフィードからの拡張機能のインストール

Windows Admin Center は複数のフィードをサポートしており、一度に複数のフィードからパッケージを表示および管理できます。 NuGet V2 API またはファイル共有をサポートする NuGet フィードを Windows Admin Center に追加して、拡張機能をインストールできます。

  1. 右上の [設定] ボタンを選択 > 左側のウィンドウで、[ 拡張機能] を選択します。
  2. 右側のウィンドウで、[ フィード ] タブを選択します。
  3. [ 追加 ] ボタンを選択して、別のフィードを追加します。 NuGet フィードの場合は、NuGet V2 フィードの URL を入力します。 NuGet フィード プロバイダーまたは管理者は、URL 情報を指定できる必要があります。 ファイル共有の場合は、拡張機能パッケージ ファイル (.nupkg) が格納されているファイル共有の完全パスを入力します。 フィードとしてファイル共有を追加する場合は、次の基準を満たしている必要があります。
    • ファイルへのアクセスは NTAuthority\Network Service に付与される必要があります
    • ファイル パスに C:\Users フォルダーを含めることはできません
    • 操作モードが "開発" に設定されている場合を除き、ファイル共有のパッケージに署名する必要があります
  4. [] を選択し、[] を追加します。 この変更を行うために、ゲートウェイを特権モードで実行する必要がある場合は、UAC の昇格プロンプトが表示されます。 このプロンプトは、Windows Admin Center をデスクトップ モードで実行している場合にのみ表示されます。

[使用可能な拡張機能] リストには、登録されているすべてのフィードの拡張機能が表示されます。 [ パッケージ フィード ] 列を使用して、各拡張機能のどのフィードが使用されているかを確認できます。

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

以前にインストールした拡張機能をアンインストールできます。また、Windows Admin Center のインストールの一部として事前にインストールされていたツールをアンインストールすることもできます。

  1. 右上の [設定] ボタンを選択 > 左側のウィンドウで、[ 拡張機能] を選択します。
  2. [ インストールされている拡張機能 ] タブを選択して、インストールされているすべての拡張機能を表示します。
  3. アンインストールする拡張機能を選択し、[アンインストール] を選択 します。

アンインストールが完了すると、ブラウザーは自動的に更新され、拡張機能が削除された状態で Windows Admin Center が再度読み込まれます。 Windows Admin Center の一部としてプレインストールされているツールをアンインストールした場合は、[ 利用可能な拡張機能 ] タブで再インストールできます。

インターネットに接続されていないコンピューターへの拡張機能のインストール

インターネットに接続されていないコンピューターまたはプロキシの背後にあるコンピューターに Windows Admin Center がインストールされている場合、Windows Admin Center フィードから拡張機能にアクセスおよびインストールできない場合があります。 拡張機能パッケージを手動でまたは PowerShell スクリプトを使用してダウンロードし、ファイル共有またはローカル ドライブからパッケージを取得するように Windows Admin Center を構成できます。

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

  1. インターネットに接続されている別のコンピューターで、Web ブラウザーを開き、次の URL に移動します: https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_packaging?_a=feed&feed=WAC

    拡張機能パッケージを表示するには、Microsoft アカウントを作成してサインインすることが必要な場合もあります。

  2. インストールするパッケージの名前を選択して、パッケージの詳細ページを表示します。

  3. パッケージの詳細ページの上部のナビゲーション バーにある [ダウンロード ] リンクを選択し、拡張機能の .nupkg ファイルをダウンロードします。

  4. ダウンロードするすべてのパッケージについて、手順 2 と 3 を繰り返します。

  5. Windows Admin Center がインストールされているコンピューターからアクセスできる共有ファイル、または Windows Admin Center がインストールされているコンピューターのローカル ディスクにパッケージ ファイルをコピーします。

  6. 指示に従って、別のフィードから拡張機能をインストールします。

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

インターネット上には、NuGet フィードから NuGet パッケージをダウンロードするためのスクリプトがあります。 Microsoft のシニア プログラム マネージャーである Jon Galloway が提供するスクリプトを使用します。

  1. ブログ記事で説明されているように、スクリプトを NuGet パッケージとしてインストールするか、スクリプトをコピーして PowerShell ISE に貼り付けます。

  2. スクリプトの最初の行を NuGet フィードの v2 URL に変更します。 Windows Admin Center の公式フィードからパッケージをダウンロードする場合は、次の URL を使用します。

    $feedUrlBase = "https://aka.ms/sme-extension-feed"

  3. スクリプトを実行すると、フィードからローカル フォルダー %USERPROFILE%\Documents\NuGetLocal にすべての NuGet パッケージがダウンロードされます。

  4. 指示に従って、別のフィードから拡張機能をインストールします。

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

Windows Admin Center プレビューには、ゲートウェイ拡張機能を管理する PowerShell モジュールが含まれています。

# 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"

Note

PowerShell を使用して Windows Admin Center の拡張機能を変更するには、ゲートウェイ管理者である必要があります。

Windows Admin Center SDK を使用した拡張機能の構築の詳細については、こちらを参照してください。

ゲートウェイ プラグイン拡張機能

Windows Admin Center ゲートウェイ プラグイン拡張機能は、最新化されたゲートウェイの変更によって最も影響を受けます。 Windows Admin Center ゲートウェイ プラグインを使用すると、ツールまたはソリューションの UI からターゲット ノードへの API 通信が可能になります。 Windows Admin Center では、ターゲット ノードで実行されるゲートウェイ プラグインからコマンドとスクリプトをリレーするゲートウェイ サービスをホストします。 ゲートウェイ サービスを拡張して、既定のプロトコル (PowerShell と WMI) 以外のプロトコルをサポートするカスタム ゲートウェイ プラグインを含めることができます。

ゲートウェイ プラグインは Windows Admin Center のバックエンドと通信して API 通信を有効にするため、ゲートウェイ プラグイン コードには、.NET Framework バージョン 4.6.2 で記述されたコンポーネントを含めることができます。.NET 8 では機能しません。

さらに、プラグインがバージョン 2410 で動作する方法を変更しました。 ゲートウェイ プラグインを拡張するために、IPlugIn名前空間からMicrosoft.ManagementExperience.FeatureInterfaces インターフェイスを実装する C# クラスを開発する代わりに、拡張機能は MVC コントローラーの形式 ASP.NET 記述されます。 これらのコントローラーは、単純な C# クラスや広範なドキュメントに比べて柔軟性が向上しています。

Windows Admin Center でのゲートウェイ プラグイン開発の詳細については、開発者向けドキュメントを参照してください。

ゲートウェイ拡張機能はサポートされていません

Windows Admin Center ゲートウェイの拡張機能フィードが構成されていません。 Windows Admin Center インストーラーに含まれていない拡張機能 (外部パートナー拡張機能を含む) は、拡張機能フィードを追加しない限り使用できません。

最新化されたゲートウェイ ビルドのインストール時に、次の拡張機能を使用できます。

  • アプリと機能
  • Azure Backup
  • Azure File Sync
  • Azure ハイブリッド センター
  • Azure Kubernetes Service
  • 証明 書
  • クラスターの作成
  • クラスター マネージャー
  • 開発者ガイド
  • デバイス
  • イベント
  • フェールオーバー クラスター ツール
  • ファイルおよび共有
  • ファイアウォール
  • ローカル ユーザーとグループ
  • ネットワーク コントローラー ツールと SDN 仮想ネットワーク
  • Networks
  • パケット監視
  • パフォーマンス モニター
  • PowerShell
  • Processes
  • Registry
  • リモート デスクトップ
  • 役割と機能
  • スケジュールされたタスク
  • SDN ゲートウェイ接続
  • SDN インフラストラクチャ
  • SDN 論理ネットワーク
  • SDN ネットワーク セキュリティ グループ
  • セキュリティ
  • サーバー マネージャーとコンピューターの管理
  • Services
  • Storage
  • ストレージ マイグレーション サービス
  • 記憶域レプリカ
  • System Insights
  • 最新情報
  • 仮想マシンとスイッチ
  • Last updated on