Install-PswaWebApplication
Configures the Windows PowerShell®Web Access web application in IIS.
Syntax
Install-PswaWebApplication
[[-WebApplicationName] <String>]
[-WebSiteName <String>]
[-UseTestCertificate]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Install-PswaWebApplication cmdlet configures Windows PowerShell Web Access web application. This cmdlet installs the web application, associates it with a web site, and optionally creates a test SSL certificate using the useTestCertificate parameter. For security reasons web administrators should not use a test certificate for production environments.
Examples
EXAMPLE 1
PS C:\> Install-PswaWebApplication
This example installs the PSWA web application using the default values for the WebApplicationName (pswa) and WebSiteName (Default Web Site) parameters .
EXAMPLE 2
PS C:\>Install-PswaWebApplication -UseTestCertificate
This example installs the PSWA web application with a test certificate, and using the default values for the WebApplicationName and WebSiteName parameters.
Parameters
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseTestCertificate
Specifies that a test certificate is created. If this parameter is set to true, then this cmdlet creates a test certificate and configures the Windows PowerShell Web Access web application to use the certificate for HTTPS requests. If this parameter is set to false, then no certificate or binding is created. Set this value to false if another certificate is used for Windows PowerShell Web Access.
Type: | SwitchParameter |
Position: | Named |
Default value: | True |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WebApplicationName
Specifies the name for your web application. This is displayed as the last part of the Windows PowerShell Web Access URL.
Type: | String |
Position: | 0 |
Default value: | Pswa |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WebSiteName
Specifies the name of the Web Server (IIS) website on which to install this Windows PowerShell Web Access web application.
Type: | String |
Position: | Named |
Default value: | Default Web Site |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
None
Outputs
None