Scripts/ProtectionSource/Get-CohesityProtectionSource.ps1
|
function Get-CohesityProtectionSource { <# .SYNOPSIS Gets a list of the registered protection sources filtered by the specified parameters. .DESCRIPTION If no parameters are specified, all protection sources that are registered on the Cohesity Cluster are returned. .NOTES Published by Cohesity .LINK https://cohesity.github.io/cohesity-powershell-module/#/README .EXAMPLE Get-CohesityProtectionSource -Environments KVMware Returns registered protection sources that match the environment type 'kVMware'. .EXAMPLE Get-CohesityProtectionSource -Id 1234 #> [OutputType('System.Array')] [CmdletBinding()] Param( [Parameter(Mandatory = $false)] # Return only protection sources that match the passed in environment type. # For example, set this parameter to 'kVMware' to only return the VMware sources. [Cohesity.Model.ProtectionSource+EnvironmentEnum[]]$Environments, [Parameter(Mandatory = $false)] # Return only the protection source that matches the Id. [long]$Id ) Begin { if (-not (Test-Path -Path "$HOME/.cohesity")) { throw "Failed to authenticate. Please connect to the Cohesity Cluster using 'Connect-CohesityCluster'" } $cohesitySession = Get-Content -Path $HOME/.cohesity | ConvertFrom-Json $cohesityServer = $cohesitySession.ClusterUri $cohesityToken = $cohesitySession.Accesstoken.Accesstoken } Process { $cohesityHeaders = @{'Authorization' = 'Bearer ' + $cohesityToken } if ($Id) { $cohesityUrl = $cohesityServer + '/irisservices/api/v1/public/protectionSources/objects/' + $Id.ToString() $resp = Invoke-RestApi -Method Get -Uri $cohesityUrl -Headers $cohesityHeaders # tagging reponse for display format ( configured in Cohesity.format.ps1xml ) @($resp | Add-Member -TypeName 'System.Object#ProtectionSource' -PassThru) } else { $url = '/irisservices/api/v1/public/protectionSources/rootNodes' if ($Environments) { $envList = @() foreach ($item in $Environments) { # converting KVMware to kVMware $envText = $item.ToString() $envList += $envText.SubString(0, 1).ToLower() + $envText.SubString(1, $envText.Length - 1) } $url += "?environments=" + ($envList -join ",") } $result = @() $cohesityUrl = $cohesityServer + $url $resp = Invoke-RestApi -Method Get -Uri $cohesityUrl -Headers $cohesityHeaders if ($resp) { $result = @($resp) $groups = @($result | where-object { $null -eq $_.registrationInfo }) if($groups) { foreach ($group in $groups) { $url = '/irisservices/api/v1/public/protectionSources?id=' + $group.protectionSource.id.ToString() $cohesityUrl = $cohesityServer + $url $resp = Invoke-RestApi -Method Get -Uri $cohesityUrl -Headers $cohesityHeaders if($resp) { $children = FlattenProtectionSourceNode -Nodes $resp -Type 2 foreach ($child in $children) { if ($child.registrationInfo) { $result += $child } } } } } } # Skip kView, kAgent, kPuppeteer environment types and group nodes themselves $result = @($result | where-object { $_.protectionSource.environment -ne "kAgent" ` -and $_.protectionSource.environment -ne "kView" ` -and $_.protectionSource.environment -ne "kPuppeteer" ` -and $null -ne $_.registrationInfo }) # Make sure each source id is only listed once as it might repeat under different environments # we have to sort the rows based on protectionSource.id and remove any duplicate entries $result = @($result | Sort-Object -property @{expression={$_.protectionSource.id }} -Unique) # tagging reponse for display format ( configured in Cohesity.format.ps1xml ) @($result | Add-Member -TypeName 'System.Object#ProtectionSourceNode' -PassThru) } } End { } } |