filter (optional): A hash of one or more name-value pairs, in which the name represents the property value to test and the value represents a pattern the property must match. If more than one pair is present, all the patterns must match.