Invoke-NSUpdateAppFwLearningSettings
SYNOPSIS
Updates a NetScaler appfwlearningsettings resource.
SYNTAX
Invoke-NSUpdateAppFwLearningSettings [-ContentTypeAutodeploygraceperiod <Int32>]
[-ContentTypeMinThreshold <Int32>] [-ContentTypePercentThreshold <Int32>]
[-CookieConsistencyautodeploygraceperiod <Int32>] [-CookieConsistencyMinThreshold <Int32>]
[-CookieConsistencypercentThreshold <Int32>] [-CreditcardnumberMinThreshold <Int32>]
[-CreditcardnumberpercentThreshold <Int32>] [-Crosssitescriptingautodeploygraceperiod <Int32>]
[-CrosssitescriptingMinThreshold <Int32>] [-CrosssitescriptingpercentThreshold <Int32>]
[-Csrftagautodeploygraceperiod <Int32>] [-CsrftagMinThreshold <Int32>] [-CsrftagpercentThreshold <Int32>]
[-FieldConsistencyautodeploygraceperiod <Int32>] [-FieldConsistencyMinThreshold <Int32>]
[-FieldConsistencypercentThreshold <Int32>] [-FieldFormAtautodeploygraceperiod <Int32>]
[-FieldFormAtMinThreshold <Int32>] [-FieldFormAtpercentThreshold <Int32>] [-ProfileName] <String>
[-Sqlinjectionautodeploygraceperiod <Int32>] [-SqlinjectionMinThreshold <Int32>]
[-SqlinjectionpercentThreshold <Int32>] [-StartURLAutodeploygraceperiod <Int32>]
[-StartURLMinThreshold <Int32>] [-StartURLPercentThreshold <Int32>] [-XMLAttachmentMinThreshold <Int32>]
[-XMLAttachmeNTPErcentThreshold <Int32>] [-XMLWsiMinThreshold <Int32>] [-XMLWSIPErcentThreshold <Int32>]
[-Session <PSObject>] [-IgnoreNotFound] [-ReturnNullOnNotFound] [-ThrowOnWarning] [-PassThru] [-WhatIf]
[-Confirm] [<CommonParameters>]
DESCRIPTION
Configuration for learning settings resource.
EXAMPLES
EXAMPLE 1
EXAMPLE 2
PARAMETERS
-ContentTypeAutodeploygraceperiod
The number of minutes after the threshold hit alert the learned rule will be deployed. Default value: 10080 Minimum value = 5 Maximum value = 43200
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-ContentTypeMinThreshold
Minimum threshold to learn Content Type information. Default value: 1 Minimum value = 1
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-ContentTypePercentThreshold
Minimum threshold in percent to learn Content Type information. Default value: 0 Minimum value = 0 Maximum value = 100
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-CookieConsistencyautodeploygraceperiod
The number of minutes after the threshold hit alert the learned rule will be deployed. Default value: 10080 Minimum value = 5 Maximum value = 43200
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-CookieConsistencyMinThreshold
Minimum number of application firewall sessions that the learning engine must observe to learn cookies. Default value: 1 Minimum value = 1
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-CookieConsistencypercentThreshold
Minimum percentage of application firewall sessions that must contain a particular cookie pattern for the learning engine to learn that cookie. Default value: 0 Minimum value = 0 Maximum value = 100
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-CreditcardnumberMinThreshold
Minimum threshold to learn Credit Card information. Default value: 1 Minimum value = 1
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-CreditcardnumberpercentThreshold
Minimum threshold in percent to learn Credit Card information. Default value: 0 Minimum value = 0 Maximum value = 100
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-Crosssitescriptingautodeploygraceperiod
The number of minutes after the threshold hit alert the learned rule will be deployed. Default value: 10080 Minimum value = 5 Maximum value = 43200
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-CrosssitescriptingMinThreshold
Minimum number of application firewall sessions that the learning engine must observe to learn HTML cross-site scripting patterns. Default value: 1 Minimum value = 1
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-CrosssitescriptingpercentThreshold
Minimum percentage of application firewall sessions that must contain a particular cross-site scripting pattern for the learning engine to learn that cross-site scripting pattern. Default value: 0 Minimum value = 0 Maximum value = 100
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-Csrftagautodeploygraceperiod
The number of minutes after the threshold hit alert the learned rule will be deployed. Default value: 10080 Minimum value = 5 Maximum value = 43200
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-CsrftagMinThreshold
Minimum number of application firewall sessions that the learning engine must observe to learn cross-site request forgery (CSRF) tags. Default value: 1 Minimum value = 1
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-CsrftagpercentThreshold
Minimum percentage of application firewall sessions that must contain a particular CSRF tag for the learning engine to learn that CSRF tag. Default value: 0 Minimum value = 0 Maximum value = 100
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-FieldConsistencyautodeploygraceperiod
The number of minutes after the threshold hit alert the learned rule will be deployed. Default value: 10080 Minimum value = 5 Maximum value = 43200
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-FieldConsistencyMinThreshold
Minimum number of application firewall sessions that the learning engine must observe to learn field consistency information. Default value: 1 Minimum value = 1
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-FieldConsistencypercentThreshold
Minimum percentage of application firewall sessions that must contain a particular field consistency pattern for the learning engine to learn that field consistency pattern. Default value: 0 Minimum value = 0 Maximum value = 100
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-FieldFormAtautodeploygraceperiod
The number of minutes after the threshold hit alert the learned rule will be deployed. Default value: 10080 Minimum value = 5 Maximum value = 43200
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-FieldFormAtMinThreshold
Minimum number of application firewall sessions that the learning engine must observe to learn field formats. Default value: 1 Minimum value = 1
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-FieldFormAtpercentThreshold
Minimum percentage of application firewall sessions that must contain a particular web form field pattern for the learning engine to recommend a field format for that form field. Default value: 0 Minimum value = 0 Maximum value = 100
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-ProfileName
Name of the profile. Minimum length = 1
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Sqlinjectionautodeploygraceperiod
The number of minutes after the threshold hit alert the learned rule will be deployed. Default value: 10080 Minimum value = 5 Maximum value = 43200
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-SqlinjectionMinThreshold
Minimum number of application firewall sessions that the learning engine must observe to learn HTML SQL injection patterns. Default value: 1 Minimum value = 1
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-SqlinjectionpercentThreshold
Minimum percentage of application firewall sessions that must contain a particular HTML SQL injection pattern for the learning engine to learn that HTML SQL injection pattern. Default value: 0 Minimum value = 0 Maximum value = 100
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-StartURLAutodeploygraceperiod
The number of minutes after the threshold hit alert the learned rule will be deployed. Default value: 10080 Minimum value = 5 Maximum value = 43200
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-StartURLMinThreshold
Minimum number of application firewall sessions that the learning engine must observe to learn start URLs. Default value: 1 Minimum value = 1
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-StartURLPercentThreshold
Minimum percentage of application firewall sessions that must contain a particular start URL pattern for the learning engine to learn that start URL. Default value: 0 Minimum value = 0 Maximum value = 100
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-XMLAttachmentMinThreshold
Minimum number of application firewall sessions that the learning engine must observe to learn XML attachment patterns. Default value: 1 Minimum value = 1
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-XMLAttachmeNTPErcentThreshold
Minimum percentage of application firewall sessions that must contain a particular XML attachment pattern for the learning engine to learn that XML attachment pattern. Default value: 0 Minimum value = 0 Maximum value = 100
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-XMLWsiMinThreshold
Minimum number of application firewall sessions that the learning engine must observe to learn web services interoperability (WSI) information. Default value: 1 Minimum value = 1
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-XMLWSIPErcentThreshold
Minimum percentage of application firewall sessions that must contain a particular pattern for the learning engine to learn a web services interoperability (WSI) pattern. Default value: 0 Minimum value = 0 Maximum value = 100
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-Session
The NetScaler session. If omitted, the current default session is used.
Type: PSObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: (Get-NSSession)
Accept pipeline input: False
Accept wildcard characters: False
-IgnoreNotFound
Returns null instead of throwing for known NITRO not-found responses.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ReturnNullOnNotFound
Returns null instead of throwing for known NITRO not-found responses.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ThrowOnWarning
Treats NITRO warning responses as terminating errors.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Returns the updated resource after the operation completes.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
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
System.Management.Automation.PSCustomObject
NOTES
Generated from NetScaler NITRO API metadata. Generated: 2026-06-01 21:28 Supported metadata versions: 13.1, 14.1.