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

Comentarios

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

Tasks

Otros recursos