Export (0) Print
Expand All
Expand Minimize

New-WebHandler

Published: February 29, 2012

Updated: August 15, 2012

Applies To: Windows Server 2012

New-WebHandler

Creates a new IIS request handler.

Syntax

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




Detailed Description

Creates a new IIS request handler.

Parameters

-Force

Forces creation of the new handler.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Location<String[]>

Configuration location in which the handler is configured.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-Modules<String>

Modules used for the handler.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

The name of the new request handler.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-PSPath<String[]>

An IIS configuration path.


Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-Path<String>

The physical path to the handler (native modules only).


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-Precondition<String>

Specifies any preconditions that are used for the new handler.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-RequiredAccess<String>

The user rights that are required for the new handler: Read, Write, Execute, or Script.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-ResourceType<String>

The resource type this handler executes.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-ScriptProcessor<String>

The script processor that executes for the module.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-Type<String>

The managed type of the new module (managed modules only).


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

-Verb<String>

The HTTP verbs handled by the new handler.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Examples

-------------- EXAMPLE 1: Add a new handler --------------

Adds a handler named "testHandler" to the Default Web Site.


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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft