posh-dell.psm1

<#  
    Helpful resources
    
    Documentation of Dell dcim libraries: http://en.community.dell.com/techcenter/systems-management/w/wiki/1906.dcim-library-profile
    http://en.community.dell.com/techcenter/systems-management/w/wiki/4374.how-to-build-and-execute-wsman-method-commands.aspx
    http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2.41.0/
    http://www.google.com/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&ved=0CDQQFjAA&url=http%3A%2F%2Fen.community.dell.com%2Fcfs-file.ashx%2F__key%2Ftelligent-evolution-components-attachments%2F13-4491-00-00-20-40-00-06%2FDell_5F00_ChassisSystemInfoProfile_2D00_1.0.pdf&ei=_kKzU-uVGpKHyAS9hIG4DA&usg=AFQjCNH4LgCBpleQcD3O3vBm6k26DHg9nw&sig2=q99c4YDrWEMnHk9eREI6aw&bvm=bv.70138588,d.aWw
    Search "Fibre Channel Host Bus Adapters for Dell PowerEdge Servers"
#>

Add-Type -TypeDefinition @"
    public enum ExportMode
    {
        Normal,
        Clone,
        Replace
    }
"@

Add-Type -TypeDefinition @"
    public enum ShutdownType
    {
        Graceful,
        Forced
    }
"@

Add-Type -TypeDefinition @"
    public enum EndHostPowerState
    {
        PoweredOff,
        PoweredOn
    }
"@


Function CreateCimSessionOption {
    Return New-CimSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck -Encoding Utf8 -UseSsl
}

Function New-iDracSession {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    $DebugPreference='Continue'
    $ErrorActionPreference = 'Stop'   
    Try {
        $Cimop = CreateCimSessionOption
        Return New-CimSession -Authentication Basic -Credential $credential -ComputerName $ipAddress -Port 443 -SessionOption $Cimop
    }
    Catch {
        Throw
    }

}

Function GetView {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential,
        [Parameter(Mandatory=$TRUE)][string]$uri
    )
    $DebugPreference='Continue'
    $ErrorActionPreference = 'Stop'
    Try {
        $session = New-iDracSession -ipAddress $ipAddress -credential $credential
        return Get-CimInstance -CimSession $session -ResourceUri $uri
    }
    Catch {
        Throw
    }
}

Function Export-SystemConfigurationProfile {
    Param(
        [Parameter(Mandatory=$True)][string]$ComputerName,
        [Parameter(Mandatory=$True)][PSCredential]$DracCredential,
        [Parameter(Mandatory=$True)][PSCredential]$ShareCredential,
        [Parameter(Mandatory=$True)][string]$ShareName,
        [Parameter(Mandatory=$True)][string]$ShareIP,
        [Parameter(Mandatory=$True)][string]$FileName,
        [Parameter(Mandatory=$False)][string]$Target='All',
        [Parameter(Mandatory=$True)][ExportMode]$ExportMode=[ExportMode]::Normal,
        [Parameter(Mandatory=$False)][Switch]$Passthrough=[Switch]$False
    )

    #$uri = 'http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService?SystemCreationClassName=DCIM_ComputerSystem+CreationClassName=DCIM_LCService+SystemName=DCIM:ComputerSystem+Name=DCIM:LCService'

    $session = New-iDracSession -ipAddress $ComputerName -credential $DracCredential

    $properties= @{SystemCreationClassName="DCIM_ComputerSystem";SystemName="DCIM:ComputerSystem";CreationClassName="DCIM_LCService";Name="DCIM:LCService";}
    $instance = New-CimInstance -ClassName DCIM_LCService -Namespace root/dcim -ClientOnly -Key @($properties.keys) -Property $properties
    
    $parameters = @{}
    $parameters.Add('Username',$ShareCredential.UserName)
    $parameters.Add('Password',$ShareCredential.GetNetworkCredential().Password)
    $parameters.Add('IPAddress',$ShareIP)
    $parameters.Add('ShareName',$ShareName)
    $parameters.Add('ShareType',2)
    $parameters.Add('FileName',$FileName)
    $parameters.Add('Target',$Target)
    
    if($ExportMode -ne [ExportMode]::Normal) {
        Switch ($ExportMode) {
            'Clone' {
                $parameters.Add('ExportUse',1)
            }
            'Replace' {
                $parameters.Add('ExportUse',2)
            }
        }
    }

    $job = Invoke-CimMethod -MethodName ExportSystemConfiguration -InputObject $instance -CimSession $session -Arguments $parameters
    if($job.ReturnValue -eq 4096) {
        if($Passthrough) {
            $job
        }
        else {
            $job = Wait-SystemConfigurationJob -Session $session -JobID $job.Job.EndpointReference.InstanceID -Activity "Exporting System Configuration for $($session.ComputerName)"
        }
    }
    else {
        Throw "Job creation failed with error: $($job.Message)"
    }
    $job

}

