Set-WebHandler

Set-WebHandler

Configures an IIS request handler.

Syntax

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

Detailed Description

Configures an IIS request handler.

Parameters

-Location<String[]>

Location in which to set this configuration.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-Modules<String>

Modules needed for the handler (native handlers only).

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-Name<String>

The name of the handler to configure.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-PSPath<String[]>

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

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?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-Precondition<String>

Preconditions for the new handler.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-RequiredAccess<String>

Access user rights required for the module (Script, Read, Write, Execute).

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-ResourceType<String>

Resource type required for the handler.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-ScriptProcessor<String>

Script processor to execute for the handler (native handlers only).

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-Type<String>

Managed Type of the handler (managed handlers only).

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-Verb<String>

HTTP Verbs for which the handler is executed.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByPropertyName)
Accept Wildcard Characters?	false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WhatIf

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

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
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: Change a property of a handler --------------

Sets properties of a handler.

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