Windows Admin Center 2410のPowerShell概要_PowerShell Overview for Windows Admin Center 2410

176 Views

September 26, 25

スライド概要

PowerShellコマンドレットの比較概要
構成管理関連コマンドレット
接続管理関連コマンドレット
拡張関連コマンドレット
管理関連コマンドレット
移行関連コマンドレット
PowerShellTools関連コマンドレット
まとめ
参考情報
---
Comparison of PowerShell cmdlets
Configuration Management Cmdlets
Connection Management Cmdlets
Extensibility Cmdlets
Management Cmdlets
Migration Cmdlets
PowerShell Tools Cmdlets
Summary
Reference Information

profile-image

WindowsとSC 2019、Linuxも。いまは主にS2DとWindows Admin Center。趣味は、 風景、花、サーフィンの写真撮影、ガンプラ。Microsoft MVP CDM, MCSE Private Cloud, RHCSEです。

シェア

またはPlayer版

埋め込む »CMSなどでJSが使えない場合

ダウンロード

関連スライド

各ページのテキスト
1.

Windows Admin Center 2410のPowerShell概要 wSCUGJ Microsoft MVP Cloud and Datacenter Management 指崎 則夫, Norio Sashizaki 2025年09月20日

2.

はじめに   下記の情報を手始めに本資料をまとめていきます。  Windows Admin Center のリリース履歴 https://learn.microsoft.com/ja-jp/windows-server/manage/windows-admincenter/support/release-history  Windows Admin Center version 2410 is now generally available! https://techcommunity.microsoft.com/blog/windows-admin-center-blog/windows-admincenter-version-2410-is-now-generally-available/4356534  拙作記事である下記記事を引用いたします。  https://atmarkit.itmedia.co.jp/ait/articles/2502/05/news009.html  https://atmarkit.itmedia.co.jp/ait/articles/2503/08/news002.html  https://atmarkit.itmedia.co.jp/ait/articles/2504/07/news008.html  https://atmarkit.itmedia.co.jp/ait/articles/2505/09/news007.html  https://atmarkit.itmedia.co.jp/ait/articles/2506/17/news005.html  https://atmarkit.itmedia.co.jp/ait/articles/2507/07/news012.html  https://atmarkit.itmedia.co.jp/ait/articles/2509/10/news004.html 必要に応じて、各ページで参考情報としてURLを記載しますので、予めご承知おきください。 2025/03/15 2

3.

ご注意  本セッションの内容は、所属社の見解ではありません。  本セッションの内容で、正式リリースや、正式リリースに見当たらない情報を扱っ ています。  PowerShellコマンドレットについて、本稿作成時点で公式情報が見当たらない箇所多数 のため、推測にとどまる箇所がございます。  構成管理関連コマンドレットのカスタムセットアップに関連するコマンドレット、接続管理関 連コマンドレットに含まれる接続リストのエクスポートとインポートに関連するコマンドレットは、 すでにを下記資料を公開しておりますのでそちらをご確認いただく形です。ご了承ください。  Windows Admin Center 2410 その2 https://www.docswell.com/s/sshzk/ZYDLDV-2025-03-15-144918  本セッションの内容は、発表時点の情報に基づくこと、ご了承ください。  Windows Admin CenterをWACと略す箇所がございます。 2025/03/15 3

4.

自己紹介  指崎則夫(さしざきのりお) http://sashiz.seesaa.net → http://sashiz.wordpress.com → http:// sshzk.blogspot.com http://www.slideshare.net/noriosashizaki/ https://www.docswell.com/user/sshzk https://speakerdeck.com/sashizaki https://www.facebook.com/norio.sashizaki https://mstdn.jp/web/@sshzknr @sshzk https://www.linkedin.com/in/norio-sashizaki-a4208a89/ SCUGJ運営スタッフ  Microsoft MVP Cloud and Datacenter Management 2014/01~2026/06  Windows Server 2016、Windows Server 2019、 Windows Server 2022、Windows Server 2025、 System Center 2025、Azure Local/Azure Stack HCI /S2D 、 Azure Stack Hub、Windows Admin Centerなど  写真撮影  ガンプラ… 2025/03/15 4

5.