Function Import-SystemConfigurationProfile {
    Param(
        [Parameter(Mandatory=$True)][string[]]$ComputerName,
        [Parameter(Mandatory=$True)][PSCredential]$DracCredential,
        [Parameter(Mandatory=$True)][PSCredential]$ShareCredential,
        [Parameter(Mandatory=$True)][string]$ShareName,
        [Parameter(Mandatory=$True)][string]$ShareIP,
        [Parameter(Mandatory=$True)][string]$FileName,
        [Parameter(Mandatory=$False)][Switch]$Passthrough=[Switch]$False,
        [Parameter(Mandatory=$False)][Switch]$Confirm=[Switch]$True,
        [Parameter(Mandatory=$False)][Switch]$WhatIf=[Switch]$False,
        [Parameter(Mandatory=$False)][EndHostPowerState]$EndPowerState,
        [Parameter(Mandatory=$False)][ShutdownType]$ShutdownType

    )

    #$uri = 'http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_LCService?SystemCreationClassName=DCIM_ComputerSystem+CreationClassName=DCIM_LCService+SystemName=DCIM:ComputerSystem+Name=DCIM:LCService'

    Begin {
        $properties= @{SystemCreationClassName="DCIM_ComputerSystem";SystemName="DCIM:ComputerSystem";CreationClassName="DCIM_LCService";Name="DCIM:LCService";}
        $instance = New-CimInstance -ClassName DCIM_LCService -Namespace root/dcim -ClientOnly -Key @($properties.keys) -Property $properties
    
        $parameters = @{}
        $parameters.Add('Username',$ShareCredential.UserName)
        $parameters.Add('Password',$ShareCredential.GetNetworkCredential().Password)
        $parameters.Add('IPAddress',$ShareIP)
        $parameters.Add('ShareName',$ShareName)
        $parameters.Add('ShareType',2)
        $parameters.Add('FileName',$FileName)
    
        if(!$WhatIf) {
            Switch($EndPowerState) {
                'PoweredOff' {
                    $parameters.Add('EndHostPowerState',0)
                }
                'PoweredOn' {
                    $parameters.Add('EndHostPowerState',1)
                }
            }

            Switch($ShutdownType) {
                'Graceful' {
                    $parameters.Add('ShutdownType',0)
                }
                'Forced' {
                    $parameters.Add('ShutdownType',1)
                }
            }
        }

    }
    
    Process {
        foreach($computer in $ComputerName) {
            $session = New-iDracSession -ipAddress $computer -credential $DracCredential

            if($WhatIf) {
                $job = Invoke-CimMethod -MethodName ImportSystemConfigurationPreview -InputObject $instance -CimSession $session -Arguments $parameters
            }
            else {
                if(!$Confirm) {
                    $job = Invoke-CimMethod -MethodName ImportSystemConfiguration -InputObject $instance -CimSession $session -Arguments $parameters
                }
            }
            
            if($job.ReturnValue -eq 4096) {
                if($Passthrough) {
                    $job
                }
                else {
                    $job = Wait-SystemConfigurationJob -Session $session -JobID $job.Job.EndpointReference.InstanceID -Activity "Exporting System Configuration for $($session.ComputerName)"
                }
            }
            else {
                Throw "Job creation failed with error: $($job.Message)"
            }
            $job
        }
    }
}

Function Wait-SystemConfigurationJob {
    Param (
        [Parameter(Mandatory,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true,ValueFromRemainingArguments=$false)]$Session,
        [Parameter (Mandatory)]$JobID,
        [Parameter()][String]$Activity = 'Performing iDRAC job'
    )
    
    $jobstatus = Get-CimInstance -CimSession $Session -ResourceUri "http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/DCIM_LifecycleJob" -Namespace "root/dcim" -Query "SELECT InstanceID,JobStatus,Message,PercentComplete FROM DCIM_LifecycleJob Where InstanceID='$JobID'"
        
    if ($jobstatus.PercentComplete -eq 'NA') {
        $PercentComplete = 0
    }
    else {
        $PercentComplete = $JobStatus.PercentComplete
    }
    
    while (($jobstatus.JobStatus -like 'Running' -or $jobstatus.JobStatus -like '*Progress*' -or $jobstatus.JobStatus -like '*ready*' -or $jobstatus.JobStatus -like '*pending*')) {
        $jobstatus = Get-CimInstance -CimSession $Session -ResourceUri "http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/DCIM_LifecycleJob" -Namespace "root/dcim" -Query "SELECT InstanceID,JobStatus,Message,PercentComplete FROM DCIM_LifecycleJob Where InstanceID='$JobID'"
        if ($jobstatus.JobStatus -notlike '*Failed*') {
            if ($jobstatus.PercentComplete -eq 'NA') {
                $PercentComplete = 0
            }
            else {
                $PercentComplete = $JobStatus.PercentComplete
            }
        } 
        else {
            Throw "Job creation failed with an error: $($jobstatus.Message). Use 'Get-PEConfigurationResult -JobID $($jobstatus.Job.EndpointReference.InstanceID)' to receive detailed configuration result"
        }
        
        Write-Progress -activity "Job Status: $($JobStatus.Message)" -status "$PercentComplete % Complete:" -percentcomplete $PercentComplete
        Start-Sleep 1
    }
    $jobstatus
}

