Share via


Utilizar los cmdlets del motor de base de datos

Los cmdlets de Windows PowerShell son comandos de una sola función que normalmente siguen la convención de nomenclatura verbo-nombre, como Get-Help o Set-MachineName. El proveedor de SQL Server para Windows PowerShell proporciona cmdlets específicos a SQL Server.

Cmdlets del motor de base de datos

SQL Server implementa una pequeña parte de los cmdlets de Motor de base de datos. Estos cmdlets se usan principalmente para ejecutar scripts Transact-SQL existentes de los nuevos scripts de PowerShell, evaluar las directivas de administración basadas en directivas y ayuda a especificar los identificadores de SQL Server en rutas de acceso del proveedor de SQL Server.

La mayoría de los scripts de Windows PowerShell funciona con Motor de base de datos mediante el proveedor de SQL Server PowerShell y los modelos de objetos de administración de SQL Server. Para obtener más información, vea SQL Server PowerShell.

Obtener Ayuda de los cmdlets

En el entorno de Windows PowerShell, el cmdlet Get-Help proporciona información de ayuda para cada cmdlet. Get-Help devuelve información como la sintaxis, las definiciones de parámetro, los tipos de entrada y salida, y una descripción de la acción realizada por el cmdlet. Para obtener más información, vea Obtener ayuda de SQL Server PowerShell.

Nombres de parámetros parciales

No tiene que especificar el nombre completo de un parámetro de cmdlet. Solo tiene que especificar una parte del nombre que sea suficiente para separarlo de forma exclusiva de los otros parámetros admitidos por el cmdlet. Por ejemplo, en estos ejemplos se muestran tres formas de especificar el parámetro Invoke-Sqlcmd -QueryTimeout:

Invoke-Sqlcmd -Query "SELECT @@VERSION;" -QueryTimeout 3
Invoke-Sqlcmd -Query "SELECT @@VERSION;" -QueryTime 3
Invoke-Sqlcmd -Query "SELECT @@VERSION;" -QueryT 3

Tareas de cmdlets del motor de base de datos

Descripción de la tarea

Tema

Describe el uso de Invoke-Sqlcmd para ejecutar scripts de sqlcmd o comandos que contienen instrucciones Transact-SQL o XQuery. Puede aceptar la entrada de sqlcmd como parámetro de entrada de la cadena de caracteres o como nombre de un archivo de script que se va a abrir.

cmdlet Invoke-Sqlcmd

Describe el uso de Invoke-PolicyEvaluation para informar de si un conjunto de objetos de SQL Server de destino cumple las condiciones definidas en las directivas de administración basadas en directivas. Opcionalmente, el cmdlet se puede usar para volver a configurar cualquier opción que se pueda establecer en los objetos de destino que no cumplan las condiciones de la directiva.

cmdlet Invoke-PolicyEvaluation

Describe el uso de Encode-Sqlname y Decode-Sqlname para administrar los identificadores de SQL Server que contienen caracteres no admitidos en las rutas de Windows PowerShell.

Codificar y descodificar identificadores de SQL Server

Describe el uso de Convert-UrnToPath para convertir un nombre de recursos uniforme (URN) del objeto de administración de SQL Server a la ruta de acceso equivalente en el proveedor de SQL Server.

Convertir URN en rutas de acceso del proveedor de SQL Server

Vea también

Conceptos

Proveedor de PowerShell de SQL Server

SQL Server PowerShell

Información general de los cmdlets de PowerShell para grupos de disponibilidad AlwaysOn (SQL Server)