Set-WebApplicationProxyApplication

Set-WebApplicationProxyApplication

Modifies settings of a web application published through Proxy d’application web.

Syntaxe

Parameter Set: Add0
Set-WebApplicationProxyApplication [-DisableHttpOnlyCookieProtection] [ <CommonParameters>]

Parameter Set: ID
Set-WebApplicationProxyApplication [-ID] <Guid> [-AsJob] [-BackendServerAuthenticationSPN <String> ] [-BackendServerCertificateValidation <String> ] [-BackendServerUrl <Uri> ] [-CimSession <CimSession[]> ] [-ClientCertificateAuthenticationBindingMode <String> ] [-ClientCertificatePreauthenticationThumbprint <String> ] [-DisableTranslateUrlInRequestHeaders] [-DisableTranslateUrlInResponseHeaders] [-ExternalCertificateThumbprint <String> ] [-ExternalUrl <Uri> ] [-InactiveTransactionsTimeoutSec <UInt32> ] [-Name <String> ] [-ThrottleLimit <Int32> ] [-UseOAuthAuthentication] [ <CommonParameters>]

Description détaillée

The Set-WebApplicationProxyApplication cmdlet modifies settings of a web application published through Proxy d’application web. Specify the web application to modify by using its ID. Note that the method of pre-authentication cannot be changed. The cmdlet ensures that no other applications are already configured to use any specified ExternalURL or BackendServerURL.

Paramètres

-AsJob

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

-BackendServerAuthenticationSPN<String>

Specifies the SPN of the backend server. Use this parameter if the application that the backend server hosts uses Integrated Windows authentication.

Alias	SPN
Obligatoire ?	false
Position ?	named
Valeur par défaut	none
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-BackendServerCertificateValidation<String>

Specifies whether Proxy d’application web validates the certificate that the backend server presents. Les valeurs acceptables pour ce paramètre sont :

-- None
-- ValidateCertificate

Alias	none
Obligatoire ?	false
Position ?	named
Valeur par défaut	None
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-BackendServerUrl<Uri>

Specifies the address of the web application. Specify the protocol and host name or IP address. Include the trailing slash (/). You can also include a port number and path. The following examples show the form of an address:

-- http://AccountingApp.Contoso.com/
-- http://Mail.Contoso.com/Remote/
-- http://Portal/

The cmdlet checks that no other applications are already configured to use this URL.

Alias	BackendUrl
Obligatoire ?	false
Position ?	named
Valeur par défaut	none
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-CimSession<CimSession[]>

Exécute l’applet de commande dans une session à distance ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, comme la sortie d’une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session active sur l’ordinateur local.

Alias	Session
Obligatoire ?	false
Position ?	named
Valeur par défaut	none
Accepter l’entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-ClientCertificateAuthenticationBindingMode<String>

Specifies whether Proxy d’application web verifies whether the certificate that authenticates the federation server authenticates future requests. Les valeurs acceptables pour ce paramètre sont :

-- None
-- ValidateCertificate

Alias	none
Obligatoire ?	false
Position ?	named
Valeur par défaut	None
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-ClientCertificatePreauthenticationThumbprint<String>

Specifies the certificate thumbprint, as a string, of the certificate that a client supplies for the preauthentication feature. The thumbprint is 40 hexadecimal characters. This parameter is only relevant when you specify the value of ClientCertificate for the ExternalPreauthentication parameter.

Alias	none
Obligatoire ?	false
Position ?	named
Valeur par défaut	none
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-DisableHttpOnlyCookieProtection

Indicates whether to disable the use of the HttpOnly flag when Proxy d’application web sets the access cookie. The access cookie provides single sign-on access to an application.

Important: by default, HttpOnly is enabled to help ensure network protection. If you disable HttpOnly flag protection, the browser may share this cookie with other components on the client device, such as ActiveX, Java Applets and JavaScript, so they can access this application without the need to perform additional preauthentication

Alias	none
Obligatoire ?	false
Position ?	named
Valeur par défaut	none
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-DisableTranslateUrlInRequestHeaders

Indicates that Proxy d’application web does not translate HTTP host headers from public host headers to internal host headers when it forwards the request to the published application.

Specify this parameter if the application uses path-based information.

Alias	none
Obligatoire ?	false
Position ?	named
Valeur par défaut	false
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-DisableTranslateUrlInResponseHeaders

Indicates that Proxy d’application web does not translate internal host names to public host names in Content-Location, Location, and Set-Cookie response headers in redirect responses.

If the proxy does not translate host names in the Content-Location or Location response headers, subsequent client requests resolve incorrectly. If the proxy does not translate the host name in the Set-Cookie response header, the published web application might not use cookies properly.

