Add-VmsHardware¶
SYNOPSIS¶
Agrega un nuevo dispositivo de hardware, generalmente una cámara, a un servidor de grabación Milestone XProtect.
SYNTAX¶
FromHardwareScan¶
Add-VmsHardware -HardwareScan <VmsHardwareScanResult[]> [-Name <String>] [-SkipConfig] [-Force]
[<CommonParameters>]
Manual¶
Add-VmsHardware -RecordingServer <RecordingServer> -HardwareAddress <Uri> [-Name <String>]
[-DriverNumber <Int32>] [-HardwareDriverPath <String>] -Credential <PSCredential> [-SkipConfig] [-Force]
[<CommonParameters>]
DESCRIPTION¶
Agrega un nuevo dispositivo de hardware, generalmente una cámara, a un servidor de grabación Milestone XProtect. Capaz de agregar varias cámaras en un grupo si se proporciona una colección de resultados de escaneo de hardware del comando Start-VmsHardwareScan en el parámetro HardwareScan. De lo contrario, se agregará una cámara a la vez.
Cada dispositivo de hardware agregado correctamente se devolverá a la canalización en un objeto de hardware completamente resuelto. Con ese objeto, puede continuar estableciendo propiedades en el hardware o la cámara secundaria, el micrófono, el altavoz y otros tipos de dispositivos secundarios que estén presentes.
IMPORTANTE: este comando no agrega ningún dispositivo a un grupo de dispositivos como lo hace el cliente de administración.
Debe poner los dispositivos en grupos de dispositivos usted mismo.
REQUIREMENTS
- Requires VMS connection and will attempt to connect automatically
EXAMPLES¶
EXAMPLE 1¶
$recorder = Get-VmsRecordingServer | Out-GridView -OutputMode Single
$recorder | Add-VmsHardware -HardwareAddress 10.1.1.100 -Name 'Parking' -DriverNumber 806 -Credential (Get-Credential)
Solicita ingresar un nombre de usuario y contraseña (gracias a Get-Credential) y luego agrega la cámara Axis en 10.1.1.100 al Recording Server en $ recorder.
Una vez agregado, el nuevo hardware se devolverá a la canalización y, en este caso, se mostrará en la terminal como se ve a continuación.
Name Address Model Enabled LastModified Id ---- ------- ----- ------- ------------ -- Parking http://10.1.1.100/ AXIS M1065-L Network Camera True 10/5/2021 9:50:21 PM A833F561-7830-41B4-BEEF-C1F868939D17
EXAMPLE 2¶
$recorder = Get-VmsRecordingServer | Out-GridView -OutputMode Single
$credential = [pscredential]::new('root', ('pass' | ConvertTo-SecureString -AsPlainText -Force))
$recorder | Add-VmsHardware -HardwareAddress 10.1.1.100 -Name 'Parking' -DriverNumber 806 -Credential $credential
Exactamente lo mismo que en el Ejemplo n. ° 1, sin embargo, en este ejemplo creamos la credencial a partir del código. Esto usa texto sin formato y generalmente está mal visto por razones de seguridad. Idealmente, puede pedirle al usuario que ingrese las credenciales, o puede almacenar las credenciales en un lugar seguro, como una tienda secreta de algún tipo. Microsoft ha proporcionado un práctico marco de administración de secretos con soporte de complemento llamado "Microsoft.PowerShell.SecretManagement" que le permite acceder fácilmente a herramientas de administración secreta como KeePass y otras.
EXAMPLE 3¶
Add-VmsHardware -HardwareScan (Start-VmsHardwareScan -RecordingServer (Get-VmsRecordingServer) -Express)
Esta línea única obtendrá todos los servidores de grabación en el sitio e iniciará un escaneo rápido de hardware en todos ellos.
Los escaneos de hardware completados se pasarán a Add-VmsHardware y todo el hardware recién agregado de todos los servidores de grabación se guardará en la variable $ newHardware.
PARAMETERS¶
-Credential¶
Especifica un nombre de usuario y una contraseña de administrador para usar con la cámara en la dirección indicada.
Type: PSCredential
Parameter Sets: Manual
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DriverNumber¶
Especifica el número de controlador para que el controlador del paquete de dispositivos Milestone lo utilice con la cámara.
Type: Int32
Parameter Sets: Manual
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-Force¶
Especifica que las cámaras deben agregarse incluso si ya existen en otro servidor de grabación en el sitio.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-HardwareAddress¶
Especifica la IP o el nombre de host del hardware que se agregará. Debe estar en formato URI. Ejemplo: http://192.168.1.100
Type: Uri
Parameter Sets: Manual
Aliases: Address
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-HardwareDriverPath¶
Especifica el valor de la ruta de la API de configuración de Milestone que debe utilizar el controlador. DriverNumber es más fácil de usar, pero si tiene la ruta, puede usarla en su lugar. Ejemplo: HardwareDriver [ada01bd5-fc87-4bcb-8e7e-145cc755f502]
Type: String
Parameter Sets: Manual
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-HardwareScan¶
Los resultados de Start-VmsHardwareScan, que contienen toda la información necesaria para agregar hardware, incluida la dirección, el nombre de usuario, la contraseña y el controlador.
Type: VmsHardwareScanResult[]
Parameter Sets: FromHardwareScan
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name¶
Especifica el nombre que se asignará al hardware después de que se haya agregado.
El comportamiento predeterminado es utilizar la marca, el modelo y la IP de la cámara.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RecordingServer¶
Especifica el objeto RecordingServer (de Get-VmsRecordingServer, por ejemplo) al que se debe agregar la cámara. Esto solo es relevante para el juego de parámetros manual.
Si utiliza los resultados del análisis de hardware como entrada para Add-VmsHardware, el servidor de grabación se recupera del objeto de resultado del análisis.
Type: RecordingServer
Parameter Sets: Manual
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-SkipConfig¶
Especifica que no se debe realizar ninguna configuración adicional una vez que se ha agregado el hardware.
Esto significa que el hardware y los dispositivos mantendrán sus nombres predeterminados y estarán deshabilitados hasta que los habilite usted mismo.
Puede hacer esto si planea realizar varios de sus propios cambios de configuración una vez que se agrega el dispositivo y eso puede ahorrar algo de tiempo, especialmente cuando se trabaja con una gran cantidad de dispositivos.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters¶
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
INPUTS¶
OUTPUTS¶
VideoOS.Platform.ConfigurationItems.Hardware¶
VideoOS.Platform.ConfigurationItems.Hardware¶
Este comando no agrega cámaras u otros dispositivos a un grupo de cámaras. Se espera que lo haga usted mismo si lo desea.