Public/Get-MonitoringZone.ps1
|
<#
.SYNOPSIS Gets a monitoring zone. .DESCRIPTION Gets all monitoring zones or a single monitoring zone if a monitoring zone id is specified. If the result returns null, try the parameter "-Verbose" to get more details. .EXAMPLE Get-MonitoringZone .LINK https://github.com/erwindevreugd/PSDataConduIT .EXTERNALHELP PSDataConduIT-help.xml #> function Get-MonitoringZone { [CmdletBinding()] param ( [Parameter( Position = 0, Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'The name of the server where the DataConduIT service is running or localhost.')] [string] $Server = $Script:Server, [Parameter( Position = 1, Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'The credentials used to authenticate the user to the DataConduIT service.')] [PSCredential] $Credential = $Script:Credential, [Parameter( Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'The id of the monitoring zone to get.')] [int] $MonitoringZoneID, [Parameter( Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'Specifies the name of the monitoring zone to get. Wildcards are permitted.')] [string] $Name ) process { $query = "SELECT * FROM Lnl_MonitoringZone WHERE __CLASS='Lnl_MonitoringZone'" if ($MonitoringZoneID) { $query += " AND ID=$MonitoringZoneID" } if ($Name) { $query += " AND NAME like '$(ToWmiWildcard $Name)'" } LogQuery $query $parameters = @{ ComputerName = $Server; Namespace = $Script:OnGuardNamespace; Query = $query } if ($Credential -ne $null) { $parameters.Add("Credential", $Credential) } Get-WmiObject @parameters | ForEach-Object { New-Object PSObject -Property @{ Class = $_.__CLASS; SuperClass = $_.__SUPERCLASS; Server = $_.__SERVER; ComputerName = $_.__SERVER; Path = $_.__PATH; Credential = $Credential; MonitoringZoneID = $_.ID; Name = $_.Name; SegmentID = $_.SegmentID; } | Add-ObjectType -TypeName "DataConduIT.LnlMonitoringZone" } } } |