Set-WebApplicationProxyApplication
Set-WebApplicationProxyApplication
Modifies settings of a web application published through .
구문
Parameter Set: ID
Set-WebApplicationProxyApplication [-ID] <Guid> [-ADFSUserCertificateStore <System.String> ] [-BackendServerAuthenticationMode <System.String> ] [-BackendServerAuthenticationSPN <String> ] [-BackendServerCertificateValidation <String> {None | ValidateCertificate} ] [-BackendServerUrl <Uri> ] [-CimSession <CimSession[]> ] [-ClientCertificateAuthenticationBindingMode <String> {None | ValidateCertificate} ] [-ClientCertificatePreauthenticationThumbprint <String> ] [-DisableHttpOnlyCookieProtection] [-DisableTranslateUrlInRequestHeaders] [-DisableTranslateUrlInResponseHeaders] [-EnableHTTPRedirect] [-EnableSignOut] [-ExternalCertificateThumbprint <String> ] [-ExternalUrl <Uri> ] [-InactiveTransactionsTimeoutSec <UInt32> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Name <String> ] [-PersistentAccessCookieExpirationTimeSec <System.UInt32> ] [-ThrottleLimit <Int32> ] [-UseOAuthAuthentication] [ <CommonParameters>] [ <WorkflowParameters>]
자세한 설명
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 preauthentication cannot be changed. The cmdlet ensures that no other applications are already configured to use any specified ExternalURL or BackendServerURL.
매개 변수
-ADFSUserCertificateStore<System.String>
Specifies the certificate store for a user.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
true(ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-BackendServerAuthenticationMode<System.String>
Specifies the authentication method that uses when it contacts the backend server. 이 매개 변수에 허용되는 값은 다음과 같습니다. NoAuthentication and IntegratedWindowsAuthentication.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
true(ByPropertyName) |
와일드카드 문자 허용 여부 |
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 |
기본값 |
none |
파이프라인 입력 허용 여부 |
True (ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-BackendServerCertificateValidation<String>
Specifies whether validates the certificate that the backend server presents. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- None
-- ValidateCertificate
별칭 |
none |
필수 여부 |
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 |
기본값 |
none |
파이프라인 입력 허용 여부 |
True (ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-CimSession<CimSession[]>
원격 세션이나 원격 컴퓨터에서 cmdlet을 실행합니다. 컴퓨터 이름이나 New-CimSession 또는 Get-CimSession cmdlet의 출력과 같은 세션 개체를 입력하세요. 기본값은 로컬 컴퓨터 상의 현재 세션입니다.
별칭 |
Session |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-ClientCertificateAuthenticationBindingMode<String>
Specifies whether verifies whether the certificate that authenticates the federation server authenticates future requests. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- None
-- ValidateCertificate
별칭 |
none |
필수 여부 |
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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
True (ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-DisableHttpOnlyCookieProtection
Indicates that this cmdlet disables 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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
True (ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-EnableHTTPRedirect
Indicates that this cmdlet enables HTTP redirect for .
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
true(ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-EnableSignOut
Indicates whether to enable sign out for .
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
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 |
기본값 |
none |
파이프라인 입력 허용 여부 |
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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
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 |
기본값 |
none |
파이프라인 입력 허용 여부 |
True (ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-InactiveTransactionsTimeoutSec<UInt32>
Specifies the length of time, in seconds, until closes incomplete HTTP transactions.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
True (ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-InformationAction<System.Management.Automation.ActionPreference>
Specifies how this cmdlet responds to an information event. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
별칭 |
infa |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-InformationVariable<System.String>
Specifies a variable in which to store an information event message.
별칭 |
iv |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-Name<String>
Specifies a friendly name for the published web application.
별칭 |
FriendlyName |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
True (ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-PersistentAccessCookieExpirationTimeSec<System.UInt32>
Specifies the expiration time, in seconds, for persistent access cookies.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
true(ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-ThrottleLimit<Int32>
Cmdlet을 실행하도록 설정할 수 있는 동시 작업의 최대 수를 지정합니다. 이 매개 변수를 생략하거나 값으로 0 을 입력하면 Windows PowerShell®은 컴퓨터에서 실행 중인 CIM cmdlet의 수에 따라 cmdlet에 대한 최적의 스로틀 제한을 계산합니다. 스로틀 제한은 현재 cmdlet에만 적용되고, 세션이나 컴퓨터에는 적용되지 않습니다. Do not specify a value for this parameter greater than 1.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
True (ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)
<WorkflowParameters>
입력
입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.
출력
출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.
예
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 time-out interval for web applications
This command changes the inactive transaction time-out 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