Add-PodeStaticRoute
SYNOPSIS
Add a static Route for rendering static content.
SYNTAX
Add-PodeStaticRoute [-Path] <String> [-Source] <String> [[-Middleware] <Object[]>] [[-EndpointName] <String[]>]
[[-ContentType] <String>] [[-TransferEncoding] <String>] [[-Defaults] <String[]>]
[[-ErrorContentType] <String>] [[-Authentication] <String>] [[-IfExists] <Object>] [-AllowAnon]
[-DownloadOnly] [-PassThru] [<CommonParameters>]
DESCRIPTION
Add a static Route for rendering static content. You can also define default pages to display.
EXAMPLES
EXAMPLE 1
Add-PodeStaticRoute -Path '/assets' -Source './assets'
EXAMPLE 2
Add-PodeStaticRoute -Path '/assets' -Source './assets' -Defaults @('index.html')
EXAMPLE 3
Add-PodeStaticRoute -Path '/installers' -Source './exes' -DownloadOnly
PARAMETERS
-AllowAnon
If supplied, the static route will allow anonymous access for non-authenticated users.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Authentication
The name of an Authentication method which should be used as middleware on this Route.
Type: String
Parameter Sets: (All)
Aliases: Auth
Required: False
Position: 9
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ContentType
The content type the static Route should use when parsing any payloads.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 5
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Defaults
An array of default pages to display, such as 'index.html'.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: 7
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DownloadOnly
When supplied, all static content on this Route will be attached as downloads - rather than rendered.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-EndpointName
The EndpointName of an Endpoint(s) to bind the static Route against.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ErrorContentType
The content type of any error pages that may get returned.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 8
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IfExists
Specifies what action to take when a Static Route already exists. (Default: Default)
Type: Object
Parameter Sets: (All)
Aliases:
Required: False
Position: 10
Default value: Default
Accept pipeline input: False
Accept wildcard characters: False
-Middleware
An array of ScriptBlocks for optional Middleware.
Type: Object[]
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
If supplied, the static route created will be returned so it can be passed through a pipe.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Path
The URI path for the static Route.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Source
The literal, or relative, path to the directory that contains the static content.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TransferEncoding
The transfer encoding the static Route should use when parsing any payloads.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 6
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.