sqlps, utilidadsqlps Utility

En este tema se aplica a: SíSQL ServerSíbase de datos de SQL AzureSíalmacenamiento de datos de SQL Azure Sí Almacenamiento de datos paralelosTHIS TOPIC APPLIES TO: yesSQL ServeryesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse El sqlps utilidad inicia una sesión de Windows PowerShell con la SQL ServerSQL Server proveedor de PowerShell y los cmdlets cargados y registrados. The sqlps utility starts a Windows PowerShell session with the SQL ServerSQL Server PowerShell provider and cmdlets loaded and registered. Puede escribir scripts o comandos de PowerShell que usen los componentes de SQL ServerSQL Server PowerShell para trabajar con instancias de SQL ServerSQL Server y sus objetos.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

Esta característica se quitará en una versión futura de Microsoft SQL Server.This feature will be removed in a future version of Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.Avoid using this feature in new development work, and plan to modify applications that currently use this feature.Use la sqlps módulo de PowerShell en su lugar. Use the sqlps PowerShell module instead. Para más información acerca del módulo sqlps , consulte Import the SQLPS Module.For more information about the sqlps module, see Import the SQLPS Module.

SintaxisSyntax


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

ArgumentosArguments

-NoLogo-NoLogo
Especifica que la utilidad sqlps debe ocultar el título de copyright cuando se inicia.Specifies that the sqlps utility hide the copyright banner when it starts.

-NoExit-NoExit
Especifica que la utilidad sqlps debe seguir ejecutándose después de que los comandos de inicio se hayan completado.Specifies that the sqlps utility continue running after the startup commands have completed.

-NoProfile-NoProfile
Especifica que la utilidad sqlps no debe cargar un perfil de usuario.Specifies that the sqlps utility not load a user profile. Los perfiles de usuario registran los alias, funciones y variables de uso frecuente para usarlos en las sesiones de PowerShell.User profiles record commonly used aliases, functions, and variables for use across PowerShell sessions.

-OutPutFormat { Text | XML }-OutPutFormat { Text | XML }
Especifica que se dé formato a la salida de la utilidad sqlps como cadenas de texto (Text) o en un formato CLIXML serializado (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 }
Especifica que se dé formato a la entrada de la utilidad sqlps como cadenas de texto (Text) o en un formato CLIXML serializado (XML).Specifies that input to the sqlps utility is formatted as either text strings (Text) or in a serialized CLIXML format (XML).

-Command-Command
Especifica el comando que debe ejecutar la utilidad sqlps .Specifies the command for the sqlps utility to run. La utilidad sqlps ejecuta el comando y luego se cierra, a menos que también se especifique -NoExit .The sqlps utility runs the command and then exits, unless -NoExit is also specified. No especifique ningún otro modificador después de -Command; se leerían como parámetros del comando.Do not specify any other switches after -Command, they will be read as command parameters.


-Command- especifica que la utilidad sqlps debe leer la entrada desde la entrada estándar.-Command- specifies that the sqlps utility read the input from the standard input.

script_block [ -argsargument_array ]script_block [ -argsargument_array ]
Especifica un bloque de comandos de PowerShell que se han de ejecutar; el bloque debe incluirse entre llaves: {}.Specifies a block of PowerShell commands to run, the block must be enclosed in braces: {}. Script_block solo se puede especificar cuando se llama a la utilidad sqlps desde PowerShell o desde otra sesión de la utilidad sqlps .Script_block can only be specified when the sqlps utility is called from either PowerShell or another sqlps utility session. argument_array es una matriz de variables de PowerShell que contiene los argumentos de los comandos de PowerShell en 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 ]
Especifica una cadena que contiene los comandos de PowerShell que se han de ejecutar.Specifies a string that contains the PowerShell commands to be run. Use el formato "& {comando}".Use the format "&{command}". Las comillas indican una cadena y el operador de invocación (&) hace que la utilidad sqlps ejecute el comando.The quotation marks indicate a string, and the invoke operator (&) causes the sqlps utility to run the command.

