Installare il modulo SQL Server PowerShell
Si applica a:SQL ServerDatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsPiattaforma di strumenti analitici (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.
Nota
Le versioni del modulo SqlServer disponibili in PowerShell Gallery supportano il controllo delle versioni e richiedono PowerShell 5.1 o versioni successive.
- 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:
Nota
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à stato installato e l'altro viene installato o aggiornato. Per evitare questo conflitto, è possibile usare il parametro -AllowClobber durante l'installazione o l'aggiornamento del modulo. Inoltre, quando si importa un modulo, è necessario rimuovere prima l'altro modulo o usare il parametro -DisableNameChecking per evitare errori. Queste misure assicurano che i moduli possano coesistere senza causare problemi.
SQL Server Management Studio
Scaricare 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
Se Windows PowerShell è in esecuzione, è 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 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).
Sul 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 di tua preferenze come destinazione sul computer connesso a Internet.Save-Module -Name SqlServer -Path $env:TEMP
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\
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.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. L’ultima versione viene installata affiancata per consentire di provare l’ultima versione 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 Core.
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
Contenuto correlato
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per