Set-WebHandler

Configures an IIS request handler.

Syntax

Set-WebHandler
   [-Name] <String>
   [[-PSPath] <String[]>]
   [-Confirm]
   [-Location <String[]>]
   [-Modules <String>]
   [-Path <String>]
   [-Precondition <String>]
   [-RequiredAccess <String>]
   [-ResourceType <String>]
   [-ScriptProcessor <String>]
   [-Type <String>]
   [-Verb <String>]
   [-WhatIf]
   [<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