Get-RedgateMonitorMonitoredObject
Published 18 April 2024
Gets the details of all of the monitored objects in Redgate Monitor.
Syntax
Get-RedgateMonitorMonitoredObject [-BaseMonitor <BaseMonitor>] [-Type <MonitoredObjectType>] [-Name <string>] [<CommonParameters>] Get-RedgateMonitorMonitoredObject [-Type <MonitoredObjectType>] [-Name <string>] [-Parent <MonitoredObject>] [<CommonParameters>] Get-RedgateMonitorMonitoredObject [-Type <MonitoredObjectType>] [-Name <string>] [-Group <Group>] [<CommonParameters>]
Description
The Get-RedgateMonitorMonitoredObject cmdlet gets details of Redgate Monitor Monitored objects from the Redgate Monitor Server.
Connect-RedgateMonitor must be called before this cmdlet.
Parameters
-BaseMonitor
<BaseMonitor>
The Base Monitor to limit results to.
Aliases | None |
Required? | false |
Position? | named |
Default Value | None |
Accept Pipeline Input | True (ByValue) |
Accept Wildcard Characters | false |
-Type
<MonitoredObjectType>
The type of object to limit results to. One of SqlServerInstance, AzureManagedInstance, AzureSqlServer, PostgresInstance, AmazonRdsHost, AmazonAuroraCluster, Cluster or Machine.
SqlServerInstance will return the details of SQL Server instances running on self-managed operating systems such as Windows or Linux. AzureManagedInstance will return the details of Azure SQL Managed Instances. AzureSqlServer will return the details of servers that host Azure SQL Databases. PostgresInstance will return the details of Postgres servers running on either a Linux host or in Amazon RDS. AmazonRdsHost will return the details of Amazon RDS hosts for both Postgres and SQL Server. AzureFlexHost will return the details of Azure Flexible hosts for Postgres. AmazonAuroraCluster will return details of Amazon RDS hosts configured as part of an Aurora cluster. Cluster will return details of Windows Server Failover Clusters. Machine will return details of individual Windows and Linux machines.
Aliases | None |
Required? | false |
Position? | named |
Default Value | None |
Accept Pipeline Input | False |
Accept Wildcard Characters | false |
-Name
<String>
The name of a monitored object to match.
Aliases | None |
Required? | false |
Position? | named |
Default Value | None |
Accept Pipeline Input | False |
Accept Wildcard Characters | false |
-Parent
<MonitoredObject>
{{ Fill Parent Description }}
Aliases | None |
Required? | false |
Position? | named |
Default Value | None |
Accept Pipeline Input | True (ByValue) |
Accept Wildcard Characters | false |
-Group
<Group>
{{ Fill Group Description }}
Aliases | None |
Required? | false |
Position? | named |
Default Value | None |
Accept Pipeline Input | True (ByValue) |
Accept Wildcard Characters | false |
-ProgressAction
<ActionPreference>
{{ Fill ProgressAction Description }}
Aliases | None |
Required? | false |
Position? | named |
Default Value | None |
Accept Pipeline Input | False |
Accept Wildcard Characters | false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see http://technet.microsoft.com/en-us/library/hh847884.aspx.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
-
[BaseMonitor] For more information, see https://www.red-gate.com/monitor14/powershell-custom-types#CustomTypes-BaseMonitor.
-
[Type] For more information, see https://www.red-gate.com/monitor14/powershell-custom-types#CustomTypes-MonitoredObjectType.
-
[Parent] Optional: restrict results to monitored objects with the given parent.
-
[Group] Optional: restrict results to monitored objects within the given group.
Return values
The output type is the type of the objects that the cmdlet emits.
-
[Cluster] For more information, see https://www.red-gate.com/monitor14/powershell-custom-types#CustomTypes-Cluster.
-
[Machine] For more information, see https://www.red-gate.com/monitor14/powershell-custom-types#CustomTypes-Machine.
-
[LinuxMachine] For more information, see https://www.red-gate.com/monitor14/powershell-custom-types#CustomTypes-LinuxMachine.
-
[AzureSqlServer] For more information, see https://www.red-gate.com/monitor14/powershell-custom-types#CustomTypes-AzureSqlServer.
-
[AzureManagedInstance] For more information, see https://www.red-gate.com/monitor14/powershell-custom-types#CustomTypes-AzureManagedInstance.
-
[AmazonRdsSqlServer] For more information, see https://www.red-gate.com/monitor14/powershell-custom-types#CustomTypes-AmazonRdsSqlServer.
-
[AmazonRdsHost] For more information, see https://www.red-gate.com/monitor14/powershell-custom-types#CustomTypes-AmazonRdsHost.
-
[AzureFlexHost] For more information, see https://www.red-gate.com/monitor14/powershell-custom-types#CustomTypes-AzureFlexHost.
-
[PostgresInstance] For more information, see https://www.red-gate.com/monitor14/powershell-custom-types#CustomTypes-PostgresInstance.
Examples
-------------------------- EXAMPLE 1 --------------------------
Get-RedgateMonitorMonitoredObject
-------------------------- EXAMPLE 2 --------------------------
Get-RedgateMonitorMonitoredObject -Type Cluster Get-RedgateMonitorMonitoredObject -Type Machine Get-RedgateMonitorMonitoredObject -Type PostgresInstance
-------------------------- EXAMPLE 3 --------------------------
Get-RedgateMonitorMonitoredObject -BaseMonitor $baseMonitor
-------------------------- EXAMPLE 4 --------------------------
Get-RedgateMonitorMonitoredObject -Name "ExampleName"
-------------------------- EXAMPLE 5 --------------------------
Get-RedgateMonitorMonitoredObject -BaseMonitor $baseMonitor -Name "ExamplePostgresInstanceName" -Type PostgresInstance
-------------------------- EXAMPLE 6 --------------------------
$host = Get-RedgateMonitorMonitoredObject -Type Machine -Name "ExampleMachineName" Get-RedgateMonitorMonitoredObject -Parent $host -Type Instance
-------------------------- EXAMPLE 7 --------------------------
#Equivalent to above Get-RedgateMonitorMonitoredObject -Type Machine -Name "ExampleMachineName" | Get-RedgateMonitorMonitoredObject -Type SqlServerInstance
-------------------------- EXAMPLE 8 --------------------------
Get-RedgateMonitorGroup -Name "1 - Production" | Get-RedgateMonitorMonitoredObject