Function Get-SystemConfigurationJob {
    Param (
        [Parameter(Mandatory,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true,ValueFromRemainingArguments=$false)]$Session,
        [Parameter (Mandatory)]$JobID
    )

    $job = Get-CimInstance -CimSession $Session -ResourceUri "http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/DCIM_LifecycleJob" -Namespace "root/dcim" -Query "SELECT * FROM DCIM_LifecycleJob Where InstanceID='$JobID'"
    $job
}

Function Get-SystemConfigurationResult {
    [CmdletBinding()]
    [OutputType([PSObject])]
    Param (
        [Parameter(Mandatory,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true,ValueFromRemainingArguments=$false)]$Session,
        [Parameter(Mandatory)]$JobID
    )

    Begin {
        $properties=@{InstanceID="DCIM:LifeCycleLog";}
        $instance = New-CimInstance -ClassName DCIM_LCRecordLog -Namespace root/dcim -ClientOnly -Key @($properties.keys) -Property $properties
        $Parameters = @{JobID = $JobID}
    }

    Process {
        $Result = Invoke-CimMethod -InputObject $instance -MethodName GetConfigResults -CimSession $Session -Arguments $Parameters
        if ($Result.ReturnValue -eq 0) {
            $Xml = $Result.COnfigResults
            $XmlDoc = New-Object System.Xml.XmlDocument
            $ConfigResults = $XmlDoc.CreateElement('Configuration')
            $ConfigResults.InnerXml = $Xml
            Foreach ($ConfigResult in $ConfigResults.ConfigResults) {
                $ResultHash = [Ordered]@{
                    JobName = $ConfigResult.JobName
                    JobID = $ConfigResult.JobID
                    JobDisplayName = $ConfigResult.JobDisplayName
                    FQDD = $ConfigResult.FQDD
                }
                $OperationArray = @()
                Foreach ($Operation in $ConfigResult.Operation) {
                    $OperationHash = [Ordered]@{
                        Name = $Operation.Name -join ' - '
                        DisplayValue = $Operation.DisplayValue
                        Detail = $Operation.Detail.NewValue
                        MessageID = $Operation.MessageID
                        Message = $Operation.Message
                        Status = $Operation.Status
                        ErrorCode = $Operation.ErrorCode
                    }
                    $OperationArray += $OperationHash      
                }
                $ResultHash.Add('Operation',$OperationArray)
                New-Object -TypeName PSObject -Property $ResultHash
            }
        } 
        else {
            Write-Error $Result.Message
        }
    }
}

Function Get-SystemView {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_SystemView'
}

Function Get-BiosEnum {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_BIOSEnumeration'
}

Function Get-BladeView {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_BladeServerView'
}

Function Get-FCStatistics {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_FCStatistics'
}

Function Get-FCCapabilities {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_FCCababilities'
}

Function Get-FCView {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_FCView'
}

Function Get-FCEnumeration {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/root/dcim/DCIM_FCEnumeration'
}

Function Get-ChassisView {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_ModularChassisView'
}

Function Get-CPUView {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_CPUView'
}

Function Get-MemoryView {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_MemoryView'
}

Function Get-NICView {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_NICView'
}

Function Get-iDRACView {
    Param(
        [Parameter(Mandatory=$TRUE)][string]$ipAddress,
        [Parameter(Mandatory=$TRUE)][PSCredential]$credential
    )
    Return GetView -ipAddress $ipAddress -credential $credential -uri 'http://schemas.dell.com/wbem/wscim/1/cim-schema/2/DCIM_iDRACCARDView'
}

Set-Alias CreateCimSession New-iDracSession
Export-ModuleMember -Function *