iDRAC4Redfish.psm1
|
function Unblock-Certs { Add-Type -TypeDefinition @" using System.Net; using System.Security.Cryptography.X509Certificates; public class TrustAllCertsPolicy : ICertificatePolicy { public bool CheckValidationResult( ServicePoint srvPoint, X509Certificate certificate, WebRequest request, int certificateProblem) { return true; } } "@ [System.Net.ServicePointManager]::CertificatePolicy = New-Object -TypeName TrustAllCertsPolicy } function New-iDRACSession { [CmdletBinding(HelpUri = "http://idrac4redfish.readthedocs.io/en/latest/functions/New-iDRACSession/")] [OutputType([int])] Param ( # Param1 help description [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true, Position=0)] $iDRAC_IP = "192.168.2.193", $iDRAC_Port = 443, [Parameter(Mandatory=$false, ValueFromPipeline=$true)][pscredential]$Credentials, [switch]$trustCert ) Begin { if ($trustCert.IsPresent) { Unblock-Certs } [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::TLS12 } Process { if (!$Credentials) { $User = Read-Host -Prompt "Please Enter iDRAC username" $SecurePassword = Read-Host -Prompt "Enter iDRAC Password for user $user" -AsSecureString $Credentials = New-Object System.Management.Automation.PSCredential ($user,$Securepassword) } write-Verbose "Generating Login Token" $Global:iDRAC_baseurl = "https://$($iDRAC_IP):$iDRAC_Port" # :$iDRAC_Port" $Global:iDRAC_Credentials = $Credentials Write-Verbose $iDRAC_baseurl try { $Body = @{'UserName'= $($Credentials.UserName);'Password'= $($Credentials.GetNetworkCredential().Password)} |ConvertTo-Json -Compress Write-Verbose $Body $token = Invoke-WebRequest -Uri "$Global:iDRAC_baseurl/redfish/v1/Sessions" -Method Post -Body $Body -ContentType 'application/json' -UseBasicParsing } catch { # Write-Warning $_.Exception.Message Get-iDRACWebException -ExceptionMessage $_ Break } #> $Global:iDRAC_XAUTH = $token.Headers.'X-Auth-Token' $Global:iDRAC_Session_ID = ($token.Content | ConvertFrom-Json).id $Global:iDRAC_Session_URI = $token.Headers.Location $host.ui.RawUI.WindowTitle = "iDRAC IP: $iDRAC_IP, Session $Global:iDRAC_Session_ID for user $($Credentials.username)" Write-Host "Successfully connected to iDRAC with IP $iDRAC_IP and Session ID $iDRAC_Session_ID" Write-Host "we got the following Schemas: " $Global:iDRAC_Headers = @{'X-Auth-Token'= $iDRAC_XAUTH} # | ConvertTo-Json -Compress $Global:iDRAC_Schemas = (Invoke-WebRequest -UseBasicParsing "$Global:iDRAC_baseurl/redfish/v1/odata" -Headers $Global:iDRAC_Headers -ContentType 'Application/Json' ).content | ConvertFrom-Json | select -ExpandProperty value write-host -ForegroundColor Green $idrac_schemas.name #$Schemas Get-iDRACManagerUri Get-iDRACChassisUri Get-iDRACSystemUri } End { } } function Invoke-iDRACRequest { [CmdletBinding(HelpUri = "http://idrac4redfish.readthedocs.io/en/latest/functions/Invoke-iDRACRequest/")] #[OutputType([int])] Param ( # Param1 help description [Parameter(Mandatory=$true)]$uri, [Parameter(Mandatory=$false)][ValidateSet('Get','Delete','Put','Post','Patch')]$Method = 'Get', [Parameter(Mandatory=$false)]$ContentType = 'application/json;charset=utf-8', [Parameter(Mandatory=$false)]$Body ) if ($Global:iDRAC_Headers) { try { Write-verbose "==> Calling $uri with Session $Global:iDRAC_Session_ID" if ($Body) { $Result = Invoke-WebRequest -UseBasicParsing -Uri $Uri -Method $Method -Headers $Global:iDRAC_Headers -ContentType $ContentType -Body $Body } else { $Result = Invoke-WebRequest -UseBasicParsing -Uri $Uri -Method $Method -Headers $Global:iDRAC_Headers -ContentType $ContentType } } catch { # Write-Warning $_.Exception.Message Get-iDRACWebException -ExceptionMessage $_ Break } } else { Write-Host -ForegroundColor White "==> Calling $uri with Basic Auth for User $($Global:iDRAC_Credentials.Username)" if ($Body) { $Result = Invoke-WebRequest -UseBasicParsing -Uri $Uri -Method $Method -Credential $Global:iDRAC_Credentials -ContentType $ContentType -Body $Body } else { $Result = Invoke-WebRequest -UseBasicParsing -Uri $Uri -Method $Method -Credential $Global:iDRAC_Credentials -ContentType $ContentType } } Write-Output $Result } function Disconnect-iDRACSession { [CmdletBinding(DefaultParameterSetName='ByUri', HelpUri = "http://idrac4redfish.readthedocs.io/en/latest/functions/Disconnect-iDRACSession/")] Param ( [Parameter(Mandatory=$false,ParameterSetName = "ByUri", ValueFromPipelineByPropertyName=$true)] [Alias("@odata.id")] $Session_Uri = $Global:iDRAC_Session_URI, [Parameter(Mandatory=$false,ParameterSetName = "ByID", ValueFromPipelineByPropertyName=$true)] [Alias("id")] $Session_ID #[Parameter(Mandatory=$false)]$Idrac_Uri = $Global:iDRAC_baseurl ) begin {} process { if ($Session_ID) { $Session_Uri = "/redfish/v1/Sessions/$Session_ID" } Write-Host -ForegroundColor Green "==> Calling delete $Session_Uri with Session $Global:iDRAC_Session_ID" $Disconnect = Invoke-iDRACRequest -Uri $Global:iDRAC_baseurl$Session_Uri -Method Delete Write-Host ($Disconnect.Content | ConvertFrom-Json).'@Message.ExtendedInfo'.Message } end{} } function Connect-iDRAC { [CmdletBinding()] [OutputType([int])] Param ( # Param1 help description [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true, Position=0)] $iDRAC_IP = "192.168.2.193", $iDRAC_Port = 443, [Parameter(Mandatory=$false, ValueFromPipeline=$true, Position=0)][pscredential]$Credentials, [switch]$trustCert ) Begin { if ($trustCert.IsPresent) { Unblock-Certs } [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::TLS12 } Process { if (!$Credentials) { $User = Read-Host -Prompt "Please Enter iDRAC username" $SecurePassword = Read-Host -Prompt "Enter iDRAC Password for user $user" -AsSecureString $Credentials = New-Object System.Management.Automation.PSCredential ($user,$Securepassword) } write-Verbose "Generating Login Token" $Global:iDRAC_baseurl = "https://$($iDRAC_IP):$iDRAC_Port" # :$iDRAC_Port" $Global:iDRAC_Credentials = $Credentials Write-Verbose $iDRAC_baseurl try { $Schemas = (Invoke-WebRequest -UseBasicParsing "$Global:iDRAC_baseurl/redfish/v1/odata" -Credential $credentials -ContentType 'Application/Json' ).content | ConvertFrom-Json | select -ExpandProperty value } catch { Get-iDRACWebException -ExceptionMessage $_ Break } Write-Host "Successfully connected to iDRAC with IP $iDRAC_IP" Write-Host " we got the following Schemas: " $Global:iDRAC_Schemas = $Schemas write-host $idrac_schemas.name Get-iDRACManagerUri Get-iDRACChassisUri Get-iDRACSystemUri } End { } } function Get-iDRACManagerUri { $Myself = $MyInvocation.MyCommand.Name.Substring(9) -replace "URI" $Schema = ($Global:iDRAC_schemas | where name -Match $Myself).URL $outputobject = (Invoke-iDRACRequest -Uri "$Global:iDRAC_baseurl$Schema").content | ConvertFrom-Json $Global:iDRAC_Manager = "$base_api_uri$($outputobject.Members.'@odata.id')" $Global:iDRAC_OEM = (Get-iDRACodata -odata $iDRAC_Manager).Actions.Oem Write-Verbose "==< Got $Myself URI $Global:iDRAC_Manager" } function Get-iDRACSystemUri { $Myself = $MyInvocation.MyCommand.Name.Substring(9) -replace "URI" $Schema = ($Global:iDRAC_schemas | where name -Match $Myself).URL $outputobject = (Invoke-iDRACRequest -Uri "$Global:iDRAC_baseurl$Schema" ).content | ConvertFrom-Json $Global:iDRAC_System = "$base_api_uri$($outputobject.Members.'@odata.id')" Write-Verbose "==< Got $Myself URI $Global:iDRAC_System" } function Get-iDRACChassisUri { $Myself = $MyInvocation.MyCommand.Name.Substring(9) -replace "URI" $Schema = ($Global:iDRAC_schemas | where name -Match $Myself).URL $outputobject = (Invoke-iDRACRequest -Uri "$Global:iDRAC_baseurl$Schema").content | ConvertFrom-Json $Global:iDRAC_Chassis = "$base_api_uri$($outputobject.Members.'@odata.id')" $Global:iDRAC_Chassis = $Global:iDRAC_Chassis -split " " Write-Verbose "==< Got $Myself URI $Global:iDRAC_Chassis" } function Get-iDRACSystemElement { [CmdletBinding(SupportsShouldProcess,HelpUri = "http://idrac4redfish.readthedocs.io/en/latest/functions/Get-iDRACSystemElement/")] Param ( [Parameter(Mandatory=$false,ValueFromPipelineByPropertyName=$true,ParameterSetName='1')] [Alias("Function")] [ValidateSet('Processors','SimpleStorage','EthernetInterfaces')] $iDRAC_Element ) $system_element = @() if ($iDRAC_Element) { ((Get-iDRACodata $iDRAC_System).$iDRAC_Element | Get-iDRACodata).members | Get-iDRACodata -PStype $iDRAC_Element } else { Get-iDRACodata $iDRAC_System -PStype 'System' } <# $members = (Invoke-iDRACRequest -Uri "$Global:iDRAC_baseurl$Global:iDRAC_System/$iDRAC_Element").content | ConvertFrom-Json if ($members.members.count -gt 1) { foreach ($member in $members.members) { Write-Verbose "==> getting SystemElement $member" $system_element += (Invoke-iDRACRequest -Uri "$Global:iDRAC_baseurl$($member.'@odata.id')").content | ConvertFrom-Json } } else { $system_element = $members[0] } if (!$iDRAC_Element) { $system_element.PSTypeNames.Insert(0, "System") } else { $system_element.PSTypeNames.Insert(0, "$iDRAC_Element") } Write-Output $system_element #> } function Get-iDRACChassisElement { [CmdletBinding(SupportsShouldProcess,HelpUri = "http://idrac4redfish.readthedocs.io/en/latest/functions/Get-iDRACChassisElement/")] Param ( [Parameter(Mandatory=$false,ValueFromPipelineByPropertyName=$true,ParameterSetName='1')] [Alias("Function")] [ValidateSet('Power','Thermal')] $iDRAC_Element ) $members = @() $Chassis_element = @() foreach ($chassis in $Global:iDRAC_Chassis) { Write-Verbose $chassis $members = (Invoke-iDRACRequest -Uri "$Global:iDRAC_baseurl$chassis/$iDRAC_Element").content | ConvertFrom-Json if ($members.count -gt 1) { #$members foreach ($member in $members.member) { Write-Verbose "==> getting ChassisElement $($member.'@odata.id')" $Chassis_element += (Invoke-iDRACRequest -Uri "$Global:iDRAC_baseurl$($member.'@odata.id')").content | ConvertFrom-Json } } else { $Chassis_element = $members[0] } if ($iDRAC_Element) { $Chassis_element.PSTypeNames.Insert(0, "$iDRAC_Element") } else { $Chassis_element.PSTypeNames.Insert(0, "Chassis") } Write-Output $Chassis_element } } function Get-iDRACManagerElement { [CmdletBinding(SupportsShouldProcess)] Param ( [Parameter(Mandatory=$false,ValueFromPipelineByPropertyName=$true,ParameterSetName='1')] [Alias("Function")] [ValidateSet('LogServices','NetworkProtocol',' ')] $iDRAC_Element ) $members = @() $Manager_element = @() $members = Get-iDRACodata "$Global:iDRAC_Manager/$iDRAC_Element" if ($($members.members)) { $Manager_element += ($($members.members) | Get-iDRACodata -PStype $iDRAC_Element ) } else { $Manager_element = $members[0] if ($iDRAC_Element) { $Manager_element.PSTypeNames.Insert(0, "idrac.$iDRAC_Element") } else { $Manager_element.PSTypeNames.Insert(0, "idrac.Manager") } } Write-Output $Manager_element } function Get-iDRACLifecycleLog { [CmdletBinding(SupportsShouldProcess)] Param ( #[Parameter(Mandatory=$false,ValueFromPipelineByPropertyName=$true,ParameterSetName= #[Alias("Function")] #[ValidateSet('LogServices','NetworkProtocol')] #$iDRAC_Element ) $members = @() $lclogs = @() $members = (Invoke-iDRACRequest -Uri "$Global:iDRAC_baseurl$Global:iDRAC_Manager/Logs/Lclog").content | ConvertFrom-Json foreach ($member in $members.members) { $member.PSTypeNames.Clear() $member.PSTypeNames.insert(0,'idrac.lclog') $lclogs += $member } Write-Output $lclogs } function Get-iDRACodata { [CmdletBinding(SupportsShouldProcess,HelpUri = "http://idrac4redfish.readthedocs.io/en/latest/functions/Get-iDRACodata/")] Param ( [Parameter(Mandatory=$true,ValueFromPipelineByPropertyName=$true,ParameterSetName='1',Position = 0)] [Alias("@odata.id")] $odata, [Parameter(Mandatory=$false,ValueFromPipelineByPropertyName=$true,ParameterSetName='1',Position = 1)] [Alias("mytype")] $PStype ) begin { } process { Write-Verbose "==> getting elements for odata Link $odata" $Request = (Invoke-iDRACRequest -Uri "$Global:iDRAC_baseurl$($odata)").content | ConvertFrom-Json if ($PStype) { $Request.PSTypeNames.Clear() $Request.PSTypeNames.insert(0,"iDRAC.$($PStype)") } $Request } end { } } function Get-iDRACSessions { [CmdletBinding(HelpUri = "http://idrac4redfish.readthedocs.io/en/latest/functions/Get-iDRACSessions/")] $Sessions = @() $iDRAC_Sessions = @() $Sessions = ((Invoke-iDRACRequest -uri $iDRAC_baseurl/redfish/v1/Sessions).Content | ConvertFrom-Json).members $Sessions | Get-iDRACodata -PStype Sessions } function Copy-iDRACSCP { param( [Parameter(Mandatory=$true, ValueFromPipeline=$true)]$Cifs_IP, [Parameter(Mandatory=$false, ValueFromPipeline=$true)][pscredential]$Credentials, [Parameter(Mandatory=$true, ValueFromPipeline=$true)]$Cifs_Sharename, [Parameter(Mandatory=$false, ValueFromPipeline=$true)]$Filename = "SCP_XML.xml", [Parameter(Mandatory=$false, ValueFromPipeline=$true)] [ValidateSet("ALL", "IDRAC", "BIOS", "NIC", "RAID")]$Target = "ALL", <#"ALL", "IDRAC", "BIOS", "NIC", "RAID"#> [Parameter(Mandatory=$false, ValueFromPipeline=$true)][switch]$waitcomplete ) $Target_Uri = $Global:iDRAC_OEM.'OemManager.v1_0_0#OemManager.ExportSystemConfiguration'.Target if (!$Credentials) { $User = Read-Host -Prompt "Please Enter CIFS username for $Cifs_IP" $SecurePassword = Read-Host -Prompt "Enter CIFS Password for user $user" -AsSecureString $Credentials = New-Object System.Management.Automation.PSCredential ($user,$Securepassword) } $JsonBody = @{ ExportFormat ="XML" ShareParameters = @{ Target=$Target IPAddress=$Cifs_IP ShareName=$Cifs_Sharename ShareType="CIFS" UserName=$Credentials.UserName Password=$Credentials.GetNetworkCredential().Password FileName=$Filename}} | ConvertTo-Json #$JsonBody $result = Invoke-iDRACRequest -uri "$iDRAC_baseurl$Target_Uri" -Method Post -Body $JsonBody -ContentType 'Application/json' # if ($waitcomplete.IsPresent) { Write-Host -ForegroundColor Yellow -NoNewline "Waiting for Task $($result.Headers.location)" do {sleep 5} until ((Get-iDRACodata -odata $($result.Headers.location)).TaskState -eq 'Completed') Write-Host -ForegroundColor Green "[Task Completed]" } else { Write-Host "You can Monitor the Task by 'Get-iDRACodata $($result.Headers.location)'" } Get-iDRACodata -odata $result.Headers.location } function Get-iDRACAccounts { [CmdletBinding()] Param ( [Parameter(ParameterSetName = "1", Mandatory = $False)]$AccountID ) $iDRAC_Accounts = @() $Myself = $MyInvocation.MyCommand.Name.Substring(9) if ($AccountID) { $iDRAC_Accounts = (Get-iDRACodata -odata $Global:iDRAC_Manager/$Myself/$AccountID) $iDRAC_Accounts.PSTypeNames.insert(0,"iDRAC.$($PStype)") } else { $iDRAC_Accounts = (Get-iDRACodata -odata $Global:iDRAC_Manager/$Myself).Members | Get-iDRACodata -PStype $Myself } Write-Output $iDRAC_Accounts } function Set-iDRACAccount { [CmdletBinding(HelpUri = "http://idrac4redfish.readthedocs.io/en/latest/functions/Set-IDRACAccount")] param ( [Parameter(ParameterSetName = "1", Mandatory = $false, ValueFromPipelineByPropertyName = $True)] [ValidateSet('Administrator','Operator','User','None')]$RoleID, [Parameter(ParameterSetName = "1", Mandatory = $True, ValueFromPipelineByPropertyName = $false)][securestring]$User_Password, [Parameter(ParameterSetName = "1", Mandatory = $True, ValueFromPipelineByPropertyName = $True)][ALIAS('ID')]$AccountID, [Parameter(ParameterSetName = "1", Mandatory = $True, ValueFromPipelineByPropertyName = $True)]$username ) begin { if (!$User_Password) { $User_Password = Read-Host -Prompt "Enter Password for user $username" -AsSecureString } } process { $PlainPassword = ([System.Runtime.InteropServices.marshal]::PtrToStringAuto([System.Runtime.InteropServices.marshal]::SecureStringToBSTR($user_Password))) $Json_body = @{"UserName" = $username;"RoleId" = $Role ;"Password" = $PlainPassword } | ConvertTo-Json -Compress write-verbose $Json_body $Message = Invoke-iDRACRequest -uri $Global:iDRAC_baseurl$Global:iDRAC_Manager/Accounts/$AccountID -Body $Json_body -Method Patch -ContentType "application/json" write-host ($message.Content |ConvertFrom-Json).'@Message.ExtendedInfo'.Message } End {} } |