Get-Bookmark¶
SYNOPSIS¶
Obtiene uno o más marcadores en función de los parámetros proporcionados.
SYNTAX¶
Get-Bookmark [[-DeviceId] <Guid[]>] [[-StartTime] <DateTime>] [-EndTime <DateTime>] [-PageSize <Int32>]
[-Users <String[]>] [-SearchText <String>] [<CommonParameters>]
DESCRIPTION¶
Obtiene todos los marcadores que coinciden con los parámetros proporcionados. Si existe alguna superposición entre el intervalo de tiempo representado por los parámetros StartTime y EndTime, y el intervalo de tiempo representado por las propiedades TimeBegin y TimeEnd de los propios marcadores, los marcadores se incluirán en los resultados. Dado que un marcador generalmente tiene un "Tiempo activado", así como un corto período de tiempo antes y después del tiempo de activación, esto significa que su búsqueda de marcadores puede devolver Marcadores que poseen un valor "TimeTrigged" que se encuentra fuera de los límites de los parámetros StartTime y EndTime, pero sus marcas de tiempo TimeBegin o TimeEnd caen dentro del período de tiempo especificado.
REQUIREMENTS
- Requires VMS connection and will attempt to connect automatically
EXAMPLES¶
EXAMPLE 1¶
Obtenga todos los marcadores para el dispositivo con ID $ id que se produzcan en cualquier momento durante el día actual.
EXAMPLE 2¶
Obtenga todos los marcadores para cualquier dispositivo en el que la hora del marcador se encuentre en las últimas dos horas.
EXAMPLE 3¶
Get-Bookmark -StartTime (Get-Date).Date.ToUniversalTime().AddDays(-1) -EndTime (Get-Date).Date.ToUniversalTime()
Obtén todos los marcadores del día anterior.
EXAMPLE 4¶
Obtenga todos los marcadores con la palabra "Auto" en las propiedades de Encabezado o Descripción.
PARAMETERS¶
-DeviceId¶
ID de dispositivo opcional para filtrar los resultados.
Type: Guid[]
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EndTime¶
Hora UTC que representa el final del período de búsqueda de marcadores. El valor predeterminado es "ahora".
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 8/18/2021 11:10:32 PM
Accept pipeline input: False
Accept wildcard characters: False
-PageSize¶
Un tamaño de página más grande puede resultar en una espera más larga para el primer conjunto de resultados, pero en general un tiempo de procesamiento más corto. El valor predeterminado es 1000.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 1000
Accept pipeline input: False
Accept wildcard characters: False
-SearchText¶
Busque en el encabezado o la descripción de los marcadores en el período de tiempo definido para una palabra clave o frase.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-StartTime¶
Hora UTC que representa el inicio del período de búsqueda de marcadores. El valor predeterminado es hace 24 horas.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: 8/17/2021 11:10:32 PM
Accept pipeline input: False
Accept wildcard characters: False
-Users¶
Lista de usuarios para filtrar la búsqueda. Por lo general, se busca a los usuarios con el formato dominio\nombre de usuario.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
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.