Set-WebApplicationProxyApplication
Set-WebApplicationProxyApplication
Modifies settings of a web application published through Прокси-служба веб-приложения.
Синтаксис
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>]
Подробное описание
The Set-WebApplicationProxyApplication cmdlet modifies settings of a web application published through Прокси-служба веб-приложения. 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.
Параметры
-AsJob
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
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.
Псевдонимы |
SPN |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-BackendServerCertificateValidation<String>
Specifies whether Прокси-служба веб-приложения validates the certificate that the backend server presents. Ниже указаны допустимые значения этого параметра.
-- None
-- ValidateCertificate
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
None |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
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.
Псевдонимы |
BackendUrl |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-CimSession<CimSession[]>
Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объекта сеанса, например результат выполнения командлета New-CimSession или Get-CimSession. Сеанс по умолчанию — текущий сеанс на локальном компьютере.
Псевдонимы |
Session |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-ClientCertificateAuthenticationBindingMode<String>
Specifies whether Прокси-служба веб-приложения verifies whether the certificate that authenticates the federation server authenticates future requests. Ниже указаны допустимые значения этого параметра.
-- None
-- ValidateCertificate
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
None |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
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.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-DisableHttpOnlyCookieProtection
Indicates whether to disable the use of the HttpOnly flag when Прокси-служба веб-приложения 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
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-DisableTranslateUrlInRequestHeaders
Indicates that Прокси-служба веб-приложения 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.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
false |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-DisableTranslateUrlInResponseHeaders
Indicates that Прокси-служба веб-приложения 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.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
false |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
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.
Псевдонимы |
ExternalCert |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
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.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-ID<Guid>
Specifies the GUID of a web application. To obtain the GUID of a web application, use the Get-WebApplicationProxyApplication cmdlet.
Псевдонимы |
ApplicationID |
Требуется? |
true |
Указать положение? |
1 |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-InactiveTransactionsTimeoutSec<UInt32>
Specifies the length of time, in seconds, until Прокси-служба веб-приложения closes incomplete HTTP transactions.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
300 |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-Name<String>
Specifies a friendly name for the published web application.
Псевдонимы |
FriendlyName |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-ThrottleLimit<Int32>
Определяет максимальное число одновременных операций, которое можно установить для запуска командлета. Если этот параметр опущен или имеет значение 0
, Windows PowerShell® вычисляет оптимальный предел регулирования для командлета на основе числа командлетов CIM, запущенных на компьютере. Предел регулирования применяется только к текущему командлету, а не к сеансу или компьютеру. Do not specify a value for this parameter greater than 1.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
1 |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-UseOAuthAuthentication
Indicates that Прокси-служба веб-приложения provides the URL of the federation server that performs Open Authorization (OAuth) when users connect to the application by using a Windows Store app.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
false |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
<CommonParameters>
Этот командлет поддерживает следующие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, и -OutVariable. Для получения дополнительных сведений см. about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Входные данные
Тип входных данных — это тип объектов, которые можно передать в командлет через конвейер.
Выходные данные
Тип выходных данных — это тип объектов, которые выдает командлет.
Примеры
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
Связанные темы
Add-WebApplicationProxyApplication
Get-WebApplicationProxyApplication
Remove-WebApplicationProxyApplication
Web Application Proxy Overview
Publishing Internal Applications using Web Application Proxy