AGMPowerCLIGetFunctions.ps1
|
# Copyright 2022 Google Inc. 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. #appliance function Get-AGMAppliance ([string]$id,[string]$filtervalue,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets details about Appliances .EXAMPLE Get-AGMAppliance Will display all Appliances .EXAMPLE Get-AGMAppliance -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMAppliance -id 200 Display only the object with an ID of 200 .EXAMPLE Get-AGMAppliance -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMAppliance -filtervalue id=1234 Looks for any object with id 1234 .EXAMPLE Get-AGMAppliance -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMAppliance -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMAppliance -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display Appliances Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "syncdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /cluster -o } elseif ($id) { Get-AGMAPIData -endpoint /cluster/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /cluster -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /cluster -datefields $datefields -limit $limit -sort $sort } } # Application Function Get-AGMApplianceParameter ([string]$id,[String]$applianceid,[string]$clusterid,[string]$parameter) { <# .SYNOPSIS Fetch specified parameter from specified Appliance using clusterid .EXAMPLE Get-AGMApplianceParameter -applianceid 142700167048 -parameter maxsnapslots To display the maxsnapslots parameter for the appliance with clusterid 142700167048 Note that clusterid and applianceid are treated as the same value here. Do not use the id of the appliance, use the clusterid. Note that you will need to know the specific parameter. You cannot query all parameters. If you query a non-existent parameter you will not get an error, but you will not get a paramvalue .NOTES Written by Anthony Vandewerdt #> if ( (!($AGMSESSIONID)) -or (!($AGMIP)) ) { Get-AGMErrorMessage -messagetoprint "Not logged in or session expired. Please login using Connect-AGM" return } if ($clusterid) { $applianceid = $clusterid } if ($applianceid) { $appliancegrab = Get-AGMAppliance -filtervalue clusterid=$applianceid if (!($appliancegrab.clusterid)) { Get-AGMErrorMessage -messagetoprint "Failed to find specified appliance. Run Get-AGMAppliance and then specify the value listed as id with the -id parameter" return } else { $id = $appliancegrab.id } } if (!($id)) { $id = Read-Host "ID (for the Appliance)" } if (!($clusterid)) { $appliancegrab = Get-AGMAppliance -filtervalue id=$id if (!($appliancegrab.clusterid)) { Get-AGMErrorMessage -messagetoprint "Failed to find specified appliance. Run Get-AGMAppliance and then specify the value listed as id with the -id parameter" return } else { $clusterid = $appliancegrab.clusterid } } if (!($parameter)) { $parameter = Read-Host "Parameter name" } Get-AGMAPIData -endpoint /cluster/$clusterid/parameter/$parameter } Function Get-AGMApplianceSchedule ([String]$id,[String]$applianceid,[string]$clusterid,[string]$schedulename) { <# .SYNOPSIS Fetch specified schedule from specified Appliance using id .EXAMPLE Get-AGMApplianceSchedule -id 1234 -schedulename autodiscovery To display the autodiscovery schedule for the appliance with id 1234 Use the ID of the appliance, use the clusterid. Note that you will need to know the specific schedule. You cannot query all schedule. Also note that if a schedule has not been set, then you may get empty output. .NOTES Written by Anthony Vandewerdt #> if ( (!($AGMSESSIONID)) -or (!($AGMIP)) ) { Get-AGMErrorMessage -messagetoprint "Not logged in or session expired. Please login using Connect-AGM" return } if ($clusterid) { $applianceid = $clusterid } if ($applianceid) { $appliancegrab = Get-AGMAppliance -filtervalue clusterid=$applianceid if (!($appliancegrab.clusterid)) { Get-AGMErrorMessage -messagetoprint "Failed to find specified appliance. Run Get-AGMAppliance and then specify the value listed as id with the -id parameter" return } else { $id = $appliancegrab.id } } if (!($id)) { $id = Read-Host "ID (for the Appliance)" } if (!($schedulename)) { [string]$schedulename = Read-Host "Schedule name" } Get-AGMAPIData -endpoint /cluster/$id/schedule/$schedulename } Function Get-AGMApplianceParameter ([string]$id,[String]$applianceid,[string]$clusterid,[string]$parameter) { <# .SYNOPSIS Fetch specified parameter from specified Appliance using clusterid .EXAMPLE Get-AGMApplianceParameter -applianceid 142700167048 -parameter maxsnapslots To display the maxsnapslots parameter for the appliance with clusterid 142700167048 Note that clusterid and applianceid are treated as the same value here. Do not use the id of the appliance, use the clusterid. Note that you will need to know the specific parameter. You cannot query all parameters. If you query a non-existent parameter you will not get an error, but you will not get a paramvalue .NOTES Written by Anthony Vandewerdt #> if ( (!($AGMSESSIONID)) -or (!($AGMIP)) ) { Get-AGMErrorMessage -messagetoprint "Not logged in or session expired. Please login using Connect-AGM" return } if ($clusterid) { $applianceid = $clusterid } if ($applianceid) { $appliancegrab = Get-AGMAppliance -filtervalue clusterid=$applianceid if (!($appliancegrab.clusterid)) { Get-AGMErrorMessage -messagetoprint "Failed to find specified appliance. Run Get-AGMAppliance and then specify the value listed as id with the -id parameter" return } else { $id = $appliancegrab.id } } if (!($id)) { $id = Read-Host "ID (for the Appliance)" } if (!($clusterid)) { $appliancegrab = Get-AGMAppliance -filtervalue id=$id if (!($appliancegrab.clusterid)) { Get-AGMErrorMessage -messagetoprint "Failed to find specified appliance. Run Get-AGMAppliance and then specify the value listed as id with the -id parameter" return } else { $clusterid = $appliancegrab.clusterid } } if (!($parameter)) { $parameter = Read-Host "Parameter name" } Get-AGMAPIData -endpoint /cluster/$clusterid/parameter/$parameter } Function Get-AGMApplianceSchedule ([String]$id,[String]$applianceid,[string]$clusterid,[string]$schedulename) { <# .SYNOPSIS Fetch specified schedule from specified Appliance using id .EXAMPLE Get-AGMApplianceSchedule -id 1234 -schedulename autodiscovery To display the autodiscovery schedule for the appliance with id 1234 Use the ID of the appliance, use the clusterid. Note that you will need to know the specific schedule. You cannot query all schedule. Also note that if a schedule has not been set, then you may get empty output. .NOTES Written by Anthony Vandewerdt #> if ( (!($AGMSESSIONID)) -or (!($AGMIP)) ) { Get-AGMErrorMessage -messagetoprint "Not logged in or session expired. Please login using Connect-AGM" return } if ($clusterid) { $applianceid = $clusterid } if ($applianceid) { $appliancegrab = Get-AGMAppliance -filtervalue clusterid=$applianceid if (!($appliancegrab.clusterid)) { Get-AGMErrorMessage -messagetoprint "Failed to find specified appliance. Run Get-AGMAppliance and then specify the value listed as id with the -id parameter" return } else { $id = $appliancegrab.id } } if (!($id)) { $id = Read-Host "ID (for the Appliance)" } if (!($schedulename)) { [string]$schedulename = Read-Host "Schedule name" } Get-AGMAPIData -endpoint /cluster/$id/schedule/$schedulename } function Get-AGMApplication ([string]$id,[string]$appid,[string]$filtervalue,[string]$keyword,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets details about Applications .EXAMPLE Get-AGMApplication Will display all Applications .EXAMPLE Get-AGMApplication -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMApplication -id 200 Display only the object with an ID of 200 .EXAMPLE Get-AGMApplication -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMApplication -filtervalue id=1234 Looks for any object with id 1234 .EXAMPLE Get-AGMApplication -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMApplication -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMApplication -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display Applications Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "syncdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($appid) { $id = $appid } if ($options) { Get-AGMAPIData -endpoint /application -o } elseif ($id) { Get-AGMAPIData -endpoint /application/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /application -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } elseif ($keyword) { Get-AGMAPIData -endpoint /application -keyword $keyword -datefields $datefields -sort $sort } else { Get-AGMAPIData -endpoint /application -datefields $datefields -limit $limit -sort $sort } } function Get-AGMApplicationActiveImage ([Parameter(Mandatory=$true)][string]$id,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets details about Application Active Images (mounts) .EXAMPLE Get-AGMApplicationActiveImage Will display all Active Images after prompting for an Application ID .EXAMPLE Get-AGMApplicationActiveImage -id 200 Display Active images for Application ID 200 .EXAMPLE Get-AGMApplicationActiveImage -limit 2 -id 200 Display two Active images for Application ID 200 .EXAMPLE Get-AGMApplicationActiveImage -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMApplicationActiveImage -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display Active Images (mounts) for a specified Application #> $datefields = "backupdate,modifydate,consistencydate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($id) { Get-AGMAPIData -endpoint /application/$id/activeimage -datefields $datefields -limit $limit -sort $sort } } function Get-AGMApplicationAppClass ([Parameter(Mandatory=$true)][string]$id,[string]$operation,[string]$hostid) { <# .SYNOPSIS Gets details about the Application class of a specified application. This is used during mount operations. .EXAMPLE Get-AGMApplicationAppClass Will display the application class details after prompting for an Application ID .EXAMPLE Get-AGMApplicationAppClass -id 705065 Display Application Class info for application ID 705065 .EXAMPLE Get-AGMApplicationAppClass -id 705065 -hostid 1234 Display Application Class info for application ID 705065 when mounting to host ID 1234 .EXAMPLE Get-AGMApplicationAppClass -id 705065 -hostid 1234 -operation clone Display Application Class info for application ID 705065 when cloning to host ID 1234 .DESCRIPTION A function to display application class details for an application. #> if ($hostid) { $extrarequests = "&hostid=" + $hostid } if ($operation) { $extrarequests = $extrarequests + "&operation=" + $operation } if ($extrarequests) { Get-AGMAPIData -endpoint /application/$id/appclass -extrarequests $extrarequests } else { Get-AGMAPIData -endpoint /application/$id/appclass } } function Get-AGMApplicationCount ([string]$filtervalue,[string]$keyword) { <# .SYNOPSIS Gets a count of Applications. .EXAMPLE Get-AGMApplicationCount Will count all Applications. .EXAMPLE Get-AGMApplicationCount -filtervalue "apptype=VMbackup" Count all applications that are type VMBackup .DESCRIPTION A function to count all Applications known to AGM. Multiple filtervalues need to be encased in double quotes and separated by the & symbol Jobclasses are case sensitive, so please use correct syntax: snapshot, OnVault Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) #> if ($filtervalue) { $count = Get-AGMAPIData -endpoint /application -filtervalue $filtervalue -head } elseif ($keyword) { $count = Get-AGMAPIData -endpoint /application -keyword $keyword -head } else { $count = Get-AGMAPIData -endpoint /application -head } if ($count.headers."Actifio-Count") { $count.headers."Actifio-Count" } } function Get-AGMApplicationInstanceMember ([Parameter(Mandatory=$true)][string]$id,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of members for an instance group type application (like an MS SQL Instance) .EXAMPLE Get-AGMApplicationInstanceMember Will display all members of a prompted application .EXAMPLE Get-AGMApplicationInstanceMember -id 705065 Will display all members for application ID 705065 .DESCRIPTION A function to display members for a grouped instance application type. #> $datefields = "backupdate,modifydate,consistencydate,beginpit,endpit" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($id) { Get-AGMAPIData -endpoint /application/$id/instancemembershipdetails -datefields $datefields -limit $limit -sort $sort } } function Get-AGMApplicationMember ([Parameter(Mandatory=$true)][string]$id,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of members for a group type application .EXAMPLE Get-AGMApplicationMember Will display all members of a prompted application .EXAMPLE Get-AGMApplicationMember -id 705065 Will display all members for application ID 705065 .DESCRIPTION A function to display members for a grouped application type. #> $datefields = "backupdate,modifydate,consistencydate,beginpit,endpit" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($id) { Get-AGMAPIData -endpoint /application/$id/member -datefields $datefields -limit $limit -sort $sort } } function Get-AGMApplicationTypes { <# .SYNOPSIS Get list of Application Types .EXAMPLE Get-AGMApplicationTypes Will display a list of application types known to AGM .DESCRIPTION A function to display Application Types. #> Get-AGMAPIData -endpoint /application/types } function Get-AGMApplicationWorkflow ([Parameter(Mandatory=$true)][string]$id,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of workflows for a specific application .EXAMPLE Get-AGMApplicationWorkflow Will display all Audit entries .EXAMPLE Get-AGMApplicationWorkflow -id 705065 Will display workflows for application ID 705065 .DESCRIPTION A function to display workflows for a specified application ID. #> if (!($sort)) { $sort = "" } if ($id) { Get-AGMAPIData -endpoint /application/$id/workflow -limit $limit -sort $sort } } function Get-AGMApplicationWorkflowStatus ([Parameter(Mandatory=$true)][string]$id,[Parameter(Mandatory=$true)][string]$workflowid) { <# .SYNOPSIS Gets the status of a specific workflow for a specific application ID .EXAMPLE Get-AGMApplicationWorkflowStatus -id 705065 -workflowid 3378203 Will display workflows for application ID 705065, workflow ID 3378203 .DESCRIPTION A function to display workflows status for a specified application ID and workflow ID #> if (($id) -and ($workflowid)) { Get-AGMAPIData -endpoint /application/$id/workflow/$workflowid -itemoverride } } # Audit function Get-AGMAudit ([string]$filtervalue,[switch][alias("o")]$options,[string]$id,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of Audit log entries. This could be a very long list. .EXAMPLE Get-AGMAudit Will display all Audit entries .EXAMPLE Get-AGMAudit -id 1234 Will display audit ID 1234. .EXAMPLE Get-AGMAudit -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMAudit -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMAudit -filtervalue id=3 Looks for any object with id 3 .EXAMPLE Get-AGMAudit -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMAudit -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMAudit -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display audit log entries. The returned list can be huge. Always use limits or filters. Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "issuedate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /localaudit -o } elseif ($id) { Get-AGMAPIData -endpoint /localaudit/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /localaudit -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /localaudit -datefields $datefields -limit $limit -sort $sort } } Function Get-AGMCloudVM ([string]$zone,[string]$id,[string]$credentialid,[string]$clusterid,[string]$applianceid,[string]$projectid,[string]$limit,[string]$offset,[string]$filter,[switch]$jsonprint) { <# .SYNOPSIS Displays Cloud VMs .EXAMPLE Get-AGMCloudVM -credentialid 1234 -zone australia-southeast1-c -applianceid 144292692833 Because no filter was supplied only New VMs will be display. .EXAMPLE Get-AGMCloudVM -credentialid 1234 -zone australia-southeast1-c -applianceid 144292692833 -filter Managed Shows all VMs from the specified zone and credential on appliance ID 144292692833 that are managed .EXAMPLE Get-AGMCloudVM -credentialid 1234 -zone australia-southeast1-c -applianceid 144292692833 -offset 1 Shows 50 VMs from the specified zone and credential on appliance ID 144292692833 that are managed, skipping the first 50 results .DESCRIPTION A function to find Cloud VMs -filter Defaults to New. Can be New, Ignored, Managed or Unmanaged -limit Defaults to 50. Means only 50 VMs are fetched, starting at offset 0 -offset xx Defaults to 0 Offsets the result based on the limit. So if limit is 100 and offset is 1, then it will show the next 100 starting at 101. #> if ($id) { $credentialid = $id } if (!($credentialid)) { [string]$credentialid = Read-Host "credentialid" } if ($applianceid) { [string]$clusterid = $applianceid} if (!($clusterid)) { $clusterid = Read-Host "clusterid" } if (!($projectid)) { [string]$projectid = Read-Host "projectid" } #if user doesn't specify name and zone, then learn them $credentialgrab = Get-AGMCredential -credentialid $credentialid if (!($credentialgrab.id)) { if ($credentialgrab.errormessage) { $credentialgrab } else { Get-AGMErrorMessage -messagetoprint "The credential ID $credentialid could not be found using Get-AGMCredential" } return } else { if ($zone -eq "") { $zone = $credentialgrab.region } } if ($filter) { if ($filter -ne "New" -and $filter -ne "Ignored" -and $filter -ne "Managed" -and $filter -ne "Unmanaged" ) { Get-AGMErrorMessage -messagetoprint "The Filter $filter is not valid. Use either New, Ignored, Managed or Unmanaged" return } } if (!($limit)) { $limit = 50 } if (!($offset)) { $offset = 0 } if (!($filter)) { $filter = "New"} $cluster = @{ clusterid = $clusterid} $body = [ordered]@{} # Google cloud backup and DR is looking for projectid, not project if ($AGMToken) { $body += @{ cluster = $cluster; region = $zone; projectid = $projectid; offset = $offset; limit = $limit actifioroles = @($filter) } } else { $body += @{ cluster = $cluster; region = $zone; project = $projectid; offset = $offset; limit = $limit actifioroles = @($filter) } } $json = $body | ConvertTo-Json if ($jsonprint) { $body | ConvertTo-Json -compress } Post-AGMAPIData -endpoint /cloudcredential/$credentialid/discovervm/vm -body $json } # Consistency group function Get-AGMConsistencyGroup ([string]$id,[string]$filtervalue,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of Consistency Groups .EXAMPLE Get-AGMConsistencyGroup Will display all consistency groups. .EXAMPLE Get-AGMConsistencyGroup -id 1234 Will display consistency group 1234. .EXAMPLE Get-AGMConsistencyGroup -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMConsistencyGroup -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMConsistencyGroup -filtervalue id=3 Looks for any object with id 3 .EXAMPLE Get-AGMConsistencyGroup -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMConsistencyGroup -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMConsistencyGroup -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display consistency groups Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "syncdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /consistencygroup -o } elseif ($id) { Get-AGMAPIData -endpoint /consistencygroup/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /consistencygroup -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /consistencygroup -datefields $datefields -limit $limit -sort $sort } } function Get-AGMConsistencyGroupMember ([string]$id) { <# .SYNOPSIS Gets a list of Consistency Groups Members .EXAMPLE Get-AGMConsistencyGroupMember -id 1234 Will display all members in consistency group ID 1234 .DESCRIPTION A function to display members in a consistency group #> if (!($id)) { $id = Read-Host "Consistency Group ID" } Get-AGMAPIData -endpoint /consistencygroup/$id/member } # cloud credentials function Get-AGMCredential ([string]$id,[string]$credentialid) { <# .SYNOPSIS Gets details about the stored cloud credentials .EXAMPLE Get-AGMCredential Will display the cloud credentials .DESCRIPTION A function to display cloud credentials #> if ($credentialid) { $id = $credentialid} if ($id) { $credentialgrab = Get-AGMAPIData -endpoint /cloudcredential/$id if (!($credentialgrab.id)) { if ($credentialgrab.errormessage) { $credentialgrab } else { Get-AGMErrorMessage -messagetoprint "The credential ID $credentialid could not be found" } return } else { $credentialgrab } } else { Get-AGMAPIData -endpoint /cloudcredential } } # Disk pool function Get-AGMDiskPool([string]$id,[string]$filtervalue,[string]$keyword,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of disk pools known to AGM .EXAMPLE Get-AGMDiskPool Will display all diskpools. .EXAMPLE Get-AGMDiskPool -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMDiskPool -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMDiskPool -filtervalue id=3 Looks for any object with id 3 .EXAMPLE Get-AGMDiskPool -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMDiskPool -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMDiskPool -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display disk pools known to AGM. Diskpools are owned by Appliances. Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "modifydate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /diskpool -o } elseif ($id) { Get-AGMAPIData -endpoint /diskpool/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /diskpool -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } elseif ($keyword) { Get-AGMAPIData -endpoint /diskpool -keyword $keyword -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /diskpool -datefields $datefields -limit $limit -sort $sort } } # Event function Get-AGMEvent ([string]$id,[string]$filtervalue,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of events that AGM has tracked .EXAMPLE Get-AGMEvent Will display all events. This may be a very long list. .EXAMPLE Get-AGMEvent -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMEvent -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMEvent -filtervalue id=3 Looks for any object with id 3 .EXAMPLE Get-AGMEvent -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMEvent -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMEvent -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display events known to AGM. The returned list can be huge. Always use limits or filters. Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "eventdate,syncdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /event -o } elseif ($id) { Get-AGMAPIData -endpoint /event/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /event -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /event -datefields $datefields -limit $limit -sort $sort } } #host function Get-AGMHost ([string]$id,[string]$hostid,[string]$filtervalue,[string]$keyword,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of hosts known to AGM. .EXAMPLE Get-AGMHost Will display all hosts. This may be a very long list. .EXAMPLE Get-AGMHost -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMHost -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMHost -filtervalue id=3 Looks for any object with id 3 .EXAMPLE Get-AGMHost -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMHost -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMHost -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display hosts known to AGM. The returned list can be huge. Always use limits or filters. Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "modifydate,syncdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($hostid) { $id = $hostid } if ($options) { Get-AGMAPIData -endpoint /host -o } elseif ($id) { Get-AGMAPIData -endpoint /host/$id -datefields $datefields -extrarequests "&fetchExtraInfo=true" } elseif ($filtervalue) { Get-AGMAPIData -endpoint /host -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } elseif ($keyword) { Get-AGMAPIData -endpoint /host -keyword $keyword -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /host -datefields $datefields -limit $limit -sort $sort } } function Get-AGMHostCount ([string]$filtervalue,[string]$keyword) { <# .SYNOPSIS Gets a count of hosts. .EXAMPLE Get-AGMHostCount Will count all Hosts. .EXAMPLE Get-AGMHostCount -filtervalue vmtype="GCP" Count all hosts that are VM type GCP (Compute Engine instances) .DESCRIPTION A function to count all hosts Multiple filtervalues need to be encased in double quotes and separated by the & symbol Jobclasses are case sensitive, so please use correct syntax: snapshot, OnVault Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) #> if ($filtervalue) { $count = Get-AGMAPIData -endpoint /host -filtervalue $filtervalue -head } elseif ($keyword) { $count = Get-AGMAPIData -endpoint /host -keyword $keyword -head } else { $count = Get-AGMAPIData -endpoint /host -head } if ($count.headers."Actifio-Count") { $count.headers."Actifio-Count" } } #Image (backup) function Get-AGMImage ([string]$id,[string]$imageid,[string]$filtervalue,[string]$imagename,[string]$backupname,[string]$keyword,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of images. It is not recommended to run this command without filters. .EXAMPLE Get-AGMImage Will display all images. This will be a very long list. .EXAMPLE Get-AGMImage -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMImage -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMImage -filtervalue id=3 Looks for any object with id 3 .EXAMPLE Get-AGMImage -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMImage -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMImage -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .EXAMPLE Get-AGMImage -imagename Image_0267271 Displays the image with backupname(imagename) Image_0267271 .DESCRIPTION A function to display all images known to AGM. The returned list can be huge. Always use limits or filters. Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "backupdate,modifydate,consistencydate,expiration,beginpit,endpit" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } #$datefields = "" if ($backupname) { $imagename = $backupname } if (($imagename) -and ($filtervalue)) { $filtervalue = $filtervalue + "&backupname=" +$imagename} if (($imagename) -and (!($filtervalue))) { $filtervalue = "backupname=$imagename" } if ($imageid) { $id = $imageid} if ($options) { Get-AGMAPIData -endpoint /backup -o } elseif ($id) { Get-AGMAPIData -endpoint /backup/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /backup -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } elseif ($keyword) { Get-AGMAPIData -endpoint /backup -keyword $keyword -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /backup -datefields $datefields -limit $limit -sort $sort } } function Get-AGMImageCount ([string]$filtervalue,[string]$keyword) { <# .SYNOPSIS Gets a count of images. .EXAMPLE Get-AGMImageCount Will count all images. .EXAMPLE Get-AGMImageCount -filtervalue "id>1234&name~sky" Count all images with id greater than 1234 and a name like sky. .DESCRIPTION A function to count all images known to AGM. Multiple filtervalues need to be encased in double quotes and separated by the & symbol Jobclasses are case sensitive, so please use correct syntax: snapshot, OnVault Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) #> if ($filtervalue) { $count = Get-AGMAPIData -endpoint /backup -filtervalue $filtervalue -head } elseif ($keyword) { $count = Get-AGMAPIData -endpoint /backup -keyword $keyword -head } else { $count = Get-AGMAPIData -endpoint /backup -head } if ($count.headers."Actifio-Count") { $count.headers."Actifio-Count" } } function Get-AGMImageSystemRecovery ([string]$imageid,[string]$credentialid) { <# .SYNOPSIS Gets a list of system state recovery options for a specified image with a specified credential ID .EXAMPLE Get-AGMImageSystemStateOptions Will request an image ID and then a credential ID .EXAMPLE Get-AGMImageSystemStateOptions -imageid 761385 -credentialid 405475 Will show the system state recovery options for image ID 761385 when recovered with credentialid 405475 .DESCRIPTION A function to display system state recovery information. #> if (!($imageid)) { [string]$imageid = Read-Host "ImageID" } if (!($credentialid)) { [string]$credentialid = Read-Host "credentialid" } Get-AGMAPIData -endpoint /backup/$imageid/systemrecovery/$credentialid } function Get-AGMImageSystemStateOptions ([string]$imageid,[string]$id,[string]$target) { <# .SYNOPSIS Gets a list of system state recovery options for a specified image. .EXAMPLE Get-AGMImageSystemStateOptions Will request an image ID and then show the system state recovery options .EXAMPLE Get-AGMImageSystemStateOptions -id 1234 Will show the system state recovery options for image ID 1234. .EXAMPLE Get-AGMImageSystemStateOptions -id 1234 -target GCP Will show the system state recovery options for image ID 1234 when being used with GCP .DESCRIPTION A function to display system state recovery information. #> if ($id) { $imageid = $id } if (!($imageid)) { [string]$id = Read-Host "ImageID" } if (!($target)) { Get-AGMAPIData -endpoint /backup/$imageid/systemstateoptions } else { Get-AGMAPIData -endpoint /backup/$imageid/systemstateoptions/$target } } #job function Get-AGMJob ([string]$id,[string]$filtervalue,[string]$keyword,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of running and queued jobs on an AGM. .EXAMPLE Get-AGMJob Will display all running and queued jobs .EXAMPLE Get-AGMJob -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMJob -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMJob -filtervalue id=3 Looks for any object with id 3 .EXAMPLE Get-AGMJob -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMJob -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMJob -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display jobs in the running or queued status on an AGM. Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "consistencydate,queuedate,expirationdate,startdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /job -o } elseif ($id) { Get-AGMAPIData -endpoint /job/$id -datefields $datefields -duration } elseif ($filtervalue) { Get-AGMAPIData -endpoint /job -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort -duration } elseif ($keyword) { Get-AGMAPIData -endpoint /job -keyword $keyword -datefields $datefields -limit $limit -sort $sort -duration } else { Get-AGMAPIData -endpoint /job -datefields $datefields -limit $limit -sort $sort -duration } } #job count function Get-AGMJobCount ([string]$filtervalue,[string]$keyword,[switch]$options) { <# .SYNOPSIS Gets a count of jobs .EXAMPLE Get-AGMJobCount Will count all running and queued jobs .EXAMPLE Get-AGMJobCount -filtervalue jobclass=snapshot Count all running and queued snapshot jobs .DESCRIPTION A function to count all Jobs known to AGM. Multiple filtervalues need to be encased in double quotes and separated by the & symbol Jobclasses are case sensitive, so please use correct syntax: snapshot, OnVault Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) #> if ($options) { Get-AGMAPIData -endpoint /job -o } elseif ($filtervalue -and $keyword) { $count = Get-AGMAPIData -endpoint /job -filtervalue $filtervalue -keyword $keyword -head } elseif ($keyword) { $count = Get-AGMAPIData -endpoint /job -keyword $keyword -head } elseif($filtervalue) { $count = Get-AGMAPIData -endpoint /job -filtervalue $filtervalue -head } else { $count = Get-AGMAPIData -endpoint /job -head } if ($count.headers."Actifio-Count") { $count.headers."Actifio-Count" } } #jobhistory function Get-AGMJobHistory ([string]$filtervalue,[string]$keyword,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of finished jobs on an AGM. It is not recommended to run this command without filters. .EXAMPLE Get-AGMJobHistory Will display all running and completed jobs (regardless of status) .EXAMPLE Get-AGMJobHistory -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMJobHistory -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMJobHistory -filtervalue id=3 Looks for any object with id 3 .EXAMPLE Get-AGMJobHistory -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMJobHistory -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMJobHistory -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display AGM job history. The returned list can be huge. Always use limits or filters. Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "queuedate,expirationdate,startdate,consistencydate,enddate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /jobhistory -o } elseif ($filtervalue) { Get-AGMAPIData -endpoint /jobhistory -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort -duration } elseif ($keyword) { Get-AGMAPIData -endpoint /jobhistory -keyword $keyword -datefields $datefields -limit $limit -sort $sort -duration } else { Get-AGMAPIData -endpoint /jobhistory -datefields $datefields -limit $limit -sort $sort -duration } } #jobstatus function Get-AGMJobStatus ([string]$filtervalue,[string]$keyword,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of running and finished jobs on an AGM. It is not recommended to run this command without filters. .EXAMPLE Get-AGMJobStatus Will display all running and completed jobs (regardless of status) .EXAMPLE Get-AGMJobStatus -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMJobStatus -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMJobStatus -filtervalue id=3 Looks for any object with id 3 .EXAMPLE Get-AGMJobStatus -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMJobStatus -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMJobStatus -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display AGM job status. This is a great way to find status of job regardless of whether it has finished or not. But the returned list can be huge. Always use limits or filters. Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "queuedate,expirationdate,startdate,consistencydate,enddate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /jobstatus -o } elseif ($filtervalue) { Get-AGMAPIData -endpoint /jobstatus -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort -duration } elseif ($keyword) { Get-AGMAPIData -endpoint /jobstatus -keyword $keyword -datefields $datefields -limit $limit -sort $sort -duration } else { Get-AGMAPIData -endpoint /jobstatus -datefields $datefields -limit $limit -sort $sort -duration } } #LDAP function Get-AGMLDAPConfig { <# .SYNOPSIS Display the LDAP Config .EXAMPLE Get-AGMLDAPConfig Will display the LDAP Config values .DESCRIPTION A function to display the LDAP Config #> Get-AGMAPIData -endpoint /ldap/config } function Get-AGMLDAPGroup { <# .SYNOPSIS Display the LDAP Group Mapping .EXAMPLE Get-AGMLDAPGroup Will display the LDAP Group to Role and Org Mapping .DESCRIPTION A function to display the LDAP group config #> Get-AGMAPIData -endpoint /ldap/group } # Logical group function Get-AGMLogicalGroup ([string]$id,[string]$logicalgroupid,[string]$filtervalue,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of AGM Logical Groups. Logical groups are simple groups of Applications with the same SLT/SLP .EXAMPLE Get-AGMLogicalGroup Will display all logical groups .EXAMPLE Get-AGMLogicalGroup -id 3 Will display logical group ID 3 .EXAMPLE Get-AGMLogicalGroup -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMLogicalGroup -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMLogicalGroup -filtervalue id=3 Looks for any object with id 3 .EXAMPLE Get-AGMLogicalGroup -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMLogicalGroup -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMLogicalGroup -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display AGM Logical Groups Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "modifydate,syncdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($logicalgroupid) { $id = $logicalgroupid } if ($options) { Get-AGMAPIData -endpoint /logicalgroup -o } elseif ($id) { Get-AGMAPIData -endpoint /logicalgroup/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /logicalgroup -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /logicalgroup -datefields $datefields -limit $limit -sort $sort } } function Get-AGMLogicalGroupMember ([Parameter(Mandatory=$true)][string]$id) { <# .SYNOPSIS Gets a list of members in an AGM Logical Group. Logical groups are simple groups of Applications with the same SLT/SLP .EXAMPLE Get-AGMLogicalGroupMember Will display all members of a requested logical group .EXAMPLE Get-AGMLogicalGroupMember -id 6547835 Will display logical group ID 6547835 .DESCRIPTION A function to display members in an AGM Logical Group #> if ($id) { Get-AGMAPIData -endpoint /logicalgroup/$id/member -itemoverride } } #org function Get-AGMOrg ([string]$id,[string]$orgid,[string]$filtervalue,[string]$keyword,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of AGM Organizations (Orgs). Organizations are used to manage what things an AGM user can work with .EXAMPLE Get-AGMOrg Will display all Orgs .EXAMPLE Get-AGMOrg -id 3 Will display org ID 3 .EXAMPLE Get-AGMOrg -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMOrg -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMOrg -filtervalue id=3 Looks for any object with id 3 .EXAMPLE Get-AGMOrg -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMOrg -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMOrg -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display AGM Orgs Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "modifydate,createdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($orgid) { $id = $orgid } if ($options) { Get-AGMAPIData -endpoint /org -o } elseif ($id) { Get-AGMAPIData -endpoint /org/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /org -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } elseif ($keyword) { Get-AGMAPIData -endpoint /org -keyword $keyword -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /org -datefields $datefields -limit $limit -sort $sort } } #right function Get-AGMRight ([string]$id) { <# .SYNOPSIS Gets a list of AGM Rights. Rights are used to manage what an AGM User can do as part of their role. .EXAMPLE Get-AGMRight Will display all Rights .EXAMPLE Get-AGMRight -id "Backup Manage" Will display the right title "Backup Manage" .DESCRIPTION A function to display AGM Rights #> # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /right -o } elseif ($id) { Get-AGMAPIData -endpoint /right/$id } elseif ($filtervalue) { Get-AGMAPIData -endpoint /right -filtervalue $filtervalue -limit $limit -sort $sort } elseif ($keyword) { Get-AGMAPIData -endpoint /right -keyword $keyword -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /right -limit $limit -sort $sort } } #role function Get-AGMRole ([string]$id,[string]$filtervalue,[string]$keyword,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of AGM Roles. Roles are used to manage what rights (ACLs) an AGM user has .EXAMPLE Get-AGMRole Will display all Roles .EXAMPLE Get-AGMRole -id 2 Will display role ID 2 .EXAMPLE Get-AGMRole -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMRole -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMRole -filtervalue id=1234 Looks for any object with id 1234 .EXAMPLE Get-AGMRole -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMRole -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMRole -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display AGM Roles Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "createdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /role -o } elseif ($id) { Get-AGMAPIData -endpoint /role/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /role -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } elseif ($keyword) { Get-AGMAPIData -endpoint /role -keyword $keyword -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /role -datefields $datefields -limit $limit -sort $sort } } #session function Get-AGMSession ([String]$sessionid) { <# .SYNOPSIS Displays the current Session to AGM .EXAMPLE Get-AGMSession Will display the current session ID .EXAMPLE Get-AGMSession -sessionid "8b3cf06-c16c-42c9-b518-09c1e6874f65" Will display details about the specified session ID .DESCRIPTION A function to display the session ID details. A session ID is created when you run Connect-AGM and destroyed when you run Disconnect-AGM #> if ((!($sessionid)) -and (!($agmsessionid))) { Write-Host "Please specify a session ID or run Connect-AGM to generate one" break } if ($sessionid) { Get-AGMAPIData -endpoint /session/$sessionid } else { Get-AGMAPIData -endpoint /session/$agmsessionid } } function Get-AGMPermissions { <# .SYNOPSIS Displays the current Permissions .EXAMPLE Get-AGMPermissions Will display the permisisons for the current session .DESCRIPTION A function to display the permissions #> $permissiongrab = Get-AGMAPIData -endpoint /session/permissions if ($permissiongrab.permissions) { $permissiongrab.permissions.entry } else { Get-AGMErrorMessage -messagetoprint "No Permissions were found." } } #sla function Get-AGMSLA ([string]$id,[string]$slaid,[string]$filtervalue,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of Service Level Agreements (SLAs) .EXAMPLE Get-AGMSLA Will display all SLPs .EXAMPLE Get-AGMSLA -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMSLA -filtervalue id=1234 Looks for any object with id 1234 .EXAMPLE Get-AGMSLA -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMSLA -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMSLA -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display AGM SLAs Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "modifydate,syncdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($slaid) { $id = $slaid } if ($id) { Get-AGMAPIData -endpoint /sla/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /sla -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /sla -datefields $datefields -limit $limit -sort $sort } } #SLP function Get-AGMSLP ([string]$id,[string]$slpid,[string]$filtervalue,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of AGM Service Level Profiles (SLPs) .EXAMPLE Get-AGMSLP Will display all SLPs .EXAMPLE Get-AGMSLP -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMSLP -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMSLP -filtervalue id=1234 Looks for any object with id 1234 .EXAMPLE Get-AGMSLP -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMSLP -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMSLP -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display AGM SLPs Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "modifydate,syncdate,createdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($slpid) { $id = $slpid } if ($options) { Get-AGMAPIData -endpoint /slp -o } elseif ($id) { Get-AGMAPIData -endpoint /slp/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /slp -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /slp -datefields $datefields -limit $limit -sort $sort } } #SLT function Get-AGMSLT ([string]$id,[string]$sltid,[string]$filtervalue,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of AGM Service Level Templates (SLTs) .EXAMPLE Get-AGMSLT Will display all SLTs .EXAMPLE Get-AGMSLT -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMSLT -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMSLT -filtervalue id=1234 Looks for any object with id 1234 .EXAMPLE Get-AGMSLT -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMSLT -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMSLT -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display AGM SLTs Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($sltid) { $id = $sltid } if ($options) { Get-AGMAPIData -endpoint /slt -o } elseif ($id) { Get-AGMAPIData -endpoint /slt/$id } elseif ($filtervalue) { Get-AGMAPIData -endpoint /slt -filtervalue $filtervalue -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /slt -limit $limit -sort $sort } } #SLTPolicy function Get-AGMSLTPolicy ([string]$id,[int]$limit,[switch]$settableoption,[string]$policyid,[string]$sltid) { <# .SYNOPSIS Gets a list of policies for a specific Service Level Template (SLT) .EXAMPLE Get-AGMSLTPolicy Will display all policies for a requested SLT ID .EXAMPLE Get-AGMSLTPolicy -sltid 70800 Will display all policies for SLT ID 70800 .EXAMPLE Get-AGMSLTPolicy -sltid 70800 -policyid 105138 Will display all policies for policy ID 105138 in SLT ID 70800 .EXAMPLE Get-AGMSLTPolicy -sltid 70800 -policyid 105138 -settableoption Will display any policy options for policy ID 105138 in SLT ID 70800 .DESCRIPTION A function to display AGM SLTs #> if ($sltid) { $id = $sltid } if ( (!($id)) -and (!($options)) ) { [string]$id = Read-Host "SLTID" } # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (($policyid) -and (!($settableoption))) { Get-AGMAPIData -endpoint /slt/$id/policy/$policyid -limit $limit } elseif (($policyid) -and ($settableoption)) { Get-AGMAPIData -endpoint /slt/$id/policy/$policyid/settableoption -limit $limit } else { Get-AGMAPIData -endpoint /slt/$id/policy -limit $limit } } #user function Get-AGMUser ([string]$id,[string]$filtervalue,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of AGM Users .EXAMPLE Get-AGMUser Will display all Users .EXAMPLE Get-AGMUser -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMUser -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMUser -filtervalue id=1234 Looks for any object with id 1234 .EXAMPLE Get-AGMUser -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMUser -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMUser -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display AGM Users Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> $datefields = "createdate" # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /user -o } elseif ($id) { Get-AGMAPIData -endpoint /user/$id -datefields $datefields } elseif ($filtervalue) { Get-AGMAPIData -endpoint /user -filtervalue $filtervalue -datefields $datefields -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /user -datefields $datefields -limit $limit -sort $sort } } # Version function Get-AGMVersion { <# .SYNOPSIS Gets the AGM Version .EXAMPLE Get-AGMVersion Will display the version of the AGM #> Get-AGMAPIData -endpoint /config/version } function Get-AGMVersionDetail { <# .SYNOPSIS Gets the AGM Version with some extra details .EXAMPLE Get-AGMVersion Will display the version of the AGM #> $datefields = "installed" Get-AGMAPIData -endpoint /config/versiondetail -datefields $datefields } #workflow function Get-AGMWorkFlow ([string]$filtervalue,[string]$keyword,[switch][alias("o")]$options,[int]$limit,[string]$sort) { <# .SYNOPSIS Gets a list of workflows .EXAMPLE Get-AGMWorkFlow Will display all workflows .EXAMPLE Get-AGMWorkFlow -limit 2 Will display a maximum of two objects .EXAMPLE Get-AGMWorkFlow -o To display all fields that can be filtered with filtervalue .EXAMPLE Get-AGMWorkFlow -filtervalue id=1234 Looks for any object with id 1234 .EXAMPLE Get-AGMWorkFlow -filtervalue "id>1234&name~sky" Looks for any object with id greater than 1234 and a name like sky. .EXAMPLE Get-AGMWorkFlow -sort id:desc Displays all objects sorting on ID descending. .EXAMPLE Get-AGMWorkFlow -sort "id:desc,name:asc" Displays all objects sorting on ID descending and name ascending. .DESCRIPTION A function to display Applications Multiple filtervalues need to be encased in double quotes and separated by the & symbol Filtervalues can be =, <, >, ~ (fuzzy) or ! (not) Multiple sorts need to be encased in double quotes and separated by the , symbol Sorts can only be asc for ascending or desc for descending. #> # if user doesn't ask for a limit, send 0 so we know to ignore it if (!($limit)) { $limit = "0" } if (!($sort)) { $sort = "" } if ($options) { Get-AGMAPIData -endpoint /workflow -o } elseif ($filtervalue) { Get-AGMAPIData -endpoint /workflow -filtervalue $filtervalue -limit $limit -sort $sort } elseif ($keyword) { Get-AGMAPIData -endpoint /workflow -keyword $keyword -limit $limit -sort $sort } else { Get-AGMAPIData -endpoint /workflow -limit $limit -sort $sort } } |