CoreOps/HostIqn/Set-SDPHostIqn.ps1
|
<# .SYNOPSIS Assigns an IQN to a host. .EXAMPLE Set-SDPHostIqn -hostName Host01 -iqn iqn.1998-01.com.vmware.iscsi:0123456789ABCDEF .EXAMPLE Get-SDPHost -name Host01 | Set-SDPHostIqn -iqn iqn.1998-01.com.vmware.iscsi:0123456789ABCDEF .DESCRIPTION Set's the IQN for any host. Accepts piped input from Get-SDPHost. .NOTES Authored by J.R. Phillips (GitHub: JayAreP) .LINK https://github.com/silk-us/silk-sdp-powershell-sdk #> function Set-SDPHostIqn { [CmdletBinding()] param( [parameter(Mandatory,ValueFromPipelineByPropertyName)] [Alias('pipeName')] [string] $hostName, [parameter(Mandatory)] [string] $iqn, [parameter()] [string] $context = 'sdpconnection' ) begin { $endpoint = 'host_iqns' } process { # Special Ops — resolve host name to a nested ref. $hostObj = Get-SDPHost -name $hostName -context $context -doNotResolve $hostPath = ConvertTo-SDPObjectPrefix -ObjectPath 'hosts' -ObjectID $hostObj.id -nestedObject # Build the request body $body = New-Object psobject $body | Add-Member -MemberType NoteProperty -Name "iqn" -Value $iqn $body | Add-Member -MemberType NoteProperty -Name "host" -Value $hostPath # Call $results = Invoke-SDPRestCall -endpoint $endpoint -method POST -body $body -context $context return $results } } |