アジェンダ  PowerShellコマンドレットの比較概要  構成管理関連コマンドレット  接続管理関連コマンドレット  拡張関連コマンドレット  管理関連コマンドレット  移行関連コマンドレット  PowerShellTools関連コマンドレット  まとめ  参考情報 2025/03/15 5

6.

PowerShellコマンドレットの比較概要 Set-WACCertificateAcl、SetWACCertificateSubjectNameを含め、 145個のコマンドレット WAC 2410 Microsoft.WindowsAdminCenter .Configuration WAC 2311 UpdateWACClusterNodeConfiguration.ps1 にfunction 12個(function mainを 除く) Microsoft.WindowsAdminCenter .ConnectionTools Export-WACConnection、ImportWACConnectionを含め、6個のコマ ンドレット ConnectionTools Export-Connection Import-Connection Microsoft.WindowsAdminCenter .ExtensionTools Install-WACExtensionを含め、10個の コマンドレット ExtensionTools Microsoft.WindowsAdminCenter .ManagementTools Enter-WACPSSessionコマンドレット のみ MMicrosoft.WindowsAdminCent er.Migration Export-WACSettings、ImportWACSettingsを含め、27個のコマン ドレット Add-Feed Get-Extension Get-Feed Install-Extension Remove-Feed Uninstall-Extension Update-Extension Export-WACDscPackage Enter-SmePSSession Enter-SmeSshSession Microsoft.WindowsAdminCenter .PowerShellTools 本資料の主な説明箇所 ManagementTools 凡例)継承関係: 2025/03/15 6

7.

構成管理関連コマンドレット  カスタムセットアップに関連するコマンドレットは、詳細を下記資料に記載をしておりますのでそちらをご確認 ください。   Windows Admin Center 2410 その2 https://www.docswell.com/s /sshzk/ZYDLDV-2025-03-15-144918 カスタムセットアップ以外のコマンドレット多数かつ細やかな物が多い印象です。  一覧として下記に記載しておりますので、説明を省略いたします。 https://atmarkit.itmedia.co.jp /ait/articles /2505/09/news007.html 2025/03/15 7

8.

接続管理関連コマンドレット(1/2)  公式の手順は、WAC 2311のままなのでご注意ください。   https://learn.microsoft.com/en-us/windows-server/manage/windows-admin-center/configure/use-powershell#use-powershell-to-import-or-export-yourconnections-with-tags 接続リストのエクスポートとインポートに関連するコマンドレットは、詳細を下記資料に記載をしておりますのでそちらご確認ください。  Windows Admin Center 2410 その2 https://www.docswell.com/s/sshzk/ZYDLDV-2025-03-15-144918  AccessKeyオプションを使う場合は、WACの設定→アクセス画面よりAccessKeyを事前取得しましょう。  接続リストのエクスポートとインポート以外のコマンドレットについて、実行結果を記載します。  GetConnection、ApplyConnectionを実行しましたが、実行エラーでした。  AccessKeyを除いてCreateApplicationAccessTokenを実行しましたが、特に表示なしでした。 2025/03/15 8

9.

接続管理関連コマンドレット(2/2)  Microsoft.WindowsAdminCenter.ConnectionToolsモジュールのコマンドレット一覧を記載します。 コマンドレット名 概要と構文 ApplyConnection CreateApplicationAccessToken Export-WACConnection GetConnection Import-WACConnection RemoveConnection ApplyConnection [[-Endpoint] <uri>] [[-Credentials] <pscredential>] [[-Body] <string>] [[-AccessKey] <string>] CreateApplicationAccessToken [[-credentials] <pscredential>] [[-accessKey] <string>] Windows Admin Center ゲートウェイで利用可能な接続をエクスポートします。 ファイル名が指定されている場合はエクスポートします。 Export-WACConnection [-Endpoint] <Uri> [[-FileName] <String>] [[Credentials] <PSCredential>] [-AccessKey] <String> [<CommonParameters>] GetConnection [[-Endpoint] <uri>] [[-Credentials] <pscredential>] [[AccessKey] <string>] ファイル内の利用可能な接続を Windows Admin Center ゲートウェイにイン ポートします。 Import-WACConnection [-Endpoint] <Uri> [[-Credentials] <PSCredential>] [FileName] <String> [-Prune] [-AccessKey] <String> [<CommonParameters>] RemoveConnection [[-Endpoint] <uri>] [[-Credentials] <pscredential>] [[ConnectionId] <string>] [[-AccessKey] <string>] 2025/03/15 9

