Importare il modulo SQLPSImport the SQLPS Module

Il metodo consigliato per gestire SQL ServerSQL Server da PowerShell consiste nell'importare il modulo sqlps in un ambiente Windows PowerShell.The recommended way to manage SQL ServerSQL Server from PowerShell is to import the sqlps module into a Windows PowerShell environment. Il modulo carica e registra gli snap-in e gli assembly di gestibilità di SQL ServerSQL Server .The module loads and registers the SQL ServerSQL Server snap-ins and manageability assemblies. A partire da Windows PowerShell 3.0, i moduli vengono importati automaticamente quando un cmdlet o una funzione nel modulo viene usato in un comando.Beginning in Windows PowerShell 3.0, modules are imported automatically when any cmdlet or function in the module is used in a command. Questa funzionalità può essere usata in tutti i moduli di una directory inclusi nel valore della variabile di ambiente PSModulePath.This feature works on any module in a directory that this included in the value of the PSModulePath environment variable. Per altre informazioni, vedere Importing a PowerShell Module (Importazione di un modulo di PowerShell)For additional information, see Importing a PowerShell Module

  1. Before You Begin: SecurityBefore You Begin: Security

  2. To load the module: Load the sqlps ModuleTo load the module: Load the sqlps Module

Prima di iniziareBefore You Begin

Dopo avere importato il modulo sqlps in Windows PowerShell, è quindi possibile:After importing the sqlps module into Windows PowerShell, you can then:

  • Eseguire in modo interattivo comandi di Windows PowerShell.Interactively run Windows PowerShell commands.

  • Eseguire file script di Windows PowerShell.Run Windows PowerShell script files.

  • Eseguire cmdlet di SQL ServerSQL Server .Run SQL ServerSQL Server cmdlets.

  • Utilizzare i percorsi del provider di SQL ServerSQL Server per spostarsi nella gerarchia degli oggetti di SQL ServerSQL Server .Use the SQL ServerSQL Server provider paths to navigate through the hierarchy of SQL ServerSQL Server objects.

  • Utilizzare i modelli a oggetti per la gestibilità di SQL ServerSQL Server , ad esempio Microsoft.SqlServer.Management.Smo, per gestire oggetti di SQL ServerSQL Server .Use the SQL ServerSQL Server manageability object models (such as Microsoft.SqlServer.Management.Smo) to manage SQL ServerSQL Server objects.

Nota

I verbi usati nei nomi di due cmdlet di SQL Server (Encode-Sqlname e Decode-Sqlname) non corrispondono ai verbi approvati per Windows PowerShell.The verbs used in the names of two SQL Server cmdlets (Encode-Sqlname and Decode-Sqlname) do not match the approved verbs for Windows PowerShell. Ciò non ha effetto sull'operazione, tuttavia Windows PowerShell genera un avviso quando il modulo sqlps viene importato in una sessione.This has no effect on their operation, but Windows PowerShell raises a warning when the sqlps module is imported to a session.

Sicurezza Security

Per impostazione predefinita, Windows PowerShell viene eseguito con i criteri di esecuzione degli script impostati su Restricted, che impediscono l'esecuzione degli script di Windows PowerShell.By default, Windows PowerShell runs with the scripting execution policy set to Restricted, which prevents running any Windows PowerShell scripts. Per caricare il modulo sqlps , è possibile usare il cmdlet Set-ExecutionPolicy che consente di abilitare l'esecuzione di script firmati o di qualsiasi script.To load the sqlps module, you can use the Set-ExecutionPolicy cmdlet to enable running signed scripts, or any scripts. Eseguire solo script da origini attendibili e proteggere tutti i file di input e output utilizzando le autorizzazioni NTFS appropriate.Only run scripts from trusted sources, and secure all input and output files using the appropriate NTFS permissions. Per altre informazioni sull'abilitazione degli script di Windows PowerShell, vedere Running Windows PowerShell Scripts(Esecuzione di script di Windows PowerShell).For more information about enabling Windows PowerShell scripts, see Running Windows PowerShell Scripts.

Caricare il Modulo sqlps Load the sqlps Module

Per caricare il modulo sqlps in Windows PowerShellTo load the sqlps module in Windows PowerShell

  1. Usare il cmdlet Set-ExecutionPolicy per impostare i criteri di esecuzione degli script appropriati.Use the Set-ExecutionPolicy cmdlet to set the appropriate script execution policy.

  2. Usare il cmdlet Import-Module per importare il modulo sqlps.Use the Import-Module cmdlet to import the sqlps module. Specificare il parametro DisableNameChecking per eliminare l'avviso su Encode-Sqlname e Decode-Sqlname.Specify the DisableNameChecking parameter if you want to suppress the warning about Encode-Sqlname and Decode-Sqlname.

EsempioExample

In questo esempio viene caricato il modulo sqlps con verifica del nome disabilitata.This example loads the sqlps module with name checking turned off.

# Import the SQL Server Module.    
Import-Module Sqlps -DisableNameChecking;

# To check whether the module is installed.
Get-Module -ListAvailable -Name Sqlps;
Nota

Se il modulo sqlps non è presente nel percorso, cambiare il percorso del modulo o usare il percorso completo nello script, racchiudendo tra virgolette i nomi di cartella del percorso se contengono spazi.If the sqlps module is not in your path, change to the location of the module or use the full path in the script (using double-quotes of folders in your path have spaces). Il modulo sqlps si trova nella cartella Tools\Powershell dell'istanza di SQL Server.The sqlps module is located in the Tools\Powershell folder for your SQL Server instance.

Icona freccia usata con il collegamento Torna all'inizio [Torna all'inizio]Arrow icon used with Back to Top link [Top]

Vedere ancheSee Also

SQL Server PowerShell SQL Server PowerShell
Provider PowerShell per SQL Server SQL Server PowerShell Provider
Utilizzo di cmdlet del motore di database Use the Database Engine cmdlets
Installazione di un modulo di PowerShell Installing a PowerShell Module
Import-Module Import-Module