New-WebHandler
Creates an IIS request handler.
Syntax
New-WebHandler
[-Name] <String>
-Path <String>
-Verb <String>
[-Type <String>]
[-Modules <String>]
[-ScriptProcessor <String>]
[-Precondition <String>]
[-ResourceType <String>]
[-RequiredAccess <String>]
[-Force]
[-Location <String[]>]
[[-PSPath] <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.
Parameters
-Force
Forces the creation of the new handler.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Modules
Specifies the modules used for the handler.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Specifies the name of the new request handler.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Precondition
Specifies preconditions for the new handler.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PSPath
Specifies an IIS configuration path.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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 |
Accepted values: | None, Read, Write, Script, Execute |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceType
Specifies the resource type this handler runs.
Type: | String |
Accepted values: | File, Directory, Either, Unspecified |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ScriptProcessor
Specifies the script processor that runs for the module.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Verb
Specifies the HTTP verbs that are handled by the new handler.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Related Links
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour