Installare il modulo SQL Server PowerShell

Si applica a:SQL Serverdatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)

Questo articolo include indicazioni per l'installazione del modulo PowerShell SqlServer.

Moduli PowerShell per SQL Server

Esistono due moduli SQL Server PowerShell:

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

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

Nota

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

Per gli argomenti della Guida, vedere:

SQL Server Management Studio

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

Nota

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

Azure Data Studio

Azure Data Studio non installa nessuno dei due moduli di PowerShell. Per usare PowerShell con Azure Data Studio, installare il modulo SqlServer da PowerShell Gallery.

È possibile usare l'estensione di PowerShell, che offre supporto avanzato per l'editor 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

In Windows PowerShell è possibile usare Install-Module SQLServer -Scope CurrentUser per installare il modulo solo 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 su un computer offline

Questa sezione illustra i passaggi dell'installazione del modulo SqlServer PowerShell su un computer che non ha accesso a Internet. Sono necessari due computer per eseguire questa installazione: un computer connesso a Internet e il computer di destinazione offline (non connesso a Internet).

  1. Sul computer connesso a Internet scaricare il modulo SQLServer PowerShell. Questo comando scaricherà e salverà tutti i file per il modulo nella cartella di esempio $env:TEMP\SQLServer\<SomeVersion>, definita nel parametro -Path . È possibile scegliere una cartella di tua preferenze come destinazione sul computer connesso a Internet.

    Save-Module -Name SqlServer -Path $env:TEMP
    
  2. Cercare la posizione della cartella in Esplora file per verificare l'esistenza di una cartella $env:TEMP\SQLServer\<SomeVersion> oppure eseguire questo comando:

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

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

    Get-Module SqlServer -ListAvailable
    

    L'output potrebbe essere simile al seguente (la versione effettiva può essere diversa e deve corrispondere a <SomeVersion> elencato 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 installate

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

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 comando Install-Module per sovrascrivere una versione precedente.

Install-Module -Name SqlServer -AllowClobber

Nota

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 comando Update-Module per installare la versione più recente del modulo SQLServer di PowerShell, ma le versioni precedenti non vengono rimosse. La versione più recente viene installata affiancata per consentire di provare la versione più recente e mantenere installati i moduli precedenti.

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

È possibile usare il comando seguente per verificare se è installata più di una versione:

Get-Module SqlServer -ListAvailable

Per rimuovere le versioni precedenti, è possibile usare il comando seguente:

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

Risoluzione dei problemi

Se si verificano problemi durante l'installazione, vedere la documentazione per l'installazione del modulo e la guida di riferimento per l'installazione del modulo.

Usare una versione specifica del modulo SqlServer

Per usare una versione specifica del modulo, importarlo con un numero di versione specifico con il comando seguente:

Import-Module SqlServer -Version 21.1.18218

Versioni non definitive del modulo SqlServer

Versioni non definitive (o di "anteprima") del modulo SqlServer possono essere disponibili in PowerShell Gallery.

Importante

Queste versioni possono essere individuate e installate usando i cmdlet aggiornati Find-Module e Install-Module inclusi nel modulo PowerShellGet passando l'opzione -AllowPrerelease. Per usare questi cmdlet, installare il modulo PowerShellGet, quindi aprire una nuova sessione.

Individuare le versioni non definitive del modulo SqlServer

Per individuare la versione non definitiva (anteprima) del modulo SqlServer, eseguire il comando seguente:

Find-Module SqlServer -AllowPrerelease

Installare una specifica versione non definitiva del modulo SqlServer

Per installare una specifica versione non definitiva 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

Per informazioni su come installare SQL Server PowerShell in Linux, vedere Gestire SQL Server in Linux con PowerShell.

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

Passaggi successivi