Condividi tramite

Installare il modulo PowerShell di SQL Server

Questo articolo fornisce istruzioni per l'installazione del modulo SqlServer PowerShell.

Moduli di PowerShell per SQL Server

Sono disponibili due moduli di SQL Server PowerShell:

  • SqlServer: il modulo SqlServer include nuovi cmdlet per supportare le funzionalità SQL più recenti. Il modulo contiene anche versioni aggiornate dei cmdlet in SQLPS. Per scaricare il modulo SqlServer, passare al modulo SqlServer in PowerShell Gallery.

Annotazioni

Le versioni del modulo SqlServer in PowerShell Gallery supportano il controllo delle versioni e richiedono PowerShell versione 5.1 o successiva.

  • SQLPS: SQLPS è il modulo usato da SQL Agent per eseguire i processi dell'agente nei passaggi del processo dell'agente usando il sottosistema PowerShell.

Per gli articoli della Guida, vedere:

Annotazioni

Nel contesto dei moduli SqlServer e SQLPS, è possibile che alcuni nomi di comando esistano in entrambi i moduli.

Ciò può creare un conflitto quando un modulo è già installato e l'altro viene installato o aggiornato. Il parametro -AllowClobber può essere usato per evitare questo conflitto durante l'installazione o l'aggiornamento del modulo. Inoltre, quando si importa un modulo, rimuovere prima l'altro modulo o usare il parametro -DisableNameChecking per evitare che sia necessario un errore. Queste misure assicurano che i moduli possano coesistere senza causare problemi.

SQL Server Management Studio (SSMS)

SQL Server Management Studio (SSMS) non installa alcun modulo di PowerShell. Per usare PowerShell con SSMS, installare il modulo SqlServer da PowerShell Gallery.

Annotazioni

SQL Server Management Studio (SSMS) 16.x (e versioni precedenti) includeva il modulo SQLPS .

Azure Data Studio

Azure Data Studio non installa alcun modulo di PowerShell. Per usare PowerShell con Azure Data Studio, installare il modulo SqlServer da PowerShell Gallery.

È possibile usare il supporto dell'editor di PowerShell per Azure Data Studio, che offre supporto avanzato per l'editor di PowerShell in Azure Data Studio.

Installare o aggiornare il modulo SqlServer

Per installare il modulo SqlServer da PowerShell Gallery, avviare una sessione di PowerShell ed eseguire Install-Module SQLServer.

Install-Module -Name SqlServer

Se è in esecuzione in Windows PowerShell, è possibile usare Install-Module SQLServer -Scope CurrentUser per installare il modulo per l'utente corrente ed evitare la necessità di autorizzazioni elevate.

Installare il modulo SqlServer per tutti gli utenti

Per installare il modulo SqlServer per tutti gli utenti, eseguire il comando seguente in una sessione di PowerShell con privilegi elevati; avviare una sessione di PowerShell come amministratore:

Install-Module -Name SqlServer

Installare il modulo SqlServer in un computer offline

