The Add-Bookmark cmdlet adds a new bookmark to the timeline for a given device.
The bookmark can later be found by time, name or description, and is represented by a visual marker in the timeline for the given device in playback within XProtect Smart Client and any other integration using the timeline UI component.
REQUIREMENTS
Requires VMS connection and will attempt to connect automatically
Add a bookmark for device with a GUID ID value stored in the variable $id, using a local timestamp of 2PM on the 4th of June, 2019, based on the culture of the PowerShell session.
Find all enabled cameras with the case-insensitive string 'Elevator' in the name, and
add a bookmark for those cameras at 2PM on June 4th, or 21:00 UTC if the
location where the script is executed has a UTC offset of -7.
Specifies the description of the bookmark.
It is helpful to supply a header or description to add context to the bookmark.
The default value is 'Created by MilestonePSTools'
Type:StringParameter Sets:(All)Aliases:Required:FalsePosition:6Default value:Created by MilestonePSToolsAccept pipeline input:FalseAccept wildcard characters:False
Specifies the header, or title of the bookmark.
It is helpful to supply a header or description to add context to the bookmark.
The default value is 'Created \<timestamp>'
Specifies a reference string for the bookmark.
The default value will be a string retrieved from the Management Server using the BookmarkGetNewReference() method which returns a string like 'no.016735'.
The value does not need to be unique.
Timestamp of the event which should be bookmarked.
Value can be a string, and it will be parsed into a DateTime object.
Default is the current time.
Note: The event will be stored with a UTC timestamp on the Management Server.
Supplying a DateTime string can be finicky - it is recommended to thoroughly test any scripts to ensure it results in a bookmark at the expected place in the timeline.
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.