Functions/Get-vROpsResources.ps1
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 |
Function Get-vROpsResources{ <# .Synopsis Collects resources from vROps via REST API. .DESCRIPTION Collects resources from a vROps Operations Manager server via REST API. .PARAMETER OMServer FQDN or IP address of Operations Manager server to connect to. .PARAMETER ResourceKind This is the Resource Kind to be looking for. .PARAMETER AuthToken Authorisation Token that has been generated previously, either via Connect-vROpsRASession or another method. .PARAMETER AuthResource Authorisation Resource object that has been generated previously, either via Connect-vROpsRASession or another method. .EXAMPLE $AuthToken = (Connect-vROpsRASession -OMServer vROpsOMServer.CentralIndustrial.eu -Credentials $OMCreds).Token Get-vROpsResources -OMServer vROpsOMServer.CentralIndustrial.eu -AuthToken $AuthToken -ResourceKind "HPE3PAR_ADAPTER" .EXAMPLE $AuthResource = Connect-vROpsRASession -OMServer 10.11.12.13 -Credentials $OMCreds -UseUntrustedSSLCertificates Get-vROpsResources -OMServer 10.11.12.13 -AuthResource $AuthResource -ResourceKind "VMWARE" .EXAMPLE $OMserver = '10.11.12.13' $AuthToken = Connect-vROpsRASession -OMServer $OMserver -Credentials $OMCreds -AuthSource "CentralIndustrial" Get-vROpsResources -OMServer $OMserver -AuthToken $AuthToken.Token -ResourceKind "VMWARE" .OUTPUTS This will output a list of resources of the kind specified. .Notes .NOTES Version: 0.1 Author: Lars Panzerbjørn Creation Date: 2019.11.22 Purpose/Change: Initial script development #> [CmdletBinding()] Param ( [Parameter(Mandatory,ParameterSetName="Token")] [Parameter(Mandatory,ParameterSetName="Object")] [ValidateNotNullOrEmpty()] [string]$OMServer, [Parameter(ParameterSetName="Token")] [Parameter(ParameterSetName="Object")] [string]$ResourceKind, [Parameter(Mandatory,ParameterSetName="Token")] [ValidateNotNullOrEmpty()] [PSObject]$AuthToken, [Parameter(Mandatory,ParameterSetName="Object")] [ValidateNotNullOrEmpty()] [PSObject]$AuthResource, [Parameter(ParameterSetName="Token")] [Parameter(ParameterSetName="Object")] [ValidateSet('JSON', 'XML')] [string]$Type="JSON" ) Begin{ Write-Verbose "Beginning" $BaseURL = "https://" + $OMserver + "/suite-api/api/" $PageSize = "5000" #Maximum is 10000 $Page = 0 $Resourcelist = @() IF ($PSCmdlet.ParameterSetName -eq "Object") {$AuthToken = $AuthResource.Token} $Authorization = "vRealizeOpsToken $AuthToken" $InvokeRestMethodSplat = @{} $InvokeRestMethodSplat.Method = "GET" IF ($Type -eq "JSON") {$RestType = 'application/json'} IF ($Type -eq "XML") {$RestType = "application/xml"} $Headers = @{Authorization=$Authorization} IF (!([string]::IsNullOrEmpty($RestType))){ $Headers.Accept = $RestType $InvokeRestMethodSplat.ContentType = $RestType } $InvokeRestMethodSplat.Headers = $Headers } Process{ Write-Verbose "Processing" IF ($Type -eq "JSON"){ Try{ DO{ Write-Verbose "Page $($Page)" IF (!([string]::IsNullOrEmpty($ResourceKind))){ Write-Verbose "Using ResourceKind: $($ResourceKind)" $ResourcesURL = $BaseURL + "adapterkinds/" + $ResourceKind + "/resources/?page=$page&pageSize=$PageSize" } IF ([string]::IsNullOrEmpty($ResourceKind)){ Write-Verbose "Getting all Resources" $ResourcesURL = $BaseURL + "resources/?page=$page&pageSize=$PageSize" } $Resources = Invoke-RestMethod @InvokeRestMethodSplat -Uri $ResourcesURL $Resourcelist += $Resources.resourceList $Page++ } UNTIL (($Resources.links.href | Select -first 1) -eq ($Resources.links.href | Select -last 1)) } Catch [System.Net.WebException]{ IF (($PSItem | Get-ErrorInfo).Exception -eq 'The remote server returned an error: (401) Unauthorized.'){ Write-Warning "Failed to login. The remote server returned an error: (401) Unauthorized." } } Catch{ Write-Warning "Failed to get resources. Exception: $(($PSItem | Get-ErrorInfo).Exception) Reason: $(($PSItem | Get-ErrorInfo).Reason) Fullname: $(($PSItem | Get-ErrorInfo).Fullname) " } } IF ($Type -eq "XML"){ Try{ DO{ Write-Verbose "Page $($Page)" IF (!([string]::IsNullOrEmpty($ResourceKind))){ Write-Verbose "Using ResourceKind: $($ResourceKind)" $ResourcesURL = $BaseURL + "adapterkinds/" + $ResourceKind + "/resources/?page=$page&pageSize=$PageSize" } IF ([string]::IsNullOrEmpty($ResourceKind)){ Write-Verbose "Getting all Resources" $ResourcesURL = $BaseURL + "resources/?page=$page&pageSize=$PageSize" } $Resources = Invoke-RestMethod @InvokeRestMethodSplat -Uri $ResourcesURL $Resourcelist += $Resources.resourceList $Page++ } UNTIL (($Resources.links.href | Select -first 1) -eq ($Resources.links.href | Select -last 1)) } Catch [System.Net.WebException]{ IF (($PSItem | Get-ErrorInfo).Exception -eq 'The remote server returned an error: (401) Unauthorized.'){ Write-Warning "Failed to login. The remote server returned an error: (401) Unauthorized." } } Catch{ Write-Warning "Failed to get resources. Exception: $(($PSItem | Get-ErrorInfo).Exception) Reason: $(($PSItem | Get-ErrorInfo).Reason) Fullname: $(($PSItem | Get-ErrorInfo).Fullname) " } } } End{ Write-Verbose "Ending" Return $Resourcelist } } |