HPRESTExamples.ps1
|
<#
(c) Copyright 2015 Hewlett-Packard Development Company, L.P. All rights reserved. Licensed under the Apache License, Version 2.0 (the "License"); You may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. These examples use HP REST PowerShell cmdlets available at http://www.powershellgallery.com/packages/HPRESTCmdlets/. These scripts provide examples of using HP RESTful API on HP iLO for common use cases. These examples use the following base set of cmdlets: Connect-HPREST Disconnect-HPREST Edit-HPRESTData Find-HPREST Format-HPRESTDir Get-HPRESTData Get-HPRESTDataRaw Get-HPRESTDir Get-HPRESTError Get-HPRESTHttpData Get-HPRESTIndex Get-HPRESTSchema Get-HPRESTSchemaExtref Get-HPRESTUriFromHref Invoke-HPRESTAction Remove-HPRESTData Set-HPRESTData #> #iLO IP address and credentials to access the iLO $Address = '192.184.217.212' $cred = Get-Credential function Set-BIOSExample1 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $BIOSProperty, [System.String] $Value ) Write-Host 'Example 1: Change a BIOS Setting' #create session $session = Connect-HPREST -Address $Address -Credential $Credential #Get list of systems $systems = Get-HPRESTDataRaw -Href 'rest/v1/systems' -Session $session foreach($sys in $systems.links.member.href) # rest/v1/systems/1, rest/v1/system/2 { #Get BIOS URI from system data $data = Get-HPRESTDataRaw -Href $sys -Session $session $biosURI = $data.Oem.Hp.links.BIOS.href #get BIOS Data $biosData = Get-HPRESTDataRaw -Href $biosURI -Session $session #if property to be modified is not present in the bios data, then print error message and return if(-not(($biosData|Get-Member).Name -contains $BIOSProperty)) { Write-Host "Property $BIOSProperty is not supported on this system" } else { #Get setting href to update bios property. For bios, property can be updated in the settings href only. Other data may or may not have setting href #creating setting object $biosSetting = @{} $biosSetting.Add($BIOSProperty,$Value) #updating setting in system bios settings $ret = Set-HPRESTData -Href $biosURI -Setting $biosSetting -Session $session # processing message obtained by executing Set- cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } } # disconnecting the session after use Disconnect-HPREST -Session $session } #Set-BIOSExample1 -Address $Address -Credential $cred -BIOSProperty 'AdminName' -Value 'test admin' function Reset-ServerExample2 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $Action, [System.String] $PropertyName, [System.String] $PropertyValue ) Write-Host 'Example 2: Reset the server.' #create session $session = Connect-HPREST -Address $Address -Credential $Credential # getting system list $systems = Get-HPRESTDataRaw -Href 'rest/v1/systems' -Session $session foreach($sys in $systems.links.member.href) # rest/v1/systems/1, rest/v1/system/2 { # creating setting object to invoke reset action. # Details of invoking reset (or other possible actions) is present in 'AvailableActions' of system data $dataToPost = @{} $dataToPost.Add('Action',$Action) $dataToPost.Add($PropertyName,$PropertyValue) # Sending reset request to system using 'POST' in Invoke-HPRESTAction $ret = Invoke-HPRESTAction -Href $sys -Data $dataToPost -Session $session # processing message obtained by executing Set- cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } # disconnect the session after use Disconnect-HPREST -Session $session } #Reset-ServerExample2 -Address $Address -Credential $cred -Action Reset -PropertyName ResetType -PropertyValue ForceRestart function Set-SecureBootExample3 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $SecureBootProperty, # schema allows changing values for SecureBootEnable, ResetToDefaultKeys, ResetAllKeys [Boolean] $Value #value must be a boolean i.e. $true or $false ) Write-Host 'Example 3: Enable/Disable UEFI secure boot' #create session $session = Connect-HPREST -Address $Address -Credential $Credential $systems = Get-HPRESTDataRaw -Href 'rest/v1/systems' -Session $session foreach($sys in $systems.links.member.href) # rest/v1/systems/1, rest/v1/system/2 { #Get secure boot URI $sysData = Get-HPRESTDataRaw -Href $sys -Session $session $secureBootURI = $sysData.Oem.Hp.links.SecureBoot.href #get secure boot data and display original value $secureBootData = Get-HPRESTDataRaw -Href $secureBootURI -Session $session $secureBootData #if property to be modified is not present in the secure boot data, then print error message and return if(-not(($secureBootData|Get-Member).Name -Contains $SecureBootProperty)) { Write-Host "Property $SecureBootProperty is not supported on this system" } else { # use Set cmdlet at Secure Boot href to update secure boot property. Here only boolean values are allowed for Value parameter # creating hashtable object with property and value $secureBootSetting = @{$SecureBootProperty=$Value} # Execute Set- cmdlet to post enable/disable setting at href for secure boot $ret = Set-HPRESTData -Href $secureBootURI -Setting $SecureBootSetting -Session $session # processing message obtained by executing Set- cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } # get and display updated value of the property $secureBootData = Get-HPRESTDataRaw -Href $secureBootURI -Session $session $secureBootData } } # disconnect the session after use Disconnect-HPREST -Session $session } #Set-SecureBootExample3 -Address $Address -Credential $cred -SecureBootProperty 'SecureBootEnable' -Value $true function Set-BIOSDefaultExample4 { param ( [System.String] $Address, [PSCredential] $Credential, [System.Object] $InitializationSetting ) Write-Host 'Example 4: Set default BIOS settings' #create session $session = Connect-HPREST -Address $Address -Credential $Credential $systems = Get-HPRESTDataRaw -Href 'rest/v1/systems' -Session $session foreach($sys in $systems.links.member.href) # rest/v1/systems/1, rest/v1/system/2 { #Get BIOS URI $sysData = Get-HPRESTDataRaw -Href $sys -Session $session $biosURI = $sysData.Oem.Hp.links.BIOS.href #get BIOS Data and obtain the setting href from it $biosData = Get-HPRESTDataRaw -Href $biosURI -Session $session $biosSettingURI = $biosData.links.settings.href # use BIOS setting URI to obtain setting data $biosSettingData = Get-HPRESTDataRaw -Href $biosSettingURI -Session $session # create bios setting object $newBiosSetting=@{} $newBiosSetting.Add('BaseConfig','Default') # preserve the Type property from the existing BIOS settings to avoid error $newBiosSetting.Add('Type',$biosSettingData.Type) # add other optional initialization settings provided by the user if(-not ($InitializationSetting -eq '' -or $InitializationSetting -eq $null)) { if($InitializationSetting.GetType().ToString() -eq 'System.Management.Automation.PSCustomObject') { foreach($prop in $InitializationSetting.PSObject.Properties) { $newBiosSetting.Add($prop.Name,$prop.Value) } } elseif($InitializationSetting.GetType().ToString() -eq 'System.Collections.Hashtable') { foreach($ky in $InitializationSetting.Keys) { $newBiosSetting.Add($ky,$InitializationSetting[$ky]) } } else { Write-Host 'Invalid input type for InitializationSetting parameter. Use PSObject or PowerShell Hashtable' -ForegroundColor red } } # execure HTTP PUT command using Edit-HPRESTData cmdlet to set BIOS default settings $ret = Edit-HPRESTData -Href $biosSettingURI -Setting $newBiosSetting -Session $session # process returned message from Edit-HPRESTData cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } # disconnect the session after use Disconnect-HPREST -Session $session } <# Set-BIOSDefaultExample4 -Address $Address -Credential $cred ## reset makes the BIOS property change effective Reset-ServerExample2 -Address $Address -Credential $cred -Action Reset -PropertyName ResetType -PropertyValue ForceRestart #> function Set-BootOrderExample5 { # Changes the boot order by swapping the first two boot options in the persistant boot order list param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host 'Example 5: Set boot order (UEFI)' #create session $session = Connect-HPREST -Address $Address -Credential $Credential $systems = Get-HPRESTDataRaw -Href 'rest/v1/systems' -Session $session foreach($sys in $systems.links.member.href) # rest/v1/systems/1, rest/v1/system/2 { #Get BIOS URI $sysData = Get-HPRESTDataRaw -Href $sys -Session $session $biosURI = $sysData.Oem.Hp.links.BIOS.href #get BIOS Data $biosData = Get-HPRESTDataRaw -Href $biosURI -Session $session $bootURI = $biosData.links.Boot.href $bootData = Get-HPRESTDataRaw -Href $bootURI -Session $session $bootData.PersistentBootConfigOrder #if property to be modified is not present in the bios data, then print error message and return if(-not(($bootData|Get-Member).Name.Contains('PersistentBootConfigOrder'))) { Write-Host 'Property PersistentBootConfigOrder is not supported on this system' } else { # changing boot order by interchanging first and second items in the list. Other orders can also be used $bootOrder = $bootData.PersistentBootConfigOrder # |ConvertFrom-Json $temp = $bootOrder[0] $bootorder[0] = $bootOrder[1] $bootOrder[1] = $temp # Getting the href location where the order change has to be 'PATCHed' $bootSettingURI = $bootData.links.settings.href # create object to PATCH $persistentBootConfig = @{'PersistentBootConfigOrder'=$bootOrder} # execute HTTP PATCH operation using Set-HPRESTData cmdlet $ret = Set-HPRESTData -Href $bootSettingURI -Setting $persistentBootConfig -Session $session # process returned message from Set-HPRESTData cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } } # disconnect the session after use Disconnect-HPREST -Session $session } <# #---------------------------------------------------------------------------------------------# ## change boot order. Internally the example swaps first and second boot targets. Set-BootOrderExample5 -Address $Address -Credential $cred ##reset maked the boot order effective Reset-ServerExample2 -Address $Address -Credential $cred -Action Reset -PropertyName ResetType -PropertyValue ForceRestart #### wait for server to reboot and POST. (Change sleep time as required) Start-Sleep -Seconds 300 ## change boot order to original by swapping back the first two boot targets Set-BootOrderExample5 -Address $Address -Credential $cred ##reset makes the boot order effective Reset-ServerExample2 -Address $Address -Credential $cred -Action Reset -PropertyName ResetType -PropertyValue ForceRestart #---------------------------------------------------------------------------------------------# #> function Set-TempBootOrderExample6 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $BootTarget ) Write-Host 'Example 6: Set one-time(temporary)boot order' #create session $session = Connect-HPREST -Address $Address -Credential $Credential #Get system list $systems = Get-HPRESTDataRaw -Href 'rest/v1/systems' -Session $session foreach($sys in $systems.links.member.href) # rest/v1/systems/1, rest/v1/system/2 { # get boot data for the system $data = Get-HPRESTDataRaw -Href $sys -Session $session $data.Boot # print available boot targets Write-Host 'Supported boot targets are' $data.boot.BootSourceOverrideSupported if(-not($data.Boot.BootSourceOverrideSupported -Contains $BootTarget)) { # if user provided not supported then print error Write-Host "$BootTarget not supported" } else { # create object to PATCH $tempBoot = @{'BootSourceOverrideTarget'=$BootTarget} $OneTimeBoot = @{'Boot'=$tempBoot} # PATCH the data using Set-HPRESTData cmdlet $ret = Set-HPRESTData -Href $sys -Setting $OneTimeBoot -Session $session #process message returned by Set-HPRESTData cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } #get and print updated value $bootData = Get-HPRESTDataRaw -Href $sys -Session $session $bootData.Boot } } # disconnect the session after use Disconnect-HPREST -Session $session } ## NOTE: check the boot targets supported in BootSourceOverrideSupported $data.Boot.BootSourceOverrideSupported. The value is case sensitive. ## E.g. Pxe will work, pxe will not #Set-TempBootOrderExample6 -Address $Address -Credential $cred -BootTarget 'Hdd' function Get-iLOMACAddressExample7 { param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host "Example 7: Find iLO's MAC addresses" #create session $session = Connect-HPREST -Address $Address -Credential $Credential $mgr = Get-HPRESTDataRaw -Href 'rest/v1/managers' -Session $session foreach($hrefVal in $mgr.links.member.href) # rest/v1/systems/1, rest/v1/system/2 { #Get manager data $managerData = Get-HPRESTDataRaw -Href $hrefVal -Session $session # retrieve ethernet NIC details $nicURI = $managerData.links.EthernetNICs.href $nicData = Get-HPRESTDataRaw -Href $nicURI -Session $session foreach($nic in $nicData.items) { Write-Host $managerData.Model - $nic.Name - $nic.MacAddress } } # disconnect session after use Disconnect-HPREST -Session $session } #Get-iLOMACAddressExample7 -Address $Address -Credential $cred function Add-iLOUserAccountExample8 { # NOTE: '(400) Bad Request' error will be thrown if the user already exists param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $newiLOLoginName, [System.String] $newiLOUserName, [System.String] $newiLOPassword, [Boolean] $RemoteConsolePriv = $false, [Boolean] $ConfigPriv = $false, [Boolean] $VirtualMediaPriv = $false, [Boolean] $UserConfigPriv = $false, [Boolean] $VirtualPowerResetPriv = $false ) Write-Host 'Example 8: Create an iLO user account.' #create session $session = Connect-HPREST -Address $Address -Credential $Credential # Get AccountService data to obtain Accounts href $accData = Get-HPRESTDataRaw -Href 'rest/v1/AccountService' -Session $session $accURI = $accData.links.Accounts.href # create iLO user object # add permissions $priv = @{} $priv.Add('RemoteConsolePriv',$RemoteConsolePriv) $priv.Add('iLOConfigPriv',$ConfigPriv) $priv.Add('VirtualMediaPriv',$VirtualMediaPriv) $priv.Add('UserConfigPriv',$UserConfigPriv) $priv.Add('VirtualPowerAndResetPriv',$VirtualPowerResetPriv) # add login name $hp = @{} $hp.Add('LoginName',$newiLOLoginName) $hp.Add('Privileges',$priv) $oem = @{} $oem.Add('Hp',$hp) # add username and password for access $user = @{} $user.Add('UserName',$newiLOUserName) $user.Add('Password',$newiLOPassword) $user.Add('Oem',$oem) # execute HTTP POST method using Invoke-HPRESTAction to add user data at Accounts href $ret = Invoke-HPRESTAction -Href $accURI -Data $user -Session $session # process messages returned by Invoke-HPRESTAction cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } # Print the list of users. New user will be in this list $accData = Get-HPRESTDataRaw -Href $accData.links.Accounts.href -Session $session $accData.Items # disconnect session after use Disconnect-HPREST -Session $session } #Add-iLOUserAccountExample8 -Address $Address -Credential $cred -newiLOLoginName 'timh' -newiLOUserName 'TimHorton' -newiLOPassword 'timPassword123' -RemoteConsolePriv $true function Set-iLOUserAccountExample9 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $LoginNameToModify, [System.String] $newLoginName = '', [System.String] $newUsername = '', [System.String] $newPassword = '', [System.Object] $RemoteConsolePriv = $null, [System.Object] $ConfigPriv = $null, [System.Object] $VirtualMediaPriv = $null, [System.Object] $UserConfigPriv = $null, [System.Object] $VirtualPowerResetPriv = $null ) Write-Host 'Example 9: Modify an iLO user account.' #create session $session = Connect-HPREST -Address $Address -Credential $Credential # get the href of the iLO user accounts $accData = Get-HPRESTDataRaw -Href 'rest/v1/AccountService' -Session $session $accURI = $accData.links.Accounts.href $members = Get-HPRESTDataRaw -Href $accURI -Session $session $foundFlag = $false $memberURI = '' $user = $null foreach($member in $members.Items) { # check if user is present in the user list if($member.Username -eq $LoginNameToModify) { $foundFlag = $true $memberURI = $member.links.self.href # Create user object with new value(s) $priv = @{} if($RemoteConsolePriv -ne $null){$priv.Add('RemoteConsolePriv',[System.Convert]::ToBoolean($RemoteConsolePriv))} if($ConfigPriv -ne $null){$priv.Add('iLOConfigPriv',[System.Convert]::ToBoolean($ConfigPriv))} if($VirtualMediaPriv -ne $null){$priv.Add('VirtualMediaPriv',[System.Convert]::ToBoolean($VirtualMediaPriv))} if($UserConfigPriv -ne $null){$priv.Add('UserConfigPriv',[System.Convert]::ToBoolean($UserConfigPriv))} if($VirtualPowerResetPriv -ne $null){$priv.Add('VirtualPowerAndResetPriv',[System.Convert]::ToBoolean($VirtualPowerResetPriv))} $hp = @{} if($newLoginName -ne ''){$hp.Add('LoginName',$newLoginName)} if($priv.Count -gt 0){$hp.Add('Privileges',$priv)} $oem = @{} if($hp.Count -gt 0){$oem.Add('Hp',$hp)} $user = @{} if($newUserName -ne ''){$user.Add('UserName',$newUserName)} if($newPassword -ne ''){$user.Add('Password',$newPassword)} if($oem.Count -gt 0){$user.Add('Oem',$oem)} break } } if($foundFlag -eq $true) { # WARNING: If you don't change anything, you will get an HTTP 400 back # PATCH the data using Set-HPRESTData $ret = Set-HPRESTData -Href $memberURI -Setting $user -Session $session if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } # If user name is not found, print message else { Write-Error "$LoginNameToModify not present" } # Disconnect session after use Disconnect-HPREST -Session $session } #Set-iLOUserAccountExample9 -Address $Address -Credential $cred -LoginNameToModify 'TimHorton' -RemoteConsolePriv $false function Remove-iLOUserAccountExample10 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $LoginNameToRemove ) Write-Host 'Example 10: Delete an iLO user account.' #create session $session = Connect-HPREST -Address $Address -Credential $Credential $accData = Get-HPRESTDataRaw -Href 'rest/v1/AccountService' -Session $session $accURI = $accData.links.Accounts.href $members = Get-HPRESTDataRaw -Href $accURI -Session $session $foundFlag = $false $memberURI = '' foreach($member in $members.Items) { # If user to delete is found in user list, note the href of that user in memberURI variable if($member.Username -eq $LoginNameToRemove) { $foundFlag = $true $memberURI = $member.links.self.href break } } if($foundFlag -eq $true) { # If the user was found, executet the HTTP DELETE method on the href of the user to be deleted. $ret = Remove-HPRESTData -Href $memberURI -Session $session # process message(s) from Remove-HPRESTData cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } # print list of users. Deleted user will not be present in the list $accData = Get-HPRESTDataRaw -Href $accData.links.Accounts.href -Session $session $accData.Items } else { Write-Error "$LoginNameToRemove not present" } # Disconnect session after use Disconnect-HPREST -Session $session } #Remove-iLOUserAccountExample10 -Address $Address -Credential $cred -LoginNameToRemove TimHorton function Get-ActiveiLONICExample11 { param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host 'Example 11: Retrieve active iLO NIC information' # create session $session = Connect-HPREST -Address $Address -Credential $Credential # retrieve manager list $managers = Get-HPRESTDataRaw -Href 'rest/v1/Managers' -Session $session foreach($manager in $managers.links.Member.href) { # retrieve manager details and the ethernetNIC href from that $managerData = Get-HPRESTDataRaw -Href $manager -Session $session $nicURI = $managerData.links.EthernetNICs.href # retrieve all NIC information $nics = Get-HPRESTDataRaw -Href $nicURI -Session $session # print NIC details for enabled i.e. active NIC foreach($nic in $nics.items) { if($nic.Status.State -eq 'Enabled') { $nic } } } # Disconnect session after use Disconnect-HPREST -Session $session } #Get-ActiveiLONICExample11 -Address $Address -Credential $cred function Get-SessionExample12 { param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host 'Example 12: Retrieve current session information' # connect session $session = Connect-HPREST -Address $Address -Credential $Credential # retrieve all sessions $sessions = Get-HPRESTDataRaw -Href 'rest/v1/Sessions' -Session $session #get the details of current session foreach($ses in $sessions.Items) { if($ses.Oem.Hp.MySession -eq $true) { $ses $ses.oem.hp } } # disconnect session after use Disconnect-HPREST -Session $session } #Get-SessionExample12 -Address $Address -Credential $cred function Set-UIDStateExample13 { param ( [System.String] $Address, [PSCredential] $Credential, [ValidateSet('Lit','Off')] [System.String] $UIDState # Use 'Lit' or 'Off'. Value identified by 'IndicatorLED' field in 'rest/v1/Systems/1'. The value 'Blinking' in mentioned in the schema is not settable by the user. ) Write-Host 'Example 13: Change UID/IndicatorLED status' # connect session $session = Connect-HPREST -Address $Address -Credential $Credential # retrieve list of systems $systems = Get-HPRESTDataRaw -Href 'rest/v1/Systems' -Session $session foreach($sys in $systems.links.Member.href) { # get the href of the system to PATCH the Indicator LED value $sysData = Get-HPRESTDataRaw -Href $sys -Session $session $sysURI = $sysData.links.self.href # create hashtable object to PATCH $UIDSetting = @{'IndicatorLED'=$UIDState} # PATCH the data using Set-HPRESTData cmdlet $ret = Set-HPRESTData -Href $sysURI -Setting $UIDSetting -Session $session # process the message(s) from Set-HPRESTData if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } # Disconnect the session after use Disconnect-HPREST -Session $session } ## NOTE: UID State - Unknown, Lit, Blinking, Off. Unknown and Blinking cannot be set by user #Set-UIDStateExample13 -Address $Address -Credential $cred -UIDState 'Off' function Get-ComputerSystemExample14 { param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host 'Example 14: Retrieve information of computer systems' # connect session $session = Connect-HPREST -Address $Address -Credential $Credential # retrieve list of computer systems $systems = Get-HPRESTDataRaw -Href 'rest/v1/Systems' -Session $session # print details of all computer systems foreach($sys in $systems.links.Member.href) { $sysData = Get-HPRESTDataRaw -Href $sys -Session $session $sysData } # Disconnect session after use Disconnect-HPREST -Session $session } #Get-ComputerSystemExample14 -Address $Address -Credential $cred function Set-VirutalMediaExample15 { param ( [System.String] $Address, [PSCredential] $Credential, [System.Object] $IsoUrl = $null, [System.Object] $BootOnNextReset = $null ) # NOTE: if ISO URL is blank and BootOnNextReset are blank/null, the virtual media is unmounted Write-Host 'Example 15 : Mount/Unmount virtual media DVD using URL' # Connect session $session = Connect-HPREST -Address $Address -Credential $Credential $managers = Get-HPRESTDataRaw -Href 'rest/v1/Managers' -Session $session foreach($mgr in $managers.links.Member.href) { $mgrData = Get-HPRESTDataRaw -Href $mgr -Session $session # Check if virtual media is supported if($mgrData.links.PSObject.Properties.name -Contains 'VirtualMedia' -eq $false) { # If virtual media is not present in links under manager details, print error Write-Host 'Virtual media not available in Manager links' } else { $vmhref = $mgrData.links.VirtualMedia.href $vmdata = Get-HPRESTDataRaw -Href $vmhref -Session $session foreach($vm in $vmdata.links.Member.href) { $data = Get-HPRESTDataRaw -Href $vm -Session $session # select the media option which contains DVD if($data.MediaTypes -contains 'DVD') { # Create object to PATCH to update ISO image URI and to set if($IsoUrl -eq $null) { $mountSetting = @{'Image'=$null} } else { $mountSetting = @{'Image'=[System.Convert]::ToString($IsoUrl)} } if($BootOnNextReset -ne $null -and $IsoUrl -ne $null) { # Create object to PATCH $oem = @{'Hp'=@{'BootOnNextServerReset'=[System.Convert]::ToBoolean($BootOnNextReset)}} $mountSetting.Add('Oem',$oem) } # PATCH the data to $vm href by using Set-HPRESTData #Disconnect-HPREST -Session $session $ret = Set-HPRESTData -Href $vm -Setting $mountSetting -Session $session # Process message(s) returned from Set-HPRESTData if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } Get-HPRESTDataRaw -Href $vm -Session $session } } } } # Disconnect session after use Disconnect-HPREST -Session $session } <# # will return '(400) Bad Request' error if the virtual media is already in this state. # IsoUrl = $null will dismount the virtual media. IsoUrl = '' will give 400 Bad Request error. #unmount Set-VirutalMediaExample15 -Address $Address -Credential $cred -IsoUrl $null -BootOnNextReset $false #Mount Set-VirutalMediaExample15 -Address $Address -Credential $cred -IsoUrl 'http://192.184.217.158/iso/Windows/Win2012/en_windows_server_2012_vl_x64_dvd_917758.iso' -BootOnNextReset $true #unmount Set-VirutalMediaExample15 -Address $Address -Credential $cred #> function Set-AssetTagExample16 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $AssetTag ) Write-Host 'Example 16: Update AssetTag value.' # Connect sesion $session = Connect-HPREST -Address $Address -Credential $Credential # Retrieve list of systems $systems = Get-HPRESTDataRaw -Href 'rest/v1/Systems' -Session $session foreach($sys in $systems.links.Member.href) { # Get each system href by first retrieving each system data and then extracting 'Self' href from it $sysData = Get-HPRESTDataRaw -Href $sys -Session $session $sysURI = $sysData.links.self.href # Create hashtable object to PATCH to system href $assetTagSetting = @{'AssetTag'='Test111'} # PATCH data using Set-HPRESTData cmdlet $ret = Set-HPRESTData -Href $sysURI -Setting $assetTagSetting -Session $session # Process message(s) from Set-HPRESTData if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } # Disconnect session after use Disconnect-HPREST -Session $session } #Set-AssetTagExample16 -Address $Address -Credential $cred -AssetTag 'Test2' function Reset-iLOExample17 { param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host 'Example 17: Reset the iLO.' #create session $session = Connect-HPREST -Address $Address -Credential $Credential # Get list of managers $managers = Get-HPRESTDataRaw -Href 'rest/v1/Managers' -Session $session foreach($mgr in $managers.links.member.href) # rest/v1/managers/1, rest/v1/managers/2 { # for possible operations on the manager check 'AvailableActions' field in manager data # Create hashtable object according to 'AvailableActions' to send to manager href $dataToPost = @{} $dataToPost.Add('Action','Reset') # Send POST request using Invoke-HPRESTAction Invoke-HPRESTAction -Href $mgr -Data $dataToPost -Session $session # resetting iLO will delete all active sessions. } #automatically closes all connections #Disconnect-HPREST -Session $session } #Reset-iLOExample17 -Address $Address -Credential $cred function Get-iLONICExample18 { param ( [System.String] $Address, [PSCredential] $Credential, [ValidateSet('Active','Inactive','All')] [System.String] $NICState = 'Active' ) Write-Host 'Example 18: Retrieve iLO NIC information' # Create Session $session = Connect-HPREST -Address $Address -Credential $Credential # Retrieve list of managers $managers = Get-HPRESTDataRaw -Href 'rest/v1/Managers' -Session $session foreach($manager in $managers.links.Member.href) { # Retrieve manager data to extract Ethernet NIC href $managerData = Get-HPRESTDataRaw -Href $manager -Session $session $nicURI = $managerData.links.EthernetNICs.href # Retrieve ethernet NIC details $nics = Get-HPRESTDataRaw -Href $nicURI -Session $session # Display NIC accoring to the NICState parameter foreach($nic in $nics.items) { if($nic.Status.State -eq 'Enabled') { if($NICState -eq 'Active') { $nic break } if($NICState -eq 'All') { $nic } } if($nic.Status.State -eq 'Disabled') { if($NICState -eq 'Inactive') { $nic break } if($NICState -eq 'All') { $nic } } } } # Disconnect the session after use Disconnect-HPREST -Session $session } #Get-iLONICExample18 -Address $Address -Credential $cred -NICState Inactive function Set-ActiveiLONICExample19 { param ( [System.String] $Address, [PSCredential] $Credential, [Boolean] $SharedNIC = $false ) Write-Host 'Example 19: Set the active iLO NIC' # Create session $session = Connect-HPREST -Address $Address -Credential $Credential # Retrieve list of managers $managers = Get-HPRESTDataRaw -Href 'rest/v1/Managers' -Session $session foreach($manager in $managers.links.Member.href) { $managerData = Get-HPRESTDataRaw -Href $manager -Session $session $nicHref = $managerData.links.EthernetNICs.href $nics = Get-HPRESTDataRaw -Href $nicHref -Session $session $selectedNICHref = '' foreach($nic in $nics.items) { if($SharedNIC -eq $true) { # if a shared NIC setting is required, then check for LOM or Flexible LOM select URI where LOM/FlexLOM is present if($nic.Oem.hp.SupportsFlexibleLOM -eq $null -and $nic.Oem.hp.SupportsLOM -eq $null) { continue; } else { if($nic.Oem.hp.SupportsFlexibleLOM -eq $true) { $selectedNICHref = $nic.links.self.href break } elseif($nic.Oem.hp.SupportsLOM -eq $true) { $selectedNICHref = $nic.links.self.href break } else { Write-Host 'Shared NIC not supported.' } } } else #if sharedNic set to false, select the Href of NIC where LOM/FlexLOM are not present { if($nic.Oem.hp.SupportsFlexibleLOM -eq $null -and $nic.Oem.hp.SupportsLOM -eq $null) { $selectedNICHref = $nic.links.self.href break } } } if($selectedNICHref -ne '') { $req = @{'Oem'=@{'Hp'=@{'NICEnabled' = $true}}} $ret = Set-HPRESTData -Href $selectedNICHref -Setting $req -Session $session # Process message(s) returned from Set-HPRESTData cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } } # Disconnect the session after use Disconnect-HPREST -Session $session } #Set-ActiveiLONICExample19 -Address $Address -Credential $cred function Get-IMLExample20 { param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host 'Example 20: Retrieve Integrated Management Log (IML)' # Create session $session = Connect-HPREST -Address $Address -Credential $Credential # Retrieve systems list $systems = Get-HPRESTDataRaw -Href 'rest/v1/systems' -Session $session foreach($sys in $systems.links.Member.href) { # Check if logs are available $systemData = Get-HPRESTDataRaw -Href $sys -Session $session if($systemData.links.PSObject.properties.name -notcontains 'Logs') { Write-Host 'Logs not available' } else { # Retrieve the IML href $logURI = $systemData.links.Logs.href $logData = Get-HPRESTDataRaw -Href $logURI -Session $session $imlURI = '' foreach($link in $logData.links.Member.href) { $spl = $link.split('`/') if($spl[$spl.length-1] -match 'IML') { $imlURI = $link break } } # retrieve and display IML log entries $imlData = Get-HPRESTDataRaw -Href $imlURI -Session $session foreach($entryLink in $imlData.links.Entries) { $imlEntries = Get-HPRESTDataRaw -Href $entryLink.href -Session $session $imlEntries.Items } } } # Disconnect the session after use Disconnect-HPREST -Session $session } #Get-IMLExample20 -Address $Address -Credential $cred function Get-iLOEventLogExample21 { param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host 'Example 21: Retrieve iLO Event Log' # Create session $session = Connect-HPREST -Address $Address -Credential $Credential $managers = Get-HPRESTDataRaw -Href 'rest/v1/managers' -Session $session foreach($mgr in $managers.links.Member.href) { $managerData = Get-HPRESTDataRaw -Href $mgr -Session $session if($managerData.links.PSObject.properties.name -notcontains 'Logs') { Write-Host 'Logs not available' } else { # get the href for iLO event logs $logURI = $managerData.links.Logs.href $logData = Get-HPRESTDataRaw -Href $logURI -Session $session $imlURI = '' foreach($link in $logData.links.Member.href) { $spl = $link.split('`/') if($spl[$spl.length-1] -match 'IEL') { $ielURI = $link break } } # Retrieve and display the log entries $ielData = Get-HPRESTDataRaw -Href $ielURI -Session $session foreach($entryLink in $ielData.links.Entries) { $ielEntries = Get-HPRESTDataRaw -Href $entryLink.href -Session $session $ielEntries.Items } } } # Disconnect the session after use Disconnect-HPREST -Session $session } #Get-iLOEventLogExample21 -Address $Address -Credential $cred function Clear-IMLExample22 { param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host 'Example 22: Clear Integrated Management Log' # Create session $session = Connect-HPREST -Address $Address -Credential $Credential $systems = Get-HPRESTDataRaw -Href 'rest/v1/systems' -Session $session foreach($sys in $systems.links.Member.href) { # check if logs are available or not $systemData = Get-HPRESTDataRaw -Href $sys -Session $session if($systemData.links.PSObject.properties.name -notcontains 'Logs') { Write-Host 'Logs not available' } else { # extract href href for IML $logURI = $systemData.links.Logs.href $logData = Get-HPRESTDataRaw -Href $logURI -Session $session $imlURI = '' foreach($link in $logData.links.Member.href) { $spl = $link.split('`/') if($spl[$spl.length-1] -match 'IML') { $imlURI = $link break } } # Create hashtable object to invoke action to clear logs # Check 'AvailableActions' for values in this hashtable object $action = @{'Action'='ClearLog'} # POST the object using Invoke-HPRESTAction cmdlet $ret = Invoke-HPRESTAction -Href $imlURI -Data $action -Session $session # Process message(s) returned from Invoke-HPRESTAction cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } } # Disconnect the session after use Disconnect-HPREST -Session $session } <# Clear-IMLExample22 -Address $Address -Credential $cred Get-IMLExample20 -Address $Address -Credential $cred #> function Clear-iLOEventLogExample23 { param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host 'Example 23: Clear iLO Event Log' # Create session $session = Connect-HPREST -Address $Address -Credential $Credential # Retrieve manager list $managers = Get-HPRESTDataRaw -Href 'rest/v1/managers' -Session $session foreach($mgr in $managers.links.Member.href) { $managerData = Get-HPRESTDataRaw -Href $mgr -Session $session # check if logs are available or not if($managerData.links.PSObject.properties.name -notcontains 'Logs') { Write-Host 'Logs not available' } else { # get the href for iLO event logs $logURI = $managerData.links.Logs.href $logData = Get-HPRESTDataRaw -Href $logURI -Session $session $ielURI = '' foreach($link in $logData.links.Member.href) { $spl = $link.split('`/') if($spl[$spl.length-1] -match 'IEL') { $ielURI = $link break } } # Create hashtable object to invoke action to clear logs # Check 'AvailableActions' for values in this hashtable object $action = @{'Action'='ClearLog'} # POST the object using Invoke-HPRESTAction cmdlet $ret = Invoke-HPRESTAction -Href $ielURI -Data $action -Session $session # Process message(s) returned from Invoke-HPRESTAction cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } } # Disconnect the session after use Disconnect-HPREST -Session $session } <# Clear-iLOEventLogExample23 -Address $Address -Credential $cred Get-iLOEventLogExample21 -Address $Address -Credential $cred #> function Set-SNMPExample24 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $Mode, # Agentless or Passthru [System.Object] $AlertsEnabled = $null #use true or false only ) Write-Host 'Example 24: Configure iLO SNMP settings.' # Create session $session = Connect-HPREST -Address $Address -Credential $Credential # retrieve list of managers $managers = Get-HPRESTDataRaw -Href 'rest/v1/Managers' -Session $session foreach($mgr in $managers.links.Member.href) { # retrieve settings of NetworkService data $mgrData = Get-HPRESTDataRaw -Href $mgr -Session $session $netSerURI = $mgrData.links.NetworkService.href $netSerData = Get-HPRESTDataRaw -Href $netSerURI -Session $session if($netSerData.links.PSObject.properties.name -notcontains 'SNMPService') { Write-Host 'SNMP services not available in Manager Network Service' } else { # create hashtable object according to the parameters provided by user $snmpSerURI = $netSerData.links.SNMPService.href $snmpSetting = @{} if($mode -ne '' -and $Mode -ne $null) { $snmpSetting.Add('Mode',$Mode) } if($AlertsEnabled -ne $null) { $snmpSetting.Add('AlertsEnabled',[System.Convert]::ToBoolean($AlertsEnabled)) } # PATCh the settings using Set-HPRESTData cmdlet $ret = Set-HPRESTData -Href $snmpSerURI -Setting $snmpSetting -Session $session # Process message(s) returned from Set-HPRESTData cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } } # Disconnect the session after use Disconnect-HPREST -Session $session } #Set-SNMPExample24 -Address $Address -Credential $cred -Mode Agentless -AlertsEnabled $true function Get-SchemaExample25 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $Type, [ValidateSet('en','jp','zh')] [System.String] $Language = 'en' ) Write-Host 'Example 25: Retrieve schema' # Create session $session = Connect-HPREST -Address $Address -Credential $Credential # Retrieve the schema with the Type provided by the user $sch = Get-HPRESTSchema -Type $Type -Language $Language -Session $session $sch.properties # Disconnect the session after use Disconnect-HPREST -Session $session } #Get-SchemaExample25 -Address $Address -Credential $cred -Type ComputerSystem function Get-RegistryExample26 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $RegistryPrefix, [System.String] $Language = 'en' ) Write-Host 'Example 26: Retrieve registry' # Create session $session = Connect-HPREST -Address $Address -Credential $Credential # retrieve list of registries $reg = Get-HPRESTDataRaw -href rest/v1/registries -Session $session # select the registry where the prefix is same as value provided by user in 'RegistryPrefix' parameter $reqRegList = $reg.Items | ? {$_.Schema.ToString().IndexOf($RegistryPrefix) -eq 0} # retrieve and display the external reference for the required language foreach($reqReg in $reqRegList) { $reqRegURI = ($reqReg.Location|?{$_.Language -eq $Language}).uri.extref $reqRegData = Get-HPRESTDataRaw -Href $reqRegURI -Session $session $reqRegData } # Disconnect the session after use Disconnect-HPREST -Session $session } #Get-RegistryExample26 -Address $Address -Credential $cred -RegistryPrefix HpBiosAttributeRegistryP89 function Set-TimeZoneExample27 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $TimeZone ) #NOTE: This will work only if iLO is NOT configured to take time settings from DHCP v4 or v6. Otherwise, error 400 - bad request is thrown. Write-Host 'Example 27: Set timezone' # Create session $session = Connect-HPREST -Address $Address -Credential $Credential # retrieve manager list $managers = Get-HPRESTDataRaw -href rest/v1/managers -Session $session foreach($mgr in $managers.links.Member.href) { # Retrieve DateTimeService href and timezone name to display to user $mgrData = Get-HPRESTDataRaw -href $mgr -Session $session $dtsURI = $mgrData.Oem.Hp.links.DateTimeService.href $dtsData = Get-HPRESTDataRaw -Href $dtsURI -Session $session $currTimeZone = $dtsData.TimeZone.Name Write-Host "Current timezone $currTimeZone" # from list of all timezone, first check if the user entered value is present in this list. foreach($tz in $dtsData.TimeZoneList) { if($tz.Name -eq $TimeZone) { # User entered timezone value is present. # Create timezone hashtable object to PATCH $setting = @{'TimeZone'=@{'Name'=$tz.name}} # PATCH the new setting using Set-HPRESTData cmdlet $ret = Set-HPRESTData -Href $dtsURI -Setting $setting -Session $session # Process message(s) returned from Set-HPRESTData cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } break } } } # Disconnect the session after use Disconnect-HPREST -Session $session } ## Patch using Timezone name is preferred over timezone index. If both are patched, Index field will be ignored ## DHCPv4 should be disabled in active NIC for setting the timezone #Set-TimeZoneExample27 -Address $Address -Credential $cred -TimeZone 'America/Chicago' function Set-iLONTPServerExample28 { param ( [System.String] $Address, [PSCredential] $Credential, [System.Array] $StaticNTPServer ) #NOTE: This will work only if iLO is NOT configured to take time settings from DHCP v4 or v6. Otherwise, error 400 - bad request is thrown. Write-Host 'Example 28: Set NTP server' # Create session $session = Connect-HPREST -Address $Address -Credential $Credential # Retrieve manager list $managers = Get-HPRESTDataRaw -href rest/v1/managers -Session $session foreach($mgr in $managers.links.Member.href) { # retrieve date time details and display current values $mgrData = Get-HPRESTDataRaw -Href $mgr -Session $session $dtsURI = $mgrData.Oem.Hp.links.DateTimeService.href $dtsData = Get-HPRESTDataRaw -Href $dtsURI -Session $session Write-Host Current iLO Date and Time setting - $dtsData.ConfigurationSettings Write-Host Current iLO NTP Servers - $dtsData.NTPServers # Create hashtable object with values for NTPServer $setting = @{'StaticNTPServers'=$StaticNTPServer} # PATCH new NTPServer data using Set-HPRESTData $ret = Set-HPRESTData -Href $dtsURI -Setting $setting -Session $session # Process message(s) returned from Set-HPRESTData cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } # Disconnect the session after use Disconnect-HPREST -Session $session } ## DHCPv4 should be disabled in active NIC for setting the StaticNTPServer #Set-iLONTPServerExample28 -Address $Address -Credential $cred -StaticNTPServer @('192.168.0.1','192.168.0.2') function Get-PowerMetricExample29 { param ( [System.String] $Address, [PSCredential] $Credential ) #NOTE: This will work only if iLO is NOT configured to take time settings from DHCP v4 or v6 Write-Host 'Example 29: Retrieve PowerMetrics average watts' # Create session $session = Connect-HPREST -Address $Address -Credential $Credential # retrieve chassis list $chassis = Get-HPRESTDataRaw -href rest/v1/chassis -Session $session foreach($cha in $chassis.links.member.href) { # get PowerMetrics href, retrieve the data and display $chaData = Get-HPRESTDataRaw -Href $cha -Session $session $pmURI = $chaData.links.PowerMetrics.href $pmData = Get-HPRESTDataRaw -Href $pmURI -Session $session $pm = $pmData.PowerMetrics Write-Host $chaData.Model AverageConsumedWatts = $pm.AverageConsumedWatts watts over a $pm.IntervalInMin minute moving average } # Disconnect the session after use Disconnect-HPREST -Session $session } #Get-PowerMetricExample29 -Address $Address -Credential $cred function Get-BiosDependenciesExample30 { param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host 'Example 30: Get BIOS dependencies.' $attRegFromBios = '' $attRegLoc = '' $registries = $null #create session $session = Connect-HPREST -Address $Address -Credential $Credential $sysList = Get-HPRESTDataRaw -Href 'rest/v1/systems' -Session $session $registries = Get-HPRESTDataRaw -Href $session.RootData.links.Registries.href -Session $session foreach($sys in $syslist.links.member.href) { # Get the Attribute registry version from BIOS settings $sysData = Get-HPRESTDataRaw -Href $sys -Session $session $biosURI = $sysData.Oem.Hp.links.BIOS.href # get BIOS data $biosData = Get-HPRESTDataRaw -Href $biosURI -Session $session $attRegFromBios = $biosData.AttributeRegistry # get the atttribute registry that matched the BIOS settings foreach($reg in $registries.items) { if($reg.Schema -eq $attRegFromBios) { $attRegLoc = $reg.Location|Where-Object{$_.Language -eq 'en'}|%{$_.uri.extref} # Display the dependencies from the registry entries $attReg = Get-HPRESTDataRaw -Href $attRegLoc -Session $session $attReg.RegistryEntries.Dependencies break } } } # Disconnect the session after use Disconnect-HPREST -Session $session } #Get-BiosDependenciesExample30 -Address $Address -Credential $cred function Set-TPMExample31 { param ( [System.String] $Address, [PSCredential] $Credential, [System.String] $TPMProperty, # TpmType, TpmState, TPMOperation, TpmVisibility, Tpm2Operation -Tpm2Visibility, Tpm2Ppi, TpmBinding, TpmUefiOpromMeasuring. #These property names may be present or not based on the system configuration. [System.String] $Value <# ## ValueName is the value to be used in REST interface ## ValueDisplayName is seen in RBSU menu options TpmType - ValueName ValueDisplayName --------- ---------------- NoTpm No TPM Tpm12 TPM 1.2 Tpm20 TPM 2.0 Tcm10 TCM 1.0 TpmState ValueName ValueDisplayName --------- ---------------- NotPresent Not Present PresentDisabled Present and Disabled PresentEnabled Present and Enabled TPMOperation ValueName ValueDisplayName --------- ---------------- NoAction No Action Enable Enable Disable Disable Clear Clear TpmVisibility ValueName ValueDisplayName --------- ---------------- Hidden Hidden Visible Visible Tpm2Operation ValueName ValueDisplayName --------- ---------------- NoAction No Action Clear Clear Tpm2Visibility, ValueName ValueDisplayName --------- ---------------- Hidden Hidden Visible Visible Tpm2Ppi ValueName ValueDisplayName --------- ---------------- Enabled Enabled Disabled Disabled TpmBinding ValueName ValueDisplayName --------- ---------------- Enabled Enabled Disabled Disabled TpmUefiOpromMeasuring ValueName ValueDisplayName --------- ---------------- Enabled Enabled Disabled Disabled #> ) Write-Host 'Example 31: Change TPM 2.0 Setting' #create session $session = Connect-HPREST -Address $Address -Credential $Credential #Get BIOS URI $sys = Get-HPRESTDataRaw -Href 'rest/v1/systems' -Session $session foreach($hrefVal in $sys.links.member.href) # rest/v1/systems/1, rest/v1/system/2 { $data = Get-HPRESTDataRaw -Href $hrefVal -Session $session $biosURI = $data.Oem.Hp.links.BIOS.href #get AttributeRegistry value from BIOS Data $biosData = Get-HPRESTDataRaw -Href $biosURI -Session $session $biosData $ar = $biosData.AttributeRegistry # get attribute registries and select the one that matches BIOS data attribute registry $reg = Get-HPRESTDataRaw -Href 'rest/v1/registries' -Session $session #if property to be modified is not present in the bios data, then print error message and return if(-not(($biosData|Get-Member).Name -Contains $TPMProperty)) { Write-Host "Property $TPMProperty is not supported on this system" } else { #Get setting href to update bios property. For bios, property can be updated in the settings href only. other data may not have setting href $biosSettingURI = $biosData.links.settings.href # Create hashtable object with TPM property and value to PATCH $tpmSetting = @{$TPMProperty=$Value} # PATCH TPM setting using Set-HPRESTData $ret = Set-HPRESTData -Href $biosSettingURI -Setting $tpmSetting -Session $session # Process message(s) returned from Set-HPRESTData cmdlet if($ret.Messages.Count -gt 0) { foreach($msgID in $ret.Messages) { $status = Get-HPRESTError -MessageID $msgID.MessageID -MessageArg $msgID.MessageArgs -Session $session $status } } } } # Disconnect the session after use Disconnect-HPREST -Session $session } <# Set-TPMExample31 -Address $Address -Credential $cred -TPMProperty TpmVisibility -Value Hidden Reset-ServerExample2 -Address $Address -Credential $cred -Action Reset -PropertyName ResetType -PropertyValue ForceRestart #> function Get-TPMExample32 { param ( [System.String] $Address, [PSCredential] $Credential, [ValidateSet('All', 'TpmType', 'TpmState', 'TPMOperation', 'TpmVisibility', 'Tpm2Operation', 'Tpm2Visibility', 'Tpm2Ppi', 'TpmBinding', 'TpmUefiOpromMeasuring')] [System.String] $TPMProperty = 'All' ) Write-Host 'Example 32: Get TPM Setting' #create session $session = Connect-HPREST -Address $Address -Credential $Credential #Get BIOS URI $sys = Get-HPRESTDataRaw -Href 'rest/v1/systems' -Session $session foreach($hrefVal in $sys.links.member.href) # rest/v1/systems/1, rest/v1/system/2 { $data = Get-HPRESTDataRaw -Href $hrefVal -Session $session $biosURI = $data.Oem.Hp.links.BIOS.href #get AttributeRegistry value from BIOS Data $biosData = Get-HPRESTDataRaw -Href $biosURI -Session $session $ar = $biosData.AttributeRegistry # get attribute registries and select the one that matches BIOS data attribute registry $reg = Get-HPRESTDataRaw -Href 'rest/v1/registries' -Session $session $selectedReg = $null foreach($x in $reg.Items) { if($x.Schema -eq $ar) { $selectedReg = $x } } if($selectedReg -eq $null) { Write-Host 'No valid registry available for BIOS/TPM settings' } else { # Display TMP registry entries $attReg = Get-HPRESTDataRaw -Href ($selectedReg.Location|?{$_.Language -eq 'en'}|%{$_.URI.extref}) -Session $session if($TPMProperty -eq 'All') { $tpmDetails = $attReg.RegistryEntries.Attributes | ?{$_.name -match 'TPM'} $tpmDetails } else { $tpmDetails = $attReg.RegistryEntries.Attributes | ?{$_.name -match $TPMProperty} if(-not(($biosData|Get-Member).Name -Contains $TPMProperty)) { Write-Host "Property $TPMProperty is not supported on this system" } else { $tpmDetails } } } } # Disconnect the session after use Disconnect-HPREST -Session $session } #Get-TPMExample32 -Address $Address -Credential $cred -TPMProperty TpmBinding function Get-ThermalMetricsExample33 { param ( [System.String] $Address, [PSCredential] $Credential ) Write-Host 'Example 33: Get Temperature and Fan details from Thermal Metrics.' #create session $session = Connect-HPREST -Address $Address -Credential $Credential #retrieve Chassis list $chassisList = Get-HPRESTDataRaw -Href rest/v1/chassis -Session $session foreach($mem in $chassisList.links.Member) { $chasis = Get-HPRESTDataRaw -Href $mem.href -Session $session # get the thermal metrics of the chassis $thermalMetrics = Get-HPRESTDataRaw -Href $chasis.links.ThermalMetrics.href -Session $session # display temperature values Write-Host "Temperature: " $temps = $thermalMetrics.Temperatures $temps # display fan values Write-Host "Fans: " $fans = $thermalMetrics.Fans $fans } Disconnect-HPREST -Session $session } #Get-ThermalMetricsExample33 -Address $Address -Credential $cred |