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.

注意

2 つの SQL Server PowerShell モジュールがあります。There are two SQL Server PowerShell modules:

  • SQLPS: このモジュールは (後方互換性のため) SQL Server のインストールに含まれていますが、今後更新されることはありません。SQLPS: This 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: このモジュールには、最新の SQL 機能をサポートする新しいコマンドレットが含まれています。SqlServer: This module includes new cmdlets to support the latest SQL features. モジュールには、SQLPS 内のコマンドレットの更新バージョンも含まれています。The module also contains updated versions of the cmdlets in SQLPS.

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. SqlServer モジュールの現在のバージョンは 21.1.18080 です。The current version of the SqlServer module is 21.1.18080. これは、Microsoft.SQLServer.SMO のバージョン v150 に基づいており、SQL Server の次のバージョンをサポートします。This is based on version v150 of Microsoft.SQLServer.SMO and supports the next version of SQL Server. Microsoft.SQLServer.SMO のバージョン v140 に基づくモジュールの最後のバージョンは、21.0.17279 です。The last version of the module based on version v140 of Microsoft.SQLServer.SMO) is 21.0.17279.

モジュールのプレリリース版は、より頻繁に利用できるようになる可能性があります。モジュールのこのようなバージョンを取得する方法については、このページの下部のセクションを参照してください。Pre-release versions of the module may become available more frequently: please refer to the section at the bottom of this page on how to get such versions of the module.

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.1.18080

注意

モジュールのプレリリース ("プレビュー") バージョンは、PowerShell ギャラリーで入手できます。Prerelease (or "preview") versions of the module may be available on the PowerShell Gallery. PowerShellGet モジュール) の一部である、更新された Find-Module コマンドレットと Install-Module コマンドレットを使用して -AllowPrerelease スイッチを渡すことで、これらを検出してインストールできます。They may be discovered and installed by using the updated Find-Module and Install-Module cmdlets that are part of the PowerShellGet module) by passing the -AllowPrerelease switch.

モジュールのプレリリース/プレビュー バージョンを検出するには、次のコマンドを実行できます。To discover the prerelease/preview version of the module, you can run the following command:

Find-Module SqlServer -AllowPrerelease

モジュールの特定のプレリリース/プレビュー バージョンをインストールするには、次のような特定のバージョン番号でインストールできます。To install a specific prerelease/preview version of the module, you can install it with a specific version number similar to the following:

Install-Module SqlServer -RequiredVersion 21.1.18040-preview -AllowPrerelease

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.