10.

拡張関連コマンドレット(1/9)  Microsoft.WindowsAdminCenter.ExtensionToolsモジュールのコマンドレットには、10個のコマン ドレットがあります。 コマンドレット名 Add-WACFeed CreateApplicationAccessToken GetAccessParameters GetRecentVersion Get-WACExtension Get-WACFeed 概要と構文 Windows Admin Center ゲートウェイにフィードを追加します。 Add-WACFeed -Endpoint <Uri> -Feed <String> [<CommonParameters>] Add-WACFeed -Endpoint <Uri> -Feed <String> [-Credentials <PSCredential>] AccessKey <String> [<CommonParameters>] CreateApplicationAccessToken [[-credentials] <pscredential>] [[-accessKey] <string>] GetAccessParameters [[-Endpoint] <uri>] [[-Credentials] <pscredential>] [[AccessKey] <string>] GetRecentVersion [[-extensions] <Object>] Windows Admin Center ゲートウェイで利用可能な拡張機能を表示します。 Get-WACExtension -Endpoint <Uri> [<CommonParameters>] Get-WACExtension -Endpoint <Uri> [-Credentials <PSCredential>] -AccessKey <String> [<CommonParameters>] Windows Admin Center ゲートウェイで利用可能なフィードを表示します。 Get-WACFeed -Endpoint <Uri> [<CommonParameters>] Get-WACFeed -Endpoint <Uri> [-Credentials <PSCredential>] -AccessKey <String> [<CommonParameters>] 2025/03/15 10

11.

拡張関連コマンドレット(2/9)  Microsoft.WindowsAdminCenter.ExtensionToolsモジュールのコマンドレットには、10個のコマン ドレットがあります。 コマンドレット名 Install-WACExtension Remove-WACFeed Uninstall-WACExtension Update-WACExtension 概要と構文 Windows Admin Center 拡張機能をインストールします。 Install-WACExtension -Endpoint <Uri> -ExtensionId <String> [-Version <String>] [-Feed <String>] [<CommonParameters>] Install-WACExtension -Endpoint <Uri> -ExtensionId <String> [-Version <String>] [-Feed <String>] [-Credentials <PSCredential>] -AccessKey <String> [<CommonParameters>] Windows Admin Center ゲートウェイへのフィードを削除します。 Remove-WACFeed -Endpoint <Uri> -Feed <String> [<CommonParameters>] Remove-WACFeed -Endpoint <Uri> -Feed <String> [-Credentials <PSCredential>] -AccessKey <String> [<CommonParameters>] Windows Admin Center 拡張機能をアンインストールします。 ninstall-WACExtension -Endpoint <Uri> -ExtensionId <String> [<CommonParameters>] Uninstall-WACExtension -Endpoint <Uri> -ExtensionId <String> [-Credentials <PSCredential>] -AccessKey <String> [<CommonParameters>] Windows Admin Center 拡張機能を更新します。 Update-WACExtension -Endpoint <Uri> -ExtensionId <String> [-Feed <String>] [<CommonParameters>] Update-WACExtension -Endpoint <Uri> -ExtensionId <String> [-Feed <String>] [Credentials <PSCredential>] -AccessKey <String> [<CommonParameters>] 2025/03/15 11

12.

拡張関連コマンドレット(3/9)  AccessKeyオプションを使う場合は、WACの設定→アクセス画面よりAccessKeyを事前取得しておき ましょう。  あらかじめMicrosoft.WindowsAdminCenter.ExtensionToolsモジュールは、あらかじめインポート します。  クレデンシャルは、事前に変数(例として、$cred)へ設定済みとします。  実行結果がエラーとなったコマンドレットは、説明を省略いたします。 2025/03/15 12

13.

拡張関連コマンドレット(4/9)  拡張へのアクセスパラメーターを表示するため、GetAccessParametersを実行します。  このコマンドレットは、AccessKey無しでも使えました。 2025/03/15 13

14.

拡張関連コマンドレット(5/9)  Feedの表示、追加、削除では、Get-WACFeedのみを使用例とします。   既定値を維持するため、Add-WACFeedとRemove-WACFeedの説明は省略します。 クレデンシャルとAccessKeyは、必須パラメーターです。 2025/03/15 14

