The Get-VmsMicrophone cmdlet gets microphone devices from the currently connected XProtect VMS site. Microphones are
logical child devices attached to "hardware" which are most often an IP camera. The VideoOS.Platform.ConfigurationItems.Microphone
object returned from this command represents a configurable device on the XProtect VMS.
The corresponding Set-VmsMicrophone command can be used in conjunction with this cmdlet to modify the device settings.
REQUIREMENTS
Requires VMS connection and will attempt to connect automatically
Get all microphones with a channel value of "0" (port number 1), and enable them if they aren't enabled already. Then get all
microphones with a higher channel number from 1 to 64, and disable them. In most cases this should leave you with only the
first microphone enabled.
When providing one or more channel numbers, only devices with a matching channel number are returned. Channel numbering
starts at zero, which means the first device of any given type will be assigned channel number "0", the second device
will be assigned channel number "1", and so on.
When providing a value for the Name, or Description parameters, the Comparison operator determines how thes values
are compared with the corresponding device properties. The default value is Contains.
Specifies the maximum number of matching devices to return. On a very large XProtect VMS, setting a reasonable number
may result in better performance. The default value is [int]::MaxValue or 2147483647.
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.