Compartir a través de

utilidad sqlps

Aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Analítica (PDW)Base de datos SQL en Microsoft Fabric

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

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 la salida de la utilidad sqlps tiene el formato de 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).

-Mandar

Especifica el comando que debe ejecutar la utilidad sqlps . La utilidad sqlps ejecuta el comando y, a continuación, sale, a menos -NoExit que también se especifique. No especifique ningún otro modificador después -Commandde . Se leen como parámetros de comando.

-

-Command- especifica que la utilidad sqlps lee la entrada de la entrada estándar.

script_block [ -args argument_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 (<command>).

[ -? | -Ayuda ]

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 siguientes tareas:

  • Ejecutar interactivamente comandos de PowerShell.

  • Ejecutar archivos de script de PowerShell.

  • Ejecutando los 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 mini shells tienen ciertas restricciones, como no permitir que los usuarios carguen complementos distintos de los complementos cargados por el mini shell. Estas restricciones no se aplican a SQL Server 2012 (11.x) y versiones posteriores de la utilidad, que se han cambiado para usar el módulo sqlps .

Ejemplos

sqlps -NoLogo

B. Ejecutar un script de PowerShell para SQL Server desde la línea de comandos

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}"

Contenido relacionado

  • Last updated on