Utilidad sqlps
La utilidad sqlps inicia una sesión de Windows PowerShell 2.0 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.
.gif "Nota importante") Importante |
|---|
Esta característica se quitará en una versión futura de Microsoft 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 obtener más información acerca del módulo sqlps, vea Importar el módulo SQLPS. |
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, a continuación, 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 contienen 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.
Comentarios
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 los 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.
Usar las rutas de acceso del proveedor de SQL Server para navegar por la jerarquía de objetos de 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 con firma 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 y en SQL Server 2008 R2 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 SQL Server 2012 de la utilidad, que se ha cambiado para que use 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}"