sqlps - utilitàsqlps Utility

L'utilità sqlps avvia una sessione di Windows PowerShell con il provider SQL ServerSQL Server PowerShell e i cmdlet caricati e registrati.The sqlps utility starts a Windows PowerShell session with the SQL ServerSQL Server PowerShell provider and cmdlets loaded and registered. È possibile immettere comandi o script di PowerShell che utilizzano componenti di PowerShell per SQL ServerSQL Server per utilizzare istanze di SQL ServerSQL Server e i relativi oggetti.You can enter PowerShell commands or scripts that use the SQL ServerSQL Server PowerShell components to work with instances of SQL ServerSQL Server and their objects.

Importante

Questa funzionalità verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server.This feature will be removed in a future version of Microsoft SQL Server. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.Avoid using this feature in new development work, and plan to modify applications that currently use this feature.Utilizzare il sqlps modulo PowerShell invece. Use the sqlps PowerShell module instead. Per altre informazioni sul modulo sqlps , vedere Import the SQLPS Module.For more information about the sqlps module, see Import the SQLPS Module.

SintassiSyntax


sqlps   
[ [ [ -NoLogo ][ -NoExit ][ -NoProfile ]  
    [ -OutPutFormat { Text | XML } ] [ -InPutFormat { Text | XML } ]  
  ]  
  [ -Command { -  
             | script_block [ -args argument_array ]  
             | string [ command_parameters ]  
             }  
  ]  
]  
[ -? | -Help ]  

ArgomentiArguments

-NoLogo-NoLogo
Specifica che l'utilità sqlps deve nascondere le informazioni sul copyright all'avvio.Specifies that the sqlps utility hide the copyright banner when it starts.

-NoExit-NoExit
Specifica che l'esecuzione dell'utilità sqlps deve proseguire una volta completati i comandi di avvio.Specifies that the sqlps utility continue running after the startup commands have completed.

-NoProfile-NoProfile
Specifica che l'utilità sqlps non deve caricare un profilo utente.Specifies that the sqlps utility not load a user profile. I profili utente registrano alias, funzioni e variabili di uso comune per l'utilizzo nelle sessioni di PowerShell.User profiles record commonly used aliases, functions, and variables for use across PowerShell sessions.

-OutPutFormat { Text | XML }-OutPutFormat { Text | XML }
Specifica che l'output dell'utilità sqlps deve essere formattato come stringhe di testo (Text) o in un formato CLIXML serializzato (XML).Specifies that the sqlps utility output be formatted as either text strings (Text) or in a serialized CLIXML format (XML).

-InPutFormat { Text | XML }-InPutFormat { Text | XML }
Specifica che l'input dell'utilità sqlps deve essere formattato come stringhe di testo (Text) o in un formato CLIXML serializzato (XML).Specifies that input to the sqlps utility is formatted as either text strings (Text) or in a serialized CLIXML format (XML).

-Command-Command
Specifica il comando per l'esecuzione dell'utilità sqlps .Specifies the command for the sqlps utility to run. L'utilità sqlps esegue il comando e quindi viene chiusa, a meno che non si specifichi anche -NoExit .The sqlps utility runs the command and then exits, unless -NoExit is also specified. Non specificare altre opzioni dopo -Command, in quanto verranno lette come parametri del comando.Do not specify any other switches after -Command, they will be read as command parameters.


-Command- specifica che l'utilità sqlps deve leggere l'input dall'input standard.-Command- specifies that the sqlps utility read the input from the standard input.

script_block [ -argsargument_array ]script_block [ -argsargument_array ]
Specifica un blocco di comandi di PowerShell da eseguire. Il blocco deve essere incluso in parentesi graffe: {}.Specifies a block of PowerShell commands to run, the block must be enclosed in braces: {}. È possibile specificareScript_block solo quando l'utilità sqlps viene chiamata da PowerShell o da un'altra sessione dell'utilità sqlps .Script_block can only be specified when the sqlps utility is called from either PowerShell or another sqlps utility session. argument_array è una matrice di variabili PowerShell che contiene gli argomenti per i comandi di PowerShell in script_block.The argument_array is an array of PowerShell variables containing the arguments for the PowerShell commands in the script_block.

string [ command_parameters ]string [ command_parameters ]
Specifica una stringa che contiene i comandi di PowerShell da eseguire.Specifies a string that contains the PowerShell commands to be run. Usare il formato "&{command}".Use the format "&{command}". Le virgolette indicano una stringa e l'operatore invoke (&) determina l'esecuzione del comando da parte dell'utilità sqlps.The quotation marks indicate a string, and the invoke operator (&) causes the sqlps utility to run the command.

