Add-Bookmark¶
SYNOPSIS¶
Agrega un nuevo marcador a la línea temporal para un dispositivo determinado.
SYNTAX¶
Add-Bookmark [[-DeviceId] <Guid>] [-Timestamp] <DateTime> [[-MarginSeconds] <Int32>] [[-Reference] <String>]
[[-Header] <String>] [[-Description] <String>] [<CommonParameters>]
DESCRIPTION¶
El cmdlet Add-Bookmark agrega un nuevo marcador a la línea temporal de un dispositivo determinado. El marcador se puede encontrar más tarde por hora, nombre o descripción, y está representado por un marcador visual en la línea temporal para el dispositivo dado en reproducción dentro de XProtect Smart Client y cualquier otra integración utilizando el componente de interfaz de usuario de línea temporal.
REQUIREMENTS
- Requires VMS connection and will attempt to connect automatically
EXAMPLES¶
EXAMPLE 1¶
Agregue un marcador para el dispositivo con un valor de ID de GUID almacenado en la variable $id, utilizando una marca de tiempo local de 2 p.m. el 4 de junio de 2019, según la cultura de la sesión de PowerShell.
EXAMPLE 2¶
Agregue un marcador para el dispositivo con un valor de ID GUID almacenado en la variable $ id, utilizando una marca de tiempo UTC de 2 p.m. UTC del 4 de junio de 2019
EXAMPLE 3¶
Get-VmsHardware | Get-VmsCamera | Where-Object Name -Like '*Elevator*' | ForEach-Object { Add-Bookmark -DeviceId $_.Id -Timestamp '2019-06-04 14:00:00' -Header 'Vandalism' }
Busque todas las cámaras con la cadena 'Elevator' que no distingue entre mayúsculas y minúsculas en el nombre y agregue un marcador para esas cámaras a las 2 p.m. del 4 de junio o a las 21:00 UTC si la ubicación donde se ejecuta el script tiene un desplazamiento UTC de -7.
PARAMETERS¶
-Description¶
Especifica la descripción del marcador. Es útil proporcionar un encabezado o una descripción para agregar contexto al marcador. El valor predeterminado es 'Creado por MilestonePSTools'
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 6
Default value: Created by MilestonePSTools
Accept pipeline input: False
Accept wildcard characters: False
-DeviceId¶
Identificador basado en GUID del dispositivo para el que se debe crear el marcador.
Type: Guid
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: 00000000-0000-0000-0000-000000000000
Accept pipeline input: False
Accept wildcard characters: False
-Header¶
Especifica el encabezado o título del marcador. Es útil proporcionar un encabezado o una descripción para agregar contexto al marcador. El valor predeterminado es 'Creado \<marca de tiempo>'
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 5
Default value: Created 2021-08-18 23:10:32.236Z
Accept pipeline input: False
Accept wildcard characters: False
-MarginSeconds¶
Especifica el tiempo en segundos antes y después del valor de Timestamp, que debe considerarse parte de este evento de marcador.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: 10
Accept pipeline input: False
Accept wildcard characters: False
-Reference¶
Especifica una cadena de referencia para el marcador. El valor predeterminado será una cadena recuperada del servidor de administración utilizando el método BookmarkGetNewReference () que devuelve una cadena como 'no.016735'. No es necesario que el valor sea único.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Timestamp¶
Marca de tiempo del evento que se debe marcar como favorito. El valor puede ser una cadena y se analizará en un objeto DateTime. El valor predeterminado es la hora actual.
Nota: El evento se almacenará con una marca de tiempo UTC en el servidor de administración. Proporcionar una cadena de fecha y hora puede ser complicado: se recomienda probar minuciosamente cualquier script para asegurarse de que dé como resultado un marcador en el lugar esperado en la línea de tiempo.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: 8/18/2021 11:10:32 PM
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.