New-WebHandler

Creates an IIS request handler.

Syntax

New-WebHandler
   [-Name] <String>
   [[-PSPath] <String[]>]
   [-Force]
   [-Location <String[]>]
   [-Modules <String>]
   -Path <String>
   [-Precondition <String>]
   [-RequiredAccess <String>]
   [-ResourceType <String>]
   [-ScriptProcessor <String>]
   [-Type <String>]
   -Verb <String>
   [<CommonParameters>]

Description

The New-WebHandler cmdlet creates an Internet Information Services (IIS) request handler.

Examples

Example 1: Add a new handler

IIS:\> New-WebHandler -Name "TestHandler" -Path "*.test" -Verb "GET,POST" -Modules "IsapiModule" -PSPath "IIS:\sites\Default Web Site"

This command adds a handler named TestHandler to the default website.

Required Parameters

-Name

Specifies the name of the new request handler.

Type:String
Position:0
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
-Verb

Specifies the HTTP verbs that are handled by the new handler.

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

Optional Parameters

-Force

Forces the creation of the new handler.

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

Specifies the configuration location in which the handler is configured.

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

Specifies the modules used for the handler.

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

Specifies an IIS configuration path.

Type:String[]
Position:1
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 user rights that are required for the new handler. 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 this handler runs.

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 that runs for the module.

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

Specifies the managed type of the new module. This parameter applies to managed modules only.

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