15.

拡張関連コマンドレット(6/9)  利用可能な拡張を表示するため、Get-WACExtensionを使用します。  クレデンシャルとAccessKeyは、必須パラメーターです。  既定の出力は、Format-List形式です。 2025/03/15 15

16.

拡張関連コマンドレット(7/9)  Install-WACExtensionを使用して、Active Directory拡張をインストールします。  クレデンシャルとAccessKeyは、必須パラメーターです。  WACの画面でもインストール完了を確認できましたが、WACの画面をリロードした方が良い場合もありま す。 2025/03/15 16

17.

拡張関連コマンドレット(8/9)  Uninstall-WACExtensionを使用して、Active Directory拡張をアンインストールします。  クレデンシャルとAccessKeyは、必須パラメーターです。  WACの画面でもアンインストール完了を確認できましたが、WACの画面をリロードした方が良い場合もあ ります。 2025/03/15 17

18.

拡張関連コマンドレット(9/9)  Update-WACExtensionを使用して、PowerShell拡張を更新します。  クレデンシャルとAccessKeyは、必須パラメーターです。  同じ拡張でも、バージョン違いで表示されることがあるため、Update-WACExtensionで拡張を更新す る場合、よく確認することをお勧めいたします。 2025/03/15 18

19.

管理コマンドレット  Microsoft.WindowsAdminCenter.ManagementToolsモジュールには、EnterWACPSSessionコマンドレットだけです。 コマンドレット名 概要と構文 Enter-WACPSSession PowerShell セッションを使用してコンピューターにリモート ログオンします。 Enter-WACPSSession [-Computer] <String> [-UserName] <String> [[UseHttps] <Boolean>] [[-PowerShellSessionConfiguration] <String>] [[UserNameLabel] <String>] [[-PromptLabel] <String>] [[-Message] <String>] [<CommonParameters>]  Enter-WACPSSessionコマンドレットを実行した結果、Enter-PSSessionコマンドレットと同様のリ モート操作が可能でした。 2025/03/15 19

20.

Migration関連コマンドレット(1/9)  Microsoft.WindowsAdminCenter.Migrationモジュールのコマンドレットには、27個のコマンドレット があります。 コマンドレット名 概要と構文 Base64Decode 内部関数 Base64Decode Base64Decode [[-base64EncodedData] <String>] [<CommonParameters>] ConvertToDatabase Windows Admin Center V1 データベースオブジェクトを新しいデータベースオブジェクトに変換する内部関数です。 ConvertToDatabase [[-FolderPath] <String>] [[-Version1Source] <Object>] [<CommonParameters>] CreateAppConfigEntry 内部関数 CreateAppConfigEntry CreateAppConfigEntry [[-config] <Object>] [<CommonParameters>] CreateGroupEntry 内部関数 CreateGroupEntry CreateGroupEntry [[-group] <Object>] [[-scope] <Object>] [<CommonParameters>] 2025/03/15 20

21.

Migration関連コマンドレット(2/9)  Microsoft.WindowsAdminCenter.Migrationモジュールのコマンドレットには、27個のコマンドレット があります。 コマンドレット名 概要と構文 ExportVersion1Database Windows Admin Center V1 のデータベース内容をエクスポートする内部関数です。 ExportVersion1Database [[-Path] <String>] [[-DatabaseFolder] <String>] [<CommonParameters>] Export-WACDatabase データベースの内容をエクスポートします。 Export-WACDatabase [[-Path] <String>] [-Version1] [[-Version1DatabaseFolder] <String>] [<CommonParameters>] Export-WACExtensions Windows Admin Center V2 の拡張機能をエクスポートします。 Export-WACExtensions [[-Path] <String>] [-Version1] [<CommonParameters>] Export-WACSettings Windows Admin Center の設定をエクスポートします。 Export-WACSettings [[-Path] <String>] [-Version1] [[-IniPath] <String>] [<CommonParameters>] GetInstalledStatus 現在インストールされている Windows Admin Center V1 および V2 の状態を読み取る内部関数です。 GetInstalledStatus [[-FolderPath] <String>] [<CommonParameters>] Import-WACDatabase データベースの内容をインポートします。 Import-WACDatabase [[-Path] <String>] [-NotReset] [<CommonParameters>] 2025/03/15 21

