about_SensorSettings.help.txt

TOPIC
    about_SensorSettings

SHORT DESCRIPTION
    Describes PRTG Sensor properties that can be used in conjunction with Set-ObjectProperty and Get-ObjectProperty

LONG DESCRIPTION
    PrtgAPI supports the retrieval and modification of dozens of Sensor Setting values in a reliable, typesafe manner.
    The following tables outline the properties that are currently supported/unsupported by PrtgAPI, as well as the
    setting values each property corresponds to within the PRTG Web Interface.

    For properties that are not currently supported, it is possible to interact with these values via the "Raw"
    cmdlet parameter sets. For more information, see the help pages of Get-ObjectProperty and Set-ObjectProperty

    In the tables below, the following keys are used to indicate typesafe support status.

    Yes : Supported
    Read-Only : Supports Get, and will never support Set
    No : Not currently supported

    | Access Rights | Get | Set | Description |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | InheritAccess | Yes | Whether to inherit Access Rights |

    | Debug Options | Get | Set | Description |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | DebugMode | Yes | How debug data should be stored |

    | Basic Sensor Settings | Get | Set | Description |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | Name | Yes | Name of the sensor |
    | ParentTags | Read-Only | Tags inherited from the parent object |
    | Tags | Yes | No | Tags applied to this object |
    | Priority | Yes | Priority of the sensor |

    | HTTP Specific | Get | Set | Description |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | Timeout | Yes | Timeout for HTTP requests |
    | Url | Yes | URL to monitor. If protocol is ommitted, HTTP is used |
    | HttpRequestMethod | Yes | Request method to use to access URL |
    | SNI | No | Server Name Indication of target |
    | UseSNIFromUrl | Yes | Whether to use SNI from the Url or parent device |

    | Ping Settings | Get | Set | Description |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | Timeout | Yes | Timeout for Ping requests |
    | PingPacketSize | Yes | Packet size of each request. Must be 1-10,000 bytes |
    | PingMode | Yes | Whether to send a single or multiple pings |
    | PingCount | Yes | Number of pings to send when PingMode is MultiPing |
    | PingDelay | Yes | Delay between each ping when PingMode is MultiPing |
    | AutoAcknowledge | Yes | Whether to auto acknowledge when sensor goes down |

    | Scanning Interval | Get | Set | Description |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | InheritInterval | Yes | Whether to inherit Scanning Interval |
    | Interval | Yes | Interval with which sensor refreshes |
    | IntervalErrorMode | Yes | How sensor transitions from Up -> Warning -> Error |

    | Schedules, Dependencies | Get | Set | Description |
    | and Maintenance Window | | |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | InheritDependency | Yes | No | Whether to inherit Schedules/Dependencies/Maintenance |
    | Schedule | Yes | No | Schedule during which this object is active |
    | MaintenanceEnabled | Yes | No | Whether a one time maintenance window has been set |
    | MaintenanceStart | Yes | No | Maintenance window start, or default start time |
    | MaintenanceEnd | Yes | No | Maintenance window end, or default end time |
    | DependencyType | Yes | No | The type of object this object uses as its dependency |
    | Dependency | Yes | No | The object this object depends on when DependencyType is Object |
    | DependencyDelay | Yes | No | The delay before resuming when DependencyType is Object (secs) |

    | Sensor Display | Get | Set | Description |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | PrimaryChannel | No | The primary channel of this sensor |
    | GraphType | Yes | Whether channels should be independent or stacked in graphs |
    | StackUnit | No | The unit of channels to include in stacked graphs |

    | Sensor Settings (EXE/XML) | Get | Set | Description |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | ExeName | Yes | EXE/Script file to execute |
    | ExeParameters | Yes | Parameters to pass to EXE/Script file |
    | SetExeEnvironmentVariables | Yes | Whether to set PRTG variables as environment variables |
    | UseWindowsAuthentication | Yes | Whether run with credentials of Device or of Probe Service |
    | Mutex | Yes | Mutex to execute related sensors sequentially |
    | EnableChangeTriggers | Yes |
    | ExeValueType | No | How the channel value is numerically represented |
    | DebugMode | Yes | How debug data should be stored |

    | WMI Alternate Query | Get | Set | Description |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | WmiMode | Yes | Whether to use default or alternate query mode |

    | WMI Remote Ping | Get | Set | Description |
    | Configuration | | |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | Target | Yes | IP Address or DNS name to ping |
    | Timeout | Yes | Timeout for Ping requests |
    | PingRemotePacketSize | Yes | Packet size of each request. Must be 1-10,000 bytes |

    | Sensor Factory Specific | Get | Set | Description |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | ChannelDefinition | Yes | Channels to display in a sensor factory |
    | FactoryErrorMode | Yes | How a sensor factory should react when a source sensor is down |
    | FactoryErrorFormula | Yes | Custom formula for determining when a sensor factory goes down |
    | FactoryMissingDataMode | Yes | How sensor factory values are calculated when channels are down |

    | Other | Get | Set | Description |
    | -------------------------- | --------- | --------------------------------------------------------------- |
    | InheritTriggers | No | Yes | Whether to inherit notification triggers. To retrieve the value |
    | | | of this property, use property NotificationTypes of Sensors, |
    | | | Devices, Groups and Probes |

EXAMPLES
    Retrieve all object properties of sensor with ID 1001

    C:\> Get-Sensor -Id 1001 | Get-ObjectProperty

    Modify the scanning interval of sensor with ID 1001

    C:\> Get-Sensor -Id 1001 | Set-ObjectProperty Interval "00:00:30"

    Retrieve raw property "name" of sensor with ID 1001

    C:\> Get-Sensor -Id 1001 | Get-ObjectProperty -RawProperty Name

    Set raw property "name" of sensor with ID 1001

    C:\> Get-Sensor -Id 1001 | Set-ObjectProperty -RawProperty name_ -RawValue test

SEE ALSO
    PrtgAPI Wiki: https://github.com/lordmilko/PrtgAPI/wiki
    Get-Sensor
    Get-ObjectProperty
    Set-ObjectProperty
    about_ObjectSettings
    about_SensorSettings