Skip to main content
Version: v6 (preview) 🚧

Should-NotMatchString

This page was generated

Contributions are welcome in Pester-repo.

SYNOPSIS​

Tests whether a string does not match a regular expression pattern.

SYNTAX​

Should-NotMatchString [[-Actual] <Object>] [-Expected] <Object> [-CaseSensitive] [-Because <String>]
[<CommonParameters>]

DESCRIPTION​

The Should-NotMatchString assertion compares the actual string to the expected regular expression pattern using the -notmatch operator. The -notmatch operator is case-insensitive by default, but you can make it case-sensitive by using the -CaseSensitive switch.

EXAMPLES​

EXAMPLE 1​

"hello" | Should-NotMatchString "^world$"

This assertion will pass, because the actual value does not match the regular expression pattern.

EXAMPLE 2​

"hello" | Should-NotMatchString "h.*o" -CaseSensitive

This assertion will fail, because the actual value case-sensitively matches the regular expression pattern.

PARAMETERS​

-Actual​

The actual value.

Type: Object
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Expected​

The expected regular expression pattern.

Type: Object
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CaseSensitive​

Indicates that the comparison should be case-sensitive.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Because​

The reason why the actual value should not match the regular expression pattern.

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.

INPUTS​

OUTPUTS​

NOTES​

https://pester.dev/docs/commands/Should-NotMatchString

https://pester.dev/docs/assertions

VERSION​

This page was generated using comment-based help in Pester 6.0.0-alpha5.