22.

Migration関連コマンドレット(3/9)  Microsoft.WindowsAdminCenter.Migrationモジュールのコマンドレットには、27個のコマンドレット があります。 コマンドレット名 概要と構文 Import-WACExtensions Windows Admin Center V2 の拡張機能をインポートします。 Import-WACExtensions [[-Path] <String>] [[-Url] <String>] [[-Feed] <String>] [[-AccessKey] <String>] [<CommonParameters>] Import-WACSettings Windows Admin Center V2 の設定をインポートします。 Import-WACSettings [[-Path] <String>] [<CommonParameters>] InitializeDatabaseInstance 内部関数 InitializeDatabaseInstance InitializeDatabaseInstance [[-folderPath] <String>] [<CommonParameters>] InvokeWinCommand Windows コマンドを呼び出す内部ユーティリティ関数です。(このコマンドは Microsoft 社内でのみ使用されます。) InvokeWinCommand [[-Command] <String>] [[-Parameters] <String[]>] [<CommonParameters>] NormalizeValue 内部関数 NormalizeValue NormalizeValue [[-value] <Object>] [<CommonParameters>] OutIniFile OutIniFile [[-InputObject] <Object>] [[-FilePath] <String>] [<CommonParameters>] 2025/03/15 22

23.

Migration関連コマンドレット(4/9)  Microsoft.WindowsAdminCenter.Migrationモジュールのコマンドレットには、27個のコマンドレット があります。 コマンドレット名 概要と構文 ReadVersion1Database 内部関数 ReadVersion1Database ReadVersion1Database [[-path] <String>] [<CommonParameters>] ReadVersion1DataTable 内部関数 ReadVersion1DataTable ReadVersion1DataTable [[-path] <String>] [<CommonParameters>] RecoverDatabaseAndShutd 内部関数 RecoverDatabaseAndShutdownCleanly ownCleanly RecoverDatabaseAndShutdownCleanly [[-file] <Object>] [<CommonParameters>] ResetMigrationStatus 移行ステータスファイルをリセットする内部関数です。この関数はフォルダーの存在を前提としています。 ResetMigrationStatus [[-FolderPath] <String>] [<CommonParameters>] Restore-WACResource Windows Admin Center V2 の設定、拡張機能、およびデータベースを復元します。 Restore-WACResource [[-FolderPath] <String>] [-RestoreSettings] [-RestoreExtensions] [RestoreDatabase] [<CommonParameters>] RestoreWACV1Environment Windows Admin Center V1 環境を復元して移行を元に戻します。 Restore-WACV1Environment [[-FolderPath] <String>] [-Force] [<CommonParameters>] Save-WACResource Windows Admin Center V1 の現在の設定、拡張機能、およびデータベースを保存します。 Save-WACResource [[-FolderPath] <String>] [[-BackupPath] <String>] [-Version1] [DoNotReStartService] [<CommonParameters>] 2025/03/15 23

24.

Migration関連コマンドレット(5/9)  Microsoft.WindowsAdminCenter.Migrationモジュールのコマンドレットには、27個のコマンドレット があります。 コマンドレット名 概要と構文 TrimLines TrimLines [[-original] <string>] UpdateMigrationStatus UI による支援が必要な場合に移行ステータスを更新する内部関数です。 UpdateMigrationStatus [[-FolderPath] <String>] [[-State] <String>] [[-Title] <String>] [[Message] <String>] [[-Category] <String>] [[-Payload] <Object>] [<CommonParameters>] UpdateMissingExtensions UpdateMissingExtensions [[-FolderPath] <string>] [[-Json] <Object>] Update-WACEnvironment Windows Admin Center 環境を V1 から V2 に更新します。 Update-WACEnvironment [-SkipSettings] [-SkipDatabase] [-NonInteractive] [-Force] [<CommonParameters>]  以上の確認結果から、内部関数が多いように思われます。 2025/03/15 24

25.

Migration関連コマンドレット(6/9)  Microsoft.WindowsAdminCenter.Migrationモジュール含まれる27個のコマンドレットのうち、いつ くかを確認いたしました。  Microsoft.WindowsAdminCenter.Migrationモジュールは、あらかじめインポートします。  Export-WACDatabaseは、-Pathオプションにおいてファイル名を含めたフルパスを指定したほうがわか りやすいです。  ファイル名の省略や相対パス指定だと、ファイルがユーザープロファイル直下に保存されますのでご注意ください。 下記の例だとカレントフォルダーには保存されていません。 2025/03/15 25

26.

Migration関連コマンドレット(7/9)  エクスポートしたファイル名を指定して、Import-WACDatabaseを実行した結果、リセットとの表示を得 ました。  なお先に拡張をアンインストールしておいてから、Import-WACDatabaseを実行しておりました。が拡 張の状態が復元されなかったことも申し添えます。 2025/03/15 26

27.

Migration関連コマンドレット(8/9)  Export-WACExtensionsは、-Pathオプションなしでも実行可能でした。  Extensions.jsonとしてファイルが現在のフォルダーへ保存されましたので、一覧のエクスポートと考えるの が良さそうです。 2025/03/15 27

28.

Migration関連コマンドレット(9/9)  Export-WACExtensionsによりExtensions.jsonとしてファイルを保存しておりました。その状態で、 Active Directory拡張をアンインストールしました。  その後、Import-WACExtensionsを実行し、拡張が復元されるかを確認してみました。  結果は、そういう挙動とはならずにActive Directory拡張はアンインストールのままでした。Windows Admin Centerのサービスを再起動しても状態としては変わりませんでした。 2025/03/15 28

29.

PowerShellTools関連コマンドレット  Microsoft.WindowsAdminCenter.PowerShellToolsモジュールには、コマンドレットが1つのみです。 コマンドレット名 概要と構文 Export-WACDscPackage DSC JEA パッケージをエクスポートします。 Export-WACDscPackage [-Endpoint] <Uri> [-FilePath] <String> [[-Credentials] <PSCredential>] [[-AccessKey] <String>] [<CommonParameters>]  Microsoft.WindowsAdminCenter.PowerShellToolsモジュールは、あらかじめインポートします。  実行方法は誤っていないと考えていますが、確認結果はAccessKeyを入力する前にエラーとなりました。 2025/03/15 29

30.

まとめ  大事なので改めてお伝えしますが、設定からインストールウィザードは再実行出来ません。   インストール時のパラメーター変更は、 Microsoft.WindowsAdminCenter.ConfigurationのPowerShell コマンドレットで行います。 WAC 2410のPowerShellコマンドレットは、下記の3つを主に使用すると理解ください。  Microsoft.WindowsAdminCenter.Configuration  Microsoft.WindowsAdminCenter.ConnectionTools  Microsoft.WindowsAdminCenter.ExtensionTools 2025/03/15 30

31.

参考情報(1/2)  Windows Admin Center のリリース履歴 https://learn.microsoft.com/ja-jp/windows-server/manage/windows-admincenter/support/release-history  Windows Admin Center version 2410 is now generally available! https://techcommunity.microsoft.com/blog/windows-admin-centerblog/windows-admin-center-version-2410-is-now-generally-available/4356534  Update the certificate used by Windows Admin Center https://learn.microsoft.com/en-us/windows-server/manage/windows-admincenter/configure/update-certificate?tabs=powershell  Mandatory AccessKey parameter for Import-WACConnection Powershell cmdlet in 2410 https://techcommunity.microsoft.com/discussions/windowsservermanagement/m andatory-accesskey-parameter-for-import-wacconnection-powershell-cmdlet-in2410/4372258 2025/03/15 31

32.

参考情報(2/2)  カスタムセットアップと接続に関連するコマンドレットは、詳細を下記資料に記載をしておりますのでそちらを ご確認ください。   Windows Admin Center 2410 その2 https://www.docswell.com/s /sshzk/ZYDLDV-2025-03-15-144918 拙作記事  https://atmarkit.itmedia.co.jp /ait/articles /2502/05/news009.html  https://atmarkit.itmedia.co.jp /ait/articles /2503/08/news002.html  https://atmarkit.itmedia.co.jp /ait/articles /2504/07/news008.html  https://atmarkit.itmedia.co.jp /ait/articles /2505/09/news007.html  https://atmarkit.itmedia.co.jp /ait/articles /2506/17/news005.html  https://atmarkit.itmedia.co.jp /ait/articles /2507/07/news012.html  https://atmarkit.itmedia.co.jp /ait/articles /2509/10/news004.html 2025/03/15 32