New-WebHandler
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
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"