[ -?[ -? | -Help ] | -Help ]
Visualizza il riepilogo della sintassi delle opzioni dell'utilità sqlps .Shows the syntax summary of the sqlps utility options.

OsservazioniRemarks

L'utilità sqlps avvia l'ambiente PowerShell (PowerShell.exe) e carica il modulo di PowerShell per SQL ServerSQL Server .The sqlps utility starts the PowerShell environment (PowerShell.exe) and loads the SQL ServerSQL Server PowerShell module. Il modulo, denominato anche sqlps, carica e registra gli snap-in di PowerShell per SQL ServerSQL Server seguenti:The module, also named sqlps, loads and registers these SQL ServerSQL Server PowerShell snap-ins:

  • Microsoft.SqlServer.Management.PSProvider.dllMicrosoft.SqlServer.Management.PSProvider.dll

    Implementa il provider PowerShell per SQL ServerSQL Server e i cmdlet associati, ad esempio Encode-SqlName e Decode-SqlName.Implements the SQL ServerSQL Server PowerShell provider and associated cmdlets such as Encode-SqlName and Decode-SqlName.

  • Microsoft.SqlServer.Management.PSSnapin.dllMicrosoft.SqlServer.Management.PSSnapin.dll

    Implementa i cmdlet Invoke-Sqlcmd e Invoke-PolicyEvaluation .Implements the Invoke-Sqlcmd and Invoke-PolicyEvaluation cmdlets.

    È possibile usare l'utilità sqlps per le operazioni seguenti:You can use the sqlps utility to do the following:

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

  • Eseguire file script di PowerShell.Run 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.

    Per impostazione predefinita, l'utilità sqlps viene eseguita con i criteri di esecuzione degli script impostati su Con restrizioni.By default, the sqlps utility runs with the scripting execution policy set to Restricted. Questa impostazione impedisce l'esecuzione di qualsiasi script di PowerShell.This prevents running any PowerShell scripts. Per abilitare l'esecuzione di script firmati o di qualsiasi script, è possibile usare il cmdlet Set-ExecutionPolicy .You can use the Set-ExecutionPolicy cmdlet to enable running signed scripts, or any scripts. Eseguire solo script provenienti da origini attendibili e proteggere tutti i file di input e di output utilizzando le autorizzazioni NTFS appropriate.Only run scripts from trusted sources, and secure all input and output files by using the appropriate NTFS permissions. Per ulteriori informazioni sull'abilitazione degli script di PowerShell, vedere la pagina relativa all' esecuzione di script di Windows PowerShell.For more information about enabling PowerShell scripts, see Running Windows PowerShell Scripts.

    La versione dell'utilità sqlps in SQL Server 2008SQL Server 2008 e SQL Server 2008 R2SQL Server 2008 R2 viene implementata come minishell di Windows PowerShell 1.0.The version of the sqlps utility in SQL Server 2008SQL Server 2008 and SQL Server 2008 R2SQL Server 2008 R2 was implemented as a Windows PowerShell 1.0 mini-shell. Alle minishell si applicano alcune restrizioni, ad esempio agli utenti non è consentito caricare snap-in diversi da quelli caricati dalla minishell.Mini-shells have certain restrictions, such as not allowing users to load snap-ins other than those loaded by the mini-shell. Queste restrizioni non si applicano a SQL Server 2012SQL Server 2012 e versioni successive dell'utilità, modificate per utilizzare il modulo sqlps .These restrictions do not apply to the SQL Server 2012SQL Server 2012 and higher versions of the utility, which have been changed to use the sqlps module.

EsempiExamples

A. Eseguire l'utilità sqlps in predefinito, la modalità interattiva, senza le informazioni sul copyrightA. Run the sqlps utility in default, interactive mode without the copyright banner

sqlps -NoLogo  

B. Eseguire uno script di PowerShell per SQL Server dal prompt dei comandiB. Run a SQL Server PowerShell script from the command prompt

sqlps -Command "&{.\MyFolder.MyScript.ps1}"  

C. Eseguire uno script di PowerShell per SQL Server dal prompt dei comandi e proseguimento dell'esecuzione dopo il completamento dello scriptC. Run a SQL Server PowerShell script from the command prompt, and keep running after the script completes

sqlps -NoExit -Command "&{.\MyFolder.MyScript.ps1}"  

Vedere ancheSee Also

Abilitare o disabilitare un protocollo di rete del server Enable or Disable a Server Network Protocol
SQL Server PowerShellSQL Server PowerShell