Utilidad sqlps
La utilidad sqlps inicia una sesión de PowerShell con el proveedor de PowerShell de SQL Server y los cmdlets cargados y registrados. Puede escribir scripts o comandos de PowerShell que usen los componentes de PowerShell de SQL Server para trabajar con instancias de SQL Server y sus objetos.
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 sqlps oculte el título de copyright cuando se inicia.-NoExit
Especifica que sqlps siga ejecutándose después de que los comandos de inicio se hayan completado.-NoProfile
Especifica que sqlps no cargue un perfil de usuario. Los perfiles de usuario registran alias, funciones y variables de uso frecuente para utilizarse en las sesiones de PowerShell.-OutPutFormat { Text | XML }
Especifica que se dé formato a la salida de sqlps como cadenas de texto (Text) o en un formato de CLIXML serializado (XML).-InPutFormat { Text | XML }
Especifica que se dé formato a la entrada a sqlps como cadenas de texto (Text) o con un formato de CLIXML serializado (XML).-Command
Especifica el comando que sqlps ha de ejecutar. La utilidad sqlps ejecuta el comando y, a continuación, finaliza, a menos que también se especifique -NoExit. No especifique ningún otro modificador después de -Command; se leerán como parámetros de comandos.-
-Command- especifica que sqlps lea la entrada desde la entrada estándar.script_block [ -argsargument_array ]
Especifica un bloque de comandos de PowerShell que se ha de ejecutar; el bloque debe incluirse entre llaves: {}. Sólo se puede especificar Script_block cuando se llama a sqlps desde PowerShell o 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 tipográficas indican una cadena, y el operador de invocación (&) hace que sqlps ejecute el comando.[ -? | -Help ]
Muestra el resumen de la sintaxis de las opciones de sqlps.
Notas
La utilidad sqlps inicia el entorno de PowerShell (PowerShell.exe) con los complementos de PowerShell de SQL Server cargados y registrados. Los complementos de PowerShell de SQL Server son los siguientes:
Microsoft.SqlServer.Management.PSProvider.dll
Implementa el proveedor de PowerShell de SQL Server y los cmdlets asociados como Encode-SqlName y Decode-SqlName.
Microsoft.SqlServer.Management.PSSnapin.dll
Implementa el cmdlet Invoke-Sqlcmd.
Puede usar sqlps para las acciones siguientes:
Ejecutar interactivamente los comandos de PowerShell.
Ejecutar los 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, sqlps se ejecuta con la directiva de ejecución de scripts establecida en Restringida. Esto evita la ejecución de cualquier script de PowerShell. Puede utilizar el cmdlet Set-ExecutionPolicy para habilitar la ejecución de los scripts con firma o de cualquier script. Ejecute sólo scripts de orígenes de confianza y proteja todos los archivos de entrada y salida utilizando los permisos NTFS adecuados. Para obtener más información sobre cómo habilitar scripts de PowerShell, vea Running Windows PowerShell Scripts.
Ejemplos
A. Ejecutar sqlps en modo predeterminado e interactivo sin el título de copyright
sqlps -NoLogo
B. Ejecutar un script de PowerShell de SQL Server desde el símbolo del sistema
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 que el script se complete
sqlps -NoExit -Command "&{.\MyFolder.MyScript.ps1}"
Vea también