Importar el módulo SQLPS

El método recomendado para administrar SQL Server desde PowerShell consiste en importar el módulo sqlps en un entorno de Windows PowerShell 2.0. El módulo carga y registra los complementos de SQL Server y los ensamblados de administración.

  1. Antes de empezar: Seguridad

  2. Para cargar el módulo: Cargue el módulo sqlps

Antes de empezar

Después de importar el módulo de sqlps en Windows PowerShell, a continuación puede:

  • Ejecutar interactivamente comandos de Windows PowerShell.

  • Ejecutar archivos de script de Windows 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.

  • Usar los modelos de objetos de administración de SQL Server (como Microsoft.SqlServer.Management.Smo) para administrar los objetos de SQL Server.

[!NOTA]

Los verbos usados en los nombres de dos cmdlets de SQL Server (Encode-Sqlname y Decode-Sqlname) no coinciden con los verbos aprobados para Windows PowerShell 2.0. Esto no afecta a la operación, pero mejoras de Windows PowerShell genera una advertencia cuando el módulo de sqlps se importa a una sesión.

Seguridad

De forma predeterminada, Windows PowerShell se ejecuta con la directiva de ejecución de scripting establecida en Restricted, lo que evita la ejecución de cualquier script de Windows PowerShell. Para cargar el módulo sqlps, 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 usando los permisos NTFS adecuados. Para obtener más información sobre cómo habilitar scripts de Windows PowerShell, vea cómo ejecutar scripts de Windows PowerShell.

Cargar el módulo sqlps

Para cargar el módulo sqlps en Windows PowerShell

  1. Use el cmdlet Set-ExecutionPolicy para establecer la directiva de ejecución de script apropiada.

  2. Use el cmdlet Import-Module para importar el módulo sqlps. Especifique el parámetro de DisableNameChecking si desea suprimir la advertencia acerca de Encode-Sqlname y Decode-Sqlname.

Ejemplo (PowerShell)

En este ejemplo se carga el módulo de sqlps con la comprobación de nombre desactivada.

## Import the SQL Server Module.

Import-Module “sqlps” -DisableNameChecking

[Arriba]

Vea también

Conceptos

SQL Server PowerShell

Proveedor de PowerShell de SQL Server

Utilizar los cmdlets del motor de base de datos