Questa sezione illustra i passaggi dell'installazione del modulo SqlServer PowerShell in un computer senza accesso a Internet. Per eseguire questa installazione sono necessari due computer: un computer connesso a Internet e un computer di destinazione offline.

  1. In un computer connesso a Internet scaricare il modulo SQLServer PowerShell. Questo comando scarica e salva tutti i file per il modulo nella cartella di esempio $env:TEMP\SQLServer\<SomeVersion> , definita nel parametro -Path . È possibile scegliere una cartella delle preferenze come destinazione nel computer connesso a Internet.

    Save-Module -Name SqlServer -Path $env:TEMP

  2. Passare al percorso della cartella in Esplora file per verificare che una $env:TEMP\SQLServer\<SomeVersion> cartella esista o eseguire questo comando:

    Get-ChildItem -Path $env:TEMP\SQLServer\

  3. Copiare la $env:TEMP\SQLServer\<SomeVersion> cartella trovata nel passaggio 2 nel computer offline di destinazione nella %ProgramFiles%\WindowsPowerShell\Modules\SqlServer cartella (questa cartella funziona sia per PS5 che per PS7). Assicurarsi di sostituire <SomeVersion> con il valore trovato nel passaggio precedente.

  4. Verificare che il modulo SqlServer PowerShell sia disponibile nel computer offline eseguendo il cmdlet di PowerShell seguente:

    Get-Module SqlServer -ListAvailable

    L'output potrebbe essere simile al seguente (la versione effettiva potrebbe essere diversa e deve corrispondere <SomeVersion> a quella elencata in precedenza):

       PS C:\Users\user1> Get-Module SqlServer -ListAvailable

       Directory: C:\Program Files\WindowsPowerShell\Modules

   ModuleType Version    Name                     ExportedCommands
   ---------- -------    ----                     ----------------
   Script     22.1.1     SqlServer                {Add-RoleMember, Add-SqlAvail...

Visualizzare le versioni del modulo SqlServer installato

Eseguire il comando seguente per visualizzare le versioni installate del modulo SqlServer.

Get-Module SqlServer -ListAvailable

Per visualizzare la versione del modulo SqlServer caricato nella sessione corrente

(Get-Module SqlServer).Version

Sovrascrivere una versione precedente del modulo SqlServer

È anche possibile usare il Install-Module comando per sovrascrivere una versione precedente.

Install-Module -Name SqlServer -AllowClobber

Annotazioni

PowerShell usa sempre il modulo più recente installato.

Aggiornare la versione installata del modulo SqlServer

Quando sono disponibili versioni aggiornate del modulo SqlServer , è possibile installare la versione più recente usando il comando seguente:

Update-Module -Name SqlServer -AllowClobber

È possibile usare il Update-Module comando per installare la versione più recente del modulo SQLServer PowerShell, ma non rimuove le versioni precedenti. Installa le versioni più recenti side-by-side per consentire di sperimentare con la versione più recente pur avendo ancora installato moduli meno recenti.

Tuttavia, se non si vogliono mantenere le versioni precedenti del modulo, è possibile usare il Uninstall-Module comando per rimuovere le versioni precedenti.

È possibile usare il comando seguente per elencare se sono installate più versioni:

Get-Module SqlServer -ListAvailable

È possibile usare il comando seguente per rimuovere le versioni precedenti:

Uninstall-module -Name SQLServer -RequiredVersion "<version number>"

Risoluzione dei Problemi

Se si verificano problemi durante l'installazione, vedere la documentazione diInstall-Module e Install-Module informazioni di riferimento.

Usare una versione specifica del modulo SqlServer

Per usare una versione specifica del modulo, importarla con un numero di versione specifico simile al comando seguente:

Import-Module SqlServer -Version 21.1.18218

Versioni non definitive del modulo SqlServer

Le versioni non definitive (o "anteprima") del modulo SqlServer potrebbero essere disponibili in PowerShell Gallery.

Importante

Queste versioni potrebbero essere individuate e installate usando i cmdlet Find-Module e Install-Module aggiornati che fanno parte del modulo PowerShellGet passando l'opzione -AllowPrerelease . Per usare questi cmdlet, installare il modulo PowerShellGet e aprire una nuova sessione.

Individuare le versioni non definitive del modulo SqlServer

Per individuare le versioni non definitive (anteprima) del modulo SqlServer, eseguire il comando seguente:

Find-Module SqlServer -AllowPrerelease

Installare una versione non definitiva specifica del modulo SqlServer

Per installare una versione non definitiva specifica del modulo, installarla con un numero di versione specifico.

È possibile provare a usare il comando seguente:

Install-Module SqlServer -RequiredVersion 21.1.18218-preview -AllowPrerelease

SQL Server PowerShell in Linux

Visitare /sql/linux/sql-server-linux-manage-powershell-core per informazioni su come installare SQL Server PowerShell in Linux.

Altri moduli

  • Az.Sql - Cmdlet del servizio SQL per Azure Resource Manager in Windows PowerShell e PowerShell.

  • SqlServerDsc : modulo con risorse DSC per la distribuzione e la configurazione di Microsoft SQL Server.

Informazioni di riferimento sui cmdlet

Contenuti correlati