Invoke-SimanSqlCmd⚓︎
SYNOPSIS⚓︎
Ejecuta un query en una base de datos de la plataforma Siman Cloud.
Importante
Se necesita el rol de Cloud Admin para ejecutar este comando.
SYNTAX⚓︎
Invoke-SimanSqlCmd -DbService <Object> -Database <String> [-Query] <String> [<CommonParameters>]
DESCRIPTION⚓︎
Este comando permite ejecutar consultas SQL en bases de datos alojadas en la plataforma Siman Cloud, tanto en Azure como en AWS.
El comando verifica la existencia de la base de datos y utiliza la autenticación apropiada
según el proveedor de servicios cloud.
Solo funciona al estar firmado dentro del entorno de siman.cloud.
EXAMPLES⚓︎
Example 1: Ejecutar una consulta en una base de datos de Azure⚓︎
PS> $query = "SELECT TOP 100 * FROM smn.Usuario"
PS> Invoke-SimanSqlCmd -ServerName 'siman-prod-std' -Database SUS102_SDM -Query $query
Este ejemplo ejecuta una consulta simple para obtener los primeros 100 registros en una base de datos
de Azure.
Example 2: Ejecutar una consulta en una base de datos de AWS⚓︎
PS> $query = "SELECT TOP 10 FROM smn.eventLog WHERE Origen = 'Autorización'"
PS> Invoke-SimanSqlCmd -ServerName 'SMNAWSDB03' -Database SUS001_Capacitacion -Query $query
PARAMETERS⚓︎
-DbService⚓︎
Especifica el servicio de base de datos donde se ejecutará la consulta. Puede ser una instancia de Azure SQL Database
o Amazon RDS. Se puede especificar el nombre del servidor o la instancia del servicio.
Type: System.Object
Parameter Sets: (All)
Aliases: ServerName, ServerInstance
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Database⚓︎
Especifica el nombre de la base de datos donde se ejecutará la consulta. El cmdlet verificará la existencia de la base
de datos antes de ejecutar la consulta.
Type: System.String
Parameter Sets: (All)
Aliases: Name, DatabaseName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Query⚓︎
Especifica la consulta SQL a ejecutar en la base de datos. La consulta debe ser compatible con el motor de base de datos.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters⚓︎
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
INPUTS⚓︎
None⚓︎
OUTPUTS⚓︎
System.Object⚓︎
Los resultados de la consulta SQL se devuelven como un objeto .NET
NOTES⚓︎
Este cmdlet es un wrapper del cmdlet Invoke-Sqlcmd del módulo oficial SqlServer,
que proporciona una capa de abstracción para la autenticación y validación específica de la plataforma Siman Cloud.