Install-WebApplicationProxy
Install-WebApplicationProxy
Configures Proxy d’application web on the server.
Syntaxe
Parameter Set: Proxy
Install-WebApplicationProxy -CertificateThumbprint <String> -FederationServiceName <String> -FederationServiceTrustCredential <PSCredential> [-ForwardProxy <String> ] [-HttpsPort <Int32> ] [-TlsClientPort <Int32> ] [ <CommonParameters>]
Description détaillée
The Install-WebApplicationProxy cmdlet configures Proxy d’application web on the current server.
The FederationServiceName parameter specifies the Federation Service that provides authentication for Proxy d’application web. The FederationServiceTrustCredential parameter specifies the Active Directory Federation Services (AD FS) identity that is authorized to register new Federation server proxies. The CertificateThumbprint parameter specifies the thumbprint of the certificate that Proxy d’application web uses to identify the server to users as a proxy for the Federation Service. You can also specify the name of a forward proxy, the HTTPS port for the Proxy d’application web server, and the port for the Transport Layer Security (TLS) client.
Paramètres
-CertificateThumbprint<String>
Specifies the certificate thumbprint, as a string, of the certificate that Proxy d’application web presents to users to identify the Proxy d’application web as a proxy for the Federation Service. The thumbprint is 40 hexadecimal characters.
The certificate must be in the Personal store for the local computer. You can use a simple certificate, a subject alternative name (SAN) certificate, or a wildcard certificate.
Alias |
none |
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-FederationServiceName<String>
Specifies the name of a Federation Service. This is the Federation Service for which Proxy d’application web provides AD FS proxy functionality and stores the configuration of the Federation Service.
Alias |
none |
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-FederationServiceTrustCredential<PSCredential>
Specifies a PSCredential object that contains the credentials of the AD FS identity that is authorized to register new Federation server proxies. Specify an account that has permissions to manage the Federation Service.
To obtain a PSCredential object, use the Get-Credential cmdlet. For more information, type Get-Help Get-Credential.
Alias |
none |
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-ForwardProxy<String>
Specifies the DNS name and port number of an HTTP proxy that this federation server proxy uses to obtain access to the federation service. Specify the value for this parameter in the following format: FQDN:PortNumber. For example, to specify a forward proxy with a host name of "proxy01" that is located within the corp.contoso.com domain and that can be reached using the HTTP port of 8080 would be "proxy-01.corp.contoso.com:8080". Note: This parameter applies only to Federation Services proxy. It does not apply for application publishing.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-HttpsPort<Int32>
Specifies the HTTPS port for the Proxy d’application web server. The default value is 443.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-TlsClientPort<Int32>
Specifies the port for the TLS client. Proxy d’application web uses this port for user certificate authentication. The default value is 49443.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
Exemples
Example 1: Configure Web Application Proxy on the server
This example configures Proxy d’application web on the local server.
The first command uses the Get-Credential cmdlet to create a credential, and then stores it in the $FScredential variable. The cmdlet prompts you for a user name and password. For more information, type Get-Help Get-Credential.
The second command configures Proxy d’application web on the local server. The command specifies the name of the Federation Service for which Proxy d’application web provides an AD FS proxy. The command specifies the thumbprint of the certificate that Proxy d’application web presents to users to identify the Proxy d’application web server as a proxy for the Federation Service.
PS C:\> $FScredential = Get-Credential
PS C:\> Install-WebApplicationProxy -FederationServiceName "FS01.Contoso.com" -FederationServiceTrustCredential $FScredential -CertificateThumbprint "0a1b2c3d0a1b2c3d0a1b2c3d0a1b2c3d0a1b2c3d"
Rubriques connexes
Add-WebApplicationProxyApplication
Get-WebApplicationProxyApplication