Find-ConfigurationItem¶
SYNOPSIS¶
Encuentra rápidamente elementos de configuración que coincidan con los filtros Name, ItemType y Properties especificados.
SYNTAX¶
Find-ConfigurationItem [[-Name] <String>] [[-ItemType] <String[]>] [[-EnableFilter] <String>]
[[-Properties] <Hashtable>] [<CommonParameters>]
DESCRIPTION¶
Encuentra rápidamente elementos de configuración que coincidan con los filtros Name, ItemType y Properties especificados mediante el método QueryItems disponible en la Configuración de API.
REQUIREMENTS
- Requires VMS connection and will attempt to connect automatically
EXAMPLES¶
EXAMPLE 1¶
Devuelve un elemento del API de configuración genérico para cada cámara que contiene la palabra "estacionamiento" en cualquier lugar del nombre.
EXAMPLE 2¶
Devuelve un elemento del API de configuración genérico para cada hardware con la dirección IP 192.168.1.101 presente en la propiedad 'Address' del dispositivo de hardware. El hardware suele tener una dirección con el formato de 'http://192.168.1.101/'.
EXAMPLE 3¶
Encuentra todas las cámaras que contienen la palabra "Estacionamiento" en cualquier lugar del nombre y las convierte de un elemento del API de configuración genérico a un objeto de cámara fuertemente tipificado, como lo que obtendrá al usar Get-VmsCamera.
PARAMETERS¶
-EnableFilter¶
Especifica si se deben incluir todos los elementos coincidentes o si solo se deben incluir los elementos habilitados o deshabilitados en los resultados. El valor predeterminado es incluir todos los elementos independientemente del estado.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: All, Disabled, Enabled
Required: False
Position: 2
Default value: All
Accept pipeline input: False
Accept wildcard characters: False
-ItemType¶
Especifica los tipos de elementos que se incluirán en los resultados. El valor predeterminado es incluir solo elementos 'Camera'.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: Camera
Accept pipeline input: False
Accept wildcard characters: False
-Name¶
Especifica el nombre o parte del nombre para mostrar del elemento de configuración que se va a buscar. Por ejemplo, si desea encontrar una cámara llamada "Aparcamiento Noroeste" y especifica el valor "Aparcamiento", obtendrá resultados para cualquier cámara en la que aparezca "Aparcamiento" en algún lugar del nombre. La búsqueda no distingue entre mayúsculas y minúsculas.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Properties¶
An optional hashtable of additional property keys and values to filter results. Properties must be string types, and the results will be included if the property key exists, and the value contains the provided string.
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: @{}
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¶
NOTES¶
El método QueryItems se agregó a la API de configuración en Milestone XProtect Management Server a partir de la versión 2020 R2. Si su versión de Milestone VMS es 2020 R1 o anterior, recibirá un error al usar este comando.
RELATED LINKS¶
Online Help Find-ConfigurationItem MIP SDK QueryItems documentation