Set-Web Handler

Module:
webadministration
Configures an IIS request handler.

Syntax 

Set-WebHandler
   [-Name] <String>
   [-Path <String>]
   [-Verb <String>]
   [-Type <String>]
   [-Modules <String>]
   [-ScriptProcessor <String>]
   [-Precondition <String>]
   [-ResourceType <String>]
   [-RequiredAccess <String>]
   [-Location <String[]>]
   [[-PSPath] <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-WebHandler cmdlet configures an Internet Information Services (IIS) request handler.

Examples

Example 1: Change a property of a handler 

IIS:\> Set-WebHandler -Name "StaticFile" -Path "*.htm"

This command sets properties of a handler.

Required Parameters

-Name

Specifies the name of the handler to configure.

Type: String
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Aliases: cf
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Location

Specifies the location in which to set this configuration.

Type: String[]
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Modules

Specifies the modules needed for the handler. This parameter applies to native handlers only.

Type: String
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-PSPath

Specifies an IIS configuration path to the location in which the module is configured.

Type: String[]
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Path

Specifies the physical path to the handler. This parameter applies to native modules only.

Type: String
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Precondition

Specifies preconditions for the new handler.

Type: String
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-RequiredAccess

Specifies the access user rights that are required for the module. The acceptable values for this parameter are:

  • Read
  • Write
  • Execute
  • Script
Type: String
Parameter Sets: None, Read, Write, Script, Execute
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-ResourceType

Specifies the resource type required for the handler.

Type: String
Parameter Sets: File, Directory, Either, Unspecified
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-ScriptProcessor

Specifies the script processor to run for the handler. This parameter applies to native handlers only.

Type: String
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Type

Specifies the managed type of the handler. This parameter applies to managed handlers only.

Type: String
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Verb

Specifies the HTTP verbs for which the handler runs.

Type: String
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Aliases: wi
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False