sqlps, utilidad

Artículo
07/12/2024

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

La utilidad sqlps inicia una sesión de Windows PowerShell con el proveedor de SQL Server PowerShell y los cmdlets cargados y registrados. Puede escribir scripts o comandos de PowerShell que usen los componentes de SQL Server PowerShell para trabajar con instancias de SQL Server y sus objetos.

Importante

Esta característica se quitará en una versión futura de SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. En su lugar, use el módulo sqlps de PowerShell. Para más información acerca del módulo sqlps , consulte Import the SQLPS Module.

Sintaxis

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

Argumentos

-NoLogo
Especifica que la utilidad sqlps debe ocultar el título de copyright cuando se inicia.

-NoExit
Especifica que la utilidad sqlps debe seguir ejecutándose después de que los comandos de inicio se hayan completado.

-NoProfile
Especifica que la utilidad sqlps no debe cargar un perfil de usuario. Los perfiles de usuario registran los alias, funciones y variables de uso frecuente para usarlos en las sesiones de PowerShell.

-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).

-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).

-Command
Especifica el comando que debe ejecutar la utilidad sqlps . La utilidad sqlps ejecuta el comando y luego se cierra, a menos que también se especifique -NoExit . No especifique ningún otro modificador después de -Command; se leerían como parámetros del comando.

-
-Command- especifica que la utilidad sqlps debe leer la entrada desde la entrada estándar.

script_block [ -argsargument_array ]
Especifica un bloque de comandos de PowerShell que se han de ejecutar; el bloque debe incluirse entre llaves: {}. Script_block solo se puede especificar cuando se llama a la utilidad sqlps desde PowerShell o desde otra sesión de la utilidad sqlps . argument_array es una matriz de variables de PowerShell que contiene los argumentos de los comandos de PowerShell en script_block.

string [ command_parameters ]
Especifica una cadena que contiene los comandos de PowerShell que se han de ejecutar. Use el formato "&{command}". Las comillas indican una cadena y el operador de invocación (&) hace que la utilidad sqlps ejecute el comando.

[ -? | -Help ]
Muestra el resumen de la sintaxis de las opciones de la utilidad sqlps .

Observaciones

La utilidad sqlps inicia el entorno de PowerShell (PowerShell.exe) y carga el módulo de SQL Server PowerShell. El módulo, también denominado sqlps, carga y registra estos complementos de SQL Server PowerShell:

Microsoft.SqlServer.Management.PSProvider.dll

Implementa el proveedor de SQL Server PowerShell y cmdlets asociados como Encode-SqlName y Decode-SqlName.
Microsoft.SqlServer.Management.PSSnapin.dll

Implementa los cmdlets Invoke-Sqlcmd e Invoke-PolicyEvaluation .

Puede usar la utilidad sqlps para realizar las tareas siguientes:

Ejecutar interactivamente comandos de PowerShell.
Ejecutar archivos de script de PowerShell.
Ejecutar cmdlets de SQL Server.
Use las rutas de acceso del proveedor de SQL Server para navegar por la jerarquía de objetos SQL Server.

De forma predeterminada, la utilidad sqlps se ejecuta con la directiva de ejecución de scripting establecida en Restricted. Esto evita la ejecución de cualquier script de PowerShell. Puede usar el cmdlet Set-ExecutionPolicy para habilitar la ejecución de scripts firmados o de cualquier script. Ejecute solo scripts de orígenes de confianza y proteja todos los archivos de entrada y salida con los permisos NTFS adecuados. Para obtener más información sobre cómo habilitar los scripts de PowerShell, vea Running Windows PowerShell Scripts.

La versión de la utilidad sqlps en SQL Server 2008 (10.0.x) y SQL Server 2008 R2 (10.50.x) se implementó como un shell mínimo de Windows PowerShell 1.0. 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. Estas restricciones no se aplican a la versión de SQL Server 2012 (11.x) y posteriores de la utilidad, que se han cambiado para usar el módulo sqlps.

Ejemplos

A. Ejecutar la utilidad sqlps en modo predeterminado e interactivo sin el título de copyright

sqlps -NoLogo

B. Ejecutar un script de SQL Server PowerShell desde el símbolo del sistema

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

C. Ejecutar un script de SQL Server PowerShell desde el símbolo del sistema y continuar la ejecución una vez que el script se complete

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

Consulte también

Habilitar o deshabilitar un protocolo de red de servidor
SQL Server PowerShell

Compartir vía