Alias	none
Obligatoire ?	false
Position ?	named
Valeur par défaut	false
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-ExternalCertificateThumbprint<String>

Specifies the certificate thumbprint, as a string, of the certificate to use for the address specified by the ExternalUrl parameter. The thumbprint is 40 hexadecimal characters.

The certificate must exist in the Local Computer or Local Personal certificate store. You can use a simple certificate, a subject alternative name (SAN) certificate, or a wildcard certificate.

Alias	ExternalCert
Obligatoire ?	false
Position ?	named
Valeur par défaut	none
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-ExternalUrl<Uri>

Specifies the external address, as a URL, for the web application. Include the trailing slash (/).

The cmdlet checks that no other applications are already configured to use this URL.

Alias	none
Obligatoire ?	false
Position ?	named
Valeur par défaut	none
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-ID<Guid>

Specifies the GUID of a web application. To obtain the GUID of a web application, use the Get-WebApplicationProxyApplication cmdlet.

Alias	ApplicationID
Obligatoire ?	true
Position ?	1
Valeur par défaut	none
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-InactiveTransactionsTimeoutSec<UInt32>

Specifies the length of time, in seconds, until Proxy d’application web closes incomplete HTTP transactions.

Alias	none
Obligatoire ?	false
Position ?	named
Valeur par défaut	300
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-Name<String>

Specifies a friendly name for the published web application.

Alias	FriendlyName
Obligatoire ?	false
Position ?	named
Valeur par défaut	none
Accepter l’entrée de pipeline ?	True (ByPropertyName)
Accepter les caractères génériques ?	false

-ThrottleLimit<Int32>

Spécifie le nombre maximal d’opérations simultanées qui peuvent être établies pour exécuter cette applet de commande. Si ce paramètre est omis ou si la valeur 0 est entrée, Windows PowerShell ® calcule une limitation optimale pour l’applet de commande en fonction du nombre d’applets de commande CIM qui s’exécutent sur l’ordinateur. La limitation s’applique seulement à l’applet de commande actuelle, et non pas à la session ni à l’ordinateur. Do not specify a value for this parameter greater than 1.

Alias	none
Obligatoire ?	false
Position ?	named
Valeur par défaut	1
Accepter l’entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-UseOAuthAuthentication

Indicates that Proxy d’application web provides the URL of the federation server that performs Open Authorization (OAuth) when users connect to the application by using a Windows Store app.

Alias	none
Obligatoire ?	false
Position ?	named
Valeur par défaut	false
Accepter l’entrée de pipeline ?	True (ByPropertyName)
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: Change the extern URL for a web application

This command changes the external URL to https://sp.contoso.com/ for the web application that has the specified ID.

PS C:\> Set-WebApplicationProxyApplication -ID 874A4543-7983-77A3-1E6D-1163E7419AC1 -ExternalUrl https://SP.Contoso.com/

Example 2: Change the backend server URL and the external URL

This command modifies a web application that has the specified ID. The command changes the backend server to be https://Portal.Contoso.com/ and the external URL to be https://SP.Contoso.com/.

PS C:\> Set-WebApplicationProxyApplication -ID 874A4543-7983-77A3-1E6D-1163E7419AC1 -BackendServerUrl https://Portal.Contoso.com/ -ExternalUrl https://SP.Contoso.com/ 

Example 3: Change the name of a web application

This command changes the friendly name of an application that has the specified ID.

PS C:\> Set-WebApplicationProxyApplication -ID 874A4543-7983-77A3-1E6D-1163E7419AC1 -Name Test123

Example 4: Disable URL translation in headers

This command modifies the web application that has the specified ID. The command disables URL translation in both request and response headers.

PS C:\> Set-WebApplicationProxyApplication -ID 874A4543-7983-77A3-1E6D-1163E7419AC1 -DisableTranslateUrlInRequestHeaders -DisableTranslateUrlInResponseHeaders

Example 5: Change the certificate thumbprint for a web application

This command changes the external certificate thumbprint for the web application that has the specified ID.

PS C:\> Set-WebApplicationProxyApplication -ID 874A4543-7983-77A3-1E6D-1163E7419AC1 –ExternalCertificateThumbprint FFAFA2422D77BC784D1F48E08F6BDAE32CD109A2

Example 6: Change the timeout interval for web applications

This command changes the inactive transaction timeout for all web applications whose names begin with the string SharePoint.

PS C:\> Get-WebApplicationProxyApplication SharePoint* | Set-WebApplicationProxyApplication -InactiveTransactionsTimeoutSec 400

Rubriques connexes

Add-WebApplicationProxyApplication

Get-WebApplicationProxyApplication

Remove-WebApplicationProxyApplication

Web Application Proxy Overview

Publishing Internal Applications using Web Application Proxy