PSModuleTemplate

1.0.0.2

Resources/New-ProjectTemplate/Functions.psm1

$Script:Config = Import-PowerShellDataFile -Path "$PSScriptRoot\config.psd1"

function UnProtect-Config
{
    <#
    .SYNOPSIS
       Intenta descifrar una cadena protegida.
    .DESCRIPTION
       Intenta descifrar una cadena que fue protegida utilizando la función Protect-String en el módulo Carbon.
    .EXAMPLE
        Intenta descifrar una cadena en claro
       'Hola Mundo' | UnProtect-Config
    .EXAMPLE
        Intenta descifrar una cadena en cifrada con Protect-String
       'AQAAANCMnd8BFdERjHoAwE/Cl+sBAAAApY8XQBGb6Ue5Ph226jh4+QQAAAACAAAAAAADZgAAwAAAABAAAAAL/8TJ4/sKEVvTQtG0050zAAAAAASAAACgAAAAEAAAAIn/ihLL1Jvmk1/8INDyaScQAAAAxL0oSRmBcNDU1I3viGyGChQAAAAmGDfc8qJVsdjklGLypSZgs35hdQ==' | UnProtect-Config
    .INPUTS
       Cadena de texto cifrada o descrifada.
    .OUTPUTS
       Cadena de texto descrifada (si estaba cifrada). Si la cadena no estaba cifrada se retorna la misma cadena de entrada.
    #>
     [OutputType([string])]
     param
     (
         [Parameter(Mandatory,ValueFromPipeline)]
         [ValidateNotNullOrEmpty()]
         [string]
         $Text
     )

     try{
        ($Text | Unprotect-String) | Write-Output
     }
     catch [System.FormatException]{
        $Text | Write-Output
     }
}

function Start-TranscriptLogFile
{
    <#
    .SYNOPSIS
       Envía la salida de la sesión de PowerShell a un archivo de texto.
    .DESCRIPTION
       Envía la salida de la sesión de PowerShell a un archivo de texto en la subcarpeta Logs. Se crea un achivo por día calendario.
    .EXAMPLE
       Inicializa la transcripción al archivo predeterminado en la carpeta Logs.
       Initialize-Transcript
    .EXAMPLE
       Inicializa la transcripción al archivo MyAwesomeLog.log en la carpeta Logs.
       Initialize-Transcript -FileName 'MyAwesomeLog'
    .INPUTS
       Cadena de texto con el nombre del archivo a generar (omita oara utilizar el nombre predeterminado).
    .OUTPUTS
       Ruta de acceso del archivo donde se está transcribiendo la sesión.
    #>

    [CmdletBinding()]
    [OutputType([string])]
    Param
    (
         [Parameter(ValueFromPipeline)]
         [string]
         $FileName = [System.IO.Path]::GetFileNameWithoutExtension($MyInvocation.ScriptName),

         [Parameter()]
         [bool]
         $Append = $true
    )

    $LogFolderPath = Join-Path -Path $MyInvocation.PSScriptRoot -ChildPath 'Logs'
    $LogFileName = '{0}_{1:yyyy-MM-dd}.log' -f $FileName, (Get-Date)
    New-Item -Path $LogFolderPath -ItemType 'Directory' -ErrorAction SilentlyContinue | Out-Null
    $TranscriptFileName = Join-Path -Path $LogFolderPath -ChildPath $LogFileName
    $TranscriptParams = @{Path=$TranscriptFileName;Force=$true;Append=$Append}
    $TranscriptParams | ConvertTo-Json | Write-Verbose
    Start-Transcript @TranscriptParams | Out-Null            
    $Script:TranscriptStarted = $true
    $TranscriptFileName | Write-Output
}

function Stop-TranscriptLogFile
{
    if ($Script:TranscriptStarted){
        Stop-Transcript
    }
}

function Invoke-SqlCommand 
{
    <#
    .SYNOPSIS
       Ejecuta una instrucción SQL.
    .DESCRIPTION
       Ejecuta una instrucción SQL y retorna el resultado de la ejecución como un DataTable.
    .EXAMPLE
       Ejecuta una instrucción SQL conectándose a la base de datos especificada en el parámetro $ConnectionString.
       $Result = 'select getdate() as CurrentDate' | Invoke-SqlCommand -ConnectionString 'Data Source=(local);Initial Catalog=master;Integrated Security=True' -CommandType Text
       # Acceder al resultado
       # $Result.CurrentDate
    .EXAMPLE
       Ejecuta una instrucción SQL que utiliza parámetros.
       'select * from sys.databases where name = @name' | Invoke-SqlCommand -ConnectionString 'Data Source=(local);Initial Catalog=master;Integrated Security=True' -CommandType Text -ArgumentList @{name='master'}
    .INPUTS
        
    .OUTPUTS
       DataTable con los resultados de la ejecución de la instrucción SQL.
    #>
     [CmdletBinding(DefaultParametersetName='FromString')]
     [OutputType([System.Data.DataTable])]
     param
     (
         [Parameter(Mandatory, ParameterSetName='FromString') ]
         [ValidateNotNullOrEmpty()]         
         [string]         
         $ConnectionString,

         [Parameter(Mandatory, ParameterSetName='FromConnection') ]
         [ValidateNotNull()]
         [System.Data.SqlClient.SqlConnection]         
         $SqlConnection, 

         [Parameter(Mandatory,ValueFromPipeline)]
         [ValidateNotNullOrEmpty()]
         [string]
         $CommandText,

         [Parameter()]
         [System.Data.CommandType]
         $CommandType = [System.Data.CommandType]::StoredProcedure,

         [Parameter()]
         [PSObject]
         $ArgumentList = $null,

         [Parameter()]
         [int]
         $CommandTimeout = 30
     )
 
    if ($PsCmdlet.ParameterSetName -eq 'FromString'){
        $SqlConnection = New-Object -TypeName System.Data.SqlClient.SqlConnection -ArgumentList $ConnectionString
    }

    $SqlCommand = New-Object -TypeName System.Data.SqlClient.SqlCommand -ArgumentList $CommandText,$SqlConnection
    $SqlCommand.CommandTimeout = $CommandTimeout
    $SqlCommand.CommandType = $CommandType

    if ($SqlConnection.State -ne [System.Data.ConnectionState]::Open){
        $SqlConnection.Open()
    }

    if ($ArgumentList -ne $null)
    {
        $Enumerator = $ArgumentList.GetEnumerator()
        $Enumerator | ForEach-Object {
            $SqlCommand.Parameters.AddWithValue($_.Key, $_.Value) | Out-Null
        }
    }
   
    $SqlDataAdapter = New-Object -TypeName System.Data.SqlClient.SqlDataAdapter -ArgumentList $SqlCommand
    $SqlDataSet = New-Object -TypeName System.Data.DataSet
    $SqlDataAdapter.Fill($SqlDataSet) | Out-Null
    $SqlDataSet.Tables[0] | Write-Output
    
    if ($PsCmdlet.ParameterSetName -eq 'FromString'){
        $SqlConnection.Dispose()
    }
}