[ -?[ -? | -Help ] | -Help ]
Muestra el resumen de la sintaxis de las opciones de la utilidad sqlps .Shows the syntax summary of the sqlps utility options.

ComentariosRemarks

La utilidad sqlps inicia el entorno de PowerShell (PowerShell.exe) y carga el módulo de SQL ServerSQL Server PowerShell.The sqlps utility starts the PowerShell environment (PowerShell.exe) and loads the SQL ServerSQL Server PowerShell module. El módulo, también denominado sqlps, carga y registra estos complementos de SQL ServerSQL Server PowerShell: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 el proveedor de SQL ServerSQL Server PowerShell y cmdlets asociados como Encode-SqlName y 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 los cmdlets Invoke-Sqlcmd e Invoke-PolicyEvaluation .Implements the Invoke-Sqlcmd and Invoke-PolicyEvaluation cmdlets.

    Puede usar la utilidad sqlps para realizar las tareas siguientes:You can use the sqlps utility to do the following:

  • Ejecutar interactivamente comandos de PowerShell.Interactively run PowerShell commands.

  • Ejecutar archivos de script de PowerShell.Run PowerShell script files.

  • Ejecutar cmdlets de SQL ServerSQL Server .Run SQL ServerSQL Server cmdlets.

  • Usar las rutas de acceso del proveedor de SQL ServerSQL Server para navegar por la jerarquía de objetos de SQL ServerSQL Server .Use the SQL ServerSQL Server provider paths to navigate through the hierarchy of SQL ServerSQL Server objects.

    De forma predeterminada, la utilidad sqlps se ejecuta con la directiva de ejecución de scripting establecida en Restricted.By default, the sqlps utility runs with the scripting execution policy set to Restricted. Esto evita la ejecución de cualquier script de PowerShell.This prevents running any PowerShell scripts. Puede usar el cmdlet Set-ExecutionPolicy para habilitar la ejecución de scripts firmados o de cualquier script.You can use the Set-ExecutionPolicy cmdlet to enable running signed scripts, or any scripts. Ejecute solo scripts de orígenes de confianza y proteja todos los archivos de entrada y salida con los permisos NTFS adecuados.Only run scripts from trusted sources, and secure all input and output files by using the appropriate NTFS permissions. Para obtener más información sobre cómo habilitar los scripts de PowerShell, vea Running Windows PowerShell Scripts.For more information about enabling PowerShell scripts, see Running Windows PowerShell Scripts.

    La versión de la utilidad sqlps en SQL Server 2008SQL Server 2008 y SQL Server 2008 R2SQL Server 2008 R2 se implementó como un shell mínimo de 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. Los shells mínimos tienen ciertas restricciones, como no permitir que los usuarios carguen complementos distintos de los que ha cargado el shell mínimo.Mini-shells have certain restrictions, such as not allowing users to load snap-ins other than those loaded by the mini-shell. Estas restricciones no se aplican a la versión SQL Server 2012 (11.x)SQL Server 2012 (11.x) y posteriores de la utilidad, que se han cambiado para usar el módulo sqlps .These restrictions do not apply to the SQL Server 2012 (11.x)SQL Server 2012 (11.x) and higher versions of the utility, which have been changed to use the sqlps module.

EjemplosExamples

A. Ejecute la utilidad sqlps en de forma predeterminada, el modo interactivo sin la pancarta de copyrightA. Run the sqlps utility in default, interactive mode without the copyright banner

sqlps -NoLogo  

B. Ejecutar un script de PowerShell de SQL Server desde la línea de comandosB. Run a SQL Server PowerShell script from the command prompt

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

C. Ejecutar un script de PowerShell de SQL Server desde el símbolo del sistema y continuar la ejecución una vez completada la secuencia de comandosC. Run a SQL Server PowerShell script from the command prompt, and keep running after the script completes

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

Vea tambiénSee Also

Habilitar o deshabilitar un protocolo de red de servidor Enable or Disable a Server Network Protocol
SQL Server PowerShellSQL Server PowerShell