SQL Server PowerShell モジュールのインストールInstall SQL Server PowerShell module

適用対象: ○SQL Server ○Azure SQL Database ○Azure SQL Data Warehouse ○Parallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

この記事は、SqlServer PowerShell モジュールをインストールする手順を説明しています。This article provides directions for installing the SqlServer PowerShell module.

注意

SQL Server PowerShell モジュールには SqlServerSQLPS の 2 つがあります。There are two SQL Server PowerShell modules; SqlServer and SQLPS. SQLPS モジュールは (後方互換性のため) SQL Server のインストールに含まれていますが、今後更新されることはありません。The SQLPS module is included with the SQL Server installation (for backwards compatibility), but is no longer being updated. 最新の PowerShell モジュールは SqlServer モジュールです。The most up-to-date PowerShell module is the SqlServer module. SqlServer モジュールには SQLPS のコマンドレットの更新バージョンだけでなく、最新の SQL 機能をサポートする新しいコマンドレットも含まれています。The SqlServer module contains updated versions of the cmdlets in SQLPS, and also includes new cmdlets to support the latest SQL features. SQL Server Management Studio (SSMS) には前のバージョンの SqlServer が含まれていましたが、SSMS の 16.x バージョンのみです。Previous versions of the SqlServer module were included with SQL Server Management Studio (SSMS), but only with the 16.x versions of SSMS. PowerShell を SSMS 17.0 以降で使用するには、SqlServer モジュールを PowerShell ギャラリーからインストールする必要があります。To use PowerShell with SSMS 17.0 and later, the SqlServer module must be installed from the PowerShell Gallery.

PowerShell ギャラリーから SqlServer モジュールをインストールするには、PowerShell セッションを開始し、次のコマンドを使用します。To install the SqlServer module from the PowerShell Gallery, start a PowerShell session and use the following commands. インストールに問題が発生した場合は、Install-module のドキュメントInstall-Module の参照をご覧ください。If you run into problems installing, see the Install-Module documentation and Install-Module reference.

SqlServer モジュールをインストールするには:To install the SqlServer module:

Install-Module -Name SqlServer

以前のバージョンの SqlServer モジュールがコンピューター上にある場合、Update-Module (この記事で後述) を使用できる、または -AllowClobber パラメーターを指定できる場合があります。If there are previous versions of the SqlServer module on the computer, you may be able to use Update-Module (later in this article), or provide the -AllowClobber parameter:

Install-Module -Name SqlServer -AllowClobber

管理者として PowerShell セッションを実行できない場合は、次のようにして現在のユーザーにインストールできます。If you are not able to run the PowerShell session as administrator, you can install for the current user:

Install-Module -Name SqlServer -Scope CurrentUser

SqlServer モジュールの更新バージョンがある場合、Update-Module を使用してバージョンを更新できます。When updated versions of the SqlServer module are available, you can update the version using Update-Module:

Update-Module -Name SqlServer

インストールされているモジュールのバージョンを表示する場合:To view the versions of the module installed:

Get-Module SqlServer -ListAvailable

モジュールの特定のバージョンを使用するには、次のような特定のバージョン番号でインポートできます。To use a specific version of the module, you can import it with a specific version number similar to the following:

Import-Module SqlServer -Version 21.0.17178

PowerShell ギャラリーの SqlServer モジュールのバージョンは、バージョン管理をサポートし、PowerShell バージョン 5.0 以降が必要です。The versions of the SqlServer module in the PowerShell Gallery support versioning and require PowerShell version 5.0 or greater.