scripts/PowerControl.ps1
|
# Copyright (C) 2020 Huawei Technologies Co., Ltd. All rights reserved. # This program is free software; you can redistribute it and/or modify # it under the terms of the MIT License # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # MIT License for more detail <# NOTE: iBMC Power Control module Cmdlets #> function Set-iBMCFruControl { <# .SYNOPSIS Perform power control on a field replaceable unit (FRU). .DESCRIPTION Perform power control on a field replaceable unit (FRU). Note: This cmdlet may affect the normal operation of system. It should be used with caution. .PARAMETER Session iBMC redfish session object which is created by Connect-iBMC cmdlet. A session object identifies an iBMC server to which this cmdlet will be executed. .PARAMETER FRU Indicates the FRU to control. Available Value Set: OS, Base, Fabric, FC. .PARAMETER ControlType Indicates the FRU power control type. Available Value Set: On, GracefulShutdown, ForceRestart, Nmi, ForcePowerCycle. - On: power on the Server. - GracefulShutdown: gracefully shut down the Server. - ForceRestart: forcibly restart the Server. - Nmi: triggers a non-maskable interrupt (NMI). - ForcePowerCycle: forcibly power off and then power on the Server. .OUTPUTS None Returns None if cmdlet executes successfully. In case of an error or warning, exception will be returned. .EXAMPLE PS C:\> $credential = Get-Credential PS C:\> $session = Connect-iBMC -Address 10.1.1.2 -Credential $credential -TrustCert PS C:\> Set-iBMCFruControl -Session $session -FRU OS -ControlType On .LINK https://github.com/Huawei/Huawei-iBMC-Cmdlets Connect-iBMC Disconnect-iBMC #> [CmdletBinding()] param ( [RedfishSession[]] [parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true, Position = 0)] $Session, [FRU[]] [parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true, Position = 1)] $FRU, [ControlType[]] [parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true, Position = 1)] $ControlType ) begin { } process { Assert-ArrayNotNull $Session 'Session' Assert-ArrayNotNull $ControlType 'ControlType' Assert-ArrayNotNull $FRU 'FRU' $FRUList = Get-MatchedSizeArray $Session $FRU $PowerControlTypeList = Get-MatchedSizeArray $Session $ControlType $Logger.info("Invoke Control iBMC Server Power function") $ScriptBlock = { param($RedfishSession, $Payload) $(Get-Logger).info($(Trace-Session $RedfishSession "Invoke Control iBMC Server Power now")) $Path = "/Systems/$($RedfishSession.Id)/Actions/Oem/Huawei/ComputerSystem.FruControl" $Logger.info($(Trace-Session $RedfishSession "Sending payload: $($Payload | ConvertTo-Json)")) Invoke-RedfishRequest $RedfishSession $Path 'POST' $Payload | Out-Null return $null } try { $tasks = New-Object System.Collections.ArrayList $pool = New-RunspacePool $Session.Count for ($idx = 0; $idx -lt $Session.Count; $idx++) { $RedfishSession = $Session[$idx] $Payload = @{ FruControlType=$PowerControlTypeList[$idx]; FruID=$FRUList[$idx].value__; } | Resolve-EnumValues $Parameters = @($RedfishSession, $Payload) $Logger.info($(Trace-Session $RedfishSession "Submit Control iBMC Server Power task")) [Void] $tasks.Add($(Start-ScriptBlockThread $pool $ScriptBlock $Parameters)) } $Results = Get-AsyncTaskResults $tasks return ,$Results } finally { Close-Pool $pool } } end { } } function Set-iBMCServerPower { <# .SYNOPSIS Reset iBMC Server Power. .DESCRIPTION Reset iBMC Server Power. Note: This cmdlet may affect the normal operation of system. It should be used with caution. .PARAMETER Session iBMC redfish session object which is created by Connect-iBMC cmdlet. A session object identifies an iBMC server to which this cmdlet will be executed. .PARAMETER ResetType Indicates the Server reset type. Available Value Set: On, ForceOff, GracefulShutdown, ForceRestart, Nmi, ForcePowerCycle. - On: power on the Server. - ForceOff: forcibly powers on the server. - GracefulShutdown: gracefully shut down the OS. - ForceRestart: forcibly restart the Server. - Nmi: triggers a non-maskable interrupt (NMI). - ForcePowerCycle: forcibly power off and then power on the Server. .OUTPUTS None Returns None if cmdlet executes successfully. In case of an error or warning, exception will be returned. .EXAMPLE PS C:\> $credential = Get-Credential PS C:\> $session = Connect-iBMC -Address 10.1.1.2 -Credential $credential -TrustCert PS C:\> Set-iBMCServerPower -Session $session -ResetType ForceRestart .LINK https://github.com/Huawei/Huawei-iBMC-Cmdlets Connect-iBMC Disconnect-iBMC #> [CmdletBinding()] param ( [RedfishSession[]] [parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true, Position = 0)] $Session, [ResetType[]] [parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true, Position = 1)] $ResetType ) begin { } process { Assert-ArrayNotNull $Session 'Session' Assert-ArrayNotNull $ResetType 'ResetType' $ResetTypeList = Get-MatchedSizeArray $Session $ResetType $Logger.info("Invoke Reset iBMC Server function") $ScriptBlock = { param($RedfishSession, $Payload) $(Get-Logger).info($(Trace-Session $RedfishSession "Invoke Reset iBMC Server now")) $Path = "/Systems/$($RedfishSession.Id)/Actions/ComputerSystem.Reset" $Logger.info($(Trace-Session $RedfishSession "Sending payload: $($Payload | ConvertTo-Json)")) Invoke-RedfishRequest $RedfishSession $Path 'POST' $Payload | Out-Null return $null } try { $tasks = New-Object System.Collections.ArrayList $pool = New-RunspacePool $Session.Count for ($idx = 0; $idx -lt $Session.Count; $idx++) { $RedfishSession = $Session[$idx] $Payload = @{ "ResetType" = $ResetTypeList[$idx]; } | Resolve-EnumValues $Parameters = @($RedfishSession, $Payload) $Logger.info($(Trace-Session $RedfishSession "Submit Reset iBMC Server task")) [Void] $tasks.Add($(Start-ScriptBlockThread $pool $ScriptBlock $Parameters)) } $Results = Get-AsyncTaskResults $tasks return ,$Results } finally { Close-Pool $pool } } end { } } |