Set-ClientAccessServer
이 cmdlet은 온-프레미스 Exchange에서만 제공됩니다.
Set-ClientAccessServer cmdlet을 사용하여 클라이언트 액세스 서버 역할과 연결된 설정을 수정합니다.
참고: Exchange 2013 이상에서는 대신 Set-ClientAccessService cmdlet을 사용합니다. Set-ClientAccessServer를 사용하는 스크립트가 있는 경우 Set-ClientAccessService를 사용하도록 업데이트합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
AlternateServiceAccount
Set-ClientAccessServer
[-Identity] <ClientAccessServerIdParameter>
[-AlternateServiceAccountCredential <PSCredential[]>]
[-CleanUpInvalidAlternateServiceAccountCredentials]
[-Confirm]
[-DomainController <Fqdn>]
[-IrmLogEnabled <Boolean>]
[-IrmLogMaxAge <EnhancedTimeSpan>]
[-IrmLogMaxDirectorySize <Unlimited>]
[-IrmLogMaxFileSize <ByteQuantifiedSize>]
[-IrmLogPath <LocalLongFullPath>]
[-IsOutOfService <Boolean>]
[-RemoveAlternateServiceAccountCredentials]
[-WhatIf]
[<CommonParameters>]
Identity
Set-ClientAccessServer
[-Identity] <ClientAccessServerIdParameter>
[-Array <ClientAccessArrayIdParameter>]
[-AutoDiscoverServiceInternalUri <Uri>]
[-AutoDiscoverSiteScope <MultiValuedProperty>]
[-Confirm]
[-DomainController <Fqdn>]
[-IrmLogEnabled <Boolean>]
[-IrmLogMaxAge <EnhancedTimeSpan>]
[-IrmLogMaxDirectorySize <Unlimited>]
[-IrmLogMaxFileSize <ByteQuantifiedSize>]
[-IrmLogPath <LocalLongFullPath>]
[-IsOutOfService <Boolean>]
[-WhatIf]
[<CommonParameters>]
Description
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 문서에서는 cmdlet에 대한 모든 매개 변수를 나열하지만 할당된 권한에 포함되지 않은 경우 일부 매개 변수에 액세스할 수 없을 수 있습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Set-ClientAccessServer -Identity "MBX-01" -AutoDiscoverServiceInternalUri "https://mbx01.contoso.com/autodiscover/autodiscover.xml" -AutoDiscoverSiteScope "Mail"
이 예제에서는 MBX-01이라는 서버의 클라이언트 액세스 서비스에서 Mail이라는 Active Directory 사이트에 대한 내부 자동 검색 URL을 구성합니다.
매개 변수
-AlternateServiceAccountCredential
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
AlternateServiceAccountCredential 매개 변수는 Exchange Server 2010 공존 환경에서 Kerberos 인증에 일반적으로 사용되는 대체 서비스 계정 사용자 이름 및 암호를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수의 값에는 Get-Credential cmdlet이 있어야 합니다. 이 명령을 일시 중지 하고 자격 증명을 입력 하라는 메시지가 표시 되면 (Get-Credential)값을 사용 합니다. 또는이 명령을 실행 하기 전에 자격 증명을 변수에 저장 (예: $cred = Get-Credential) 한 다음이 매개 변수에 대 한 변수 이름 ($cred)을 사용 합니다. 자세한 내용은 Get-Credential을 참조하세요.
매개 변수 속성
| 형식: | PSCredential[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
AlternateServiceAccount
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Array
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
매개 변수 속성
| 형식: | ClientAccessArrayIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-AutoDiscoverServiceInternalUri
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
AutoDiscoverServiceInternalUri 매개 변수는 자동 검색 서비스의 내부 URL을 지정합니다.
매개 변수 속성
| 형식: | Uri |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-AutoDiscoverSiteScope
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
AutoDiscoverSiteScope 매개 변수는 자동 검색 서비스가 신뢰할 수 있는 Active Directory 사이트를 지정합니다. 내부 URL을 사용하여 자동 검색 서비스에 연결하는 클라이언트는 지정된 사이트에 있어야 합니다.
사용 가능한 Active Directory 사이트를 보려면 Get-ADSite cmdlet을 사용합니다.
여러 값을 지정하려면 구문을 Value1,Value2,...ValueN사용합니다. 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-CleanUpInvalidAlternateServiceAccountCredentials
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
CleanUpInvalidAlternateServiceAccountCredentials 스위치는 더 이상 사용할 수 없는 이전에 구성한 대체 서비스 계정을 제거할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
AlternateServiceAccount
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Confirm
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 이 스위치가 cmdlet에 미치는 영향은 계속하기 전에 cmdlet에 확인이 필요한지 여부에 따라 달라집니다.
- 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문
-Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다. - 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 확인 스위치를 지정하면 계속하기 전에 명령을 승인하도록 강제하는 일시 중지가 발생합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | Cf |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-DomainController
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com
매개 변수 속성
| 형식: | Fqdn |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Identity 매개 변수는 수정하려는 서버를 지정합니다. 서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예제:
- 이름
- DN(고유 이름)
- FQDN
- GUID
매개 변수 속성
| 형식: | ClientAccessServerIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-IrmLogEnabled
적용 가능: Exchange Server 2010
IrmLogEnabled 매개 변수는 IRM(정보 권한 관리)에 로깅을 사용할 수 있는지 여부를 지정합니다. 유효한 값은 $true 또는 $false입니다. 기본값은 $true입니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IrmLogMaxAge
적용 가능: Exchange Server 2010
IrmLogMaxAge 매개 변수는 IRM 로그의 최대 기간을 지정합니다. 지정된 값보다 오래된 로그가 삭제됩니다.
값을 지정하려면 dd.hh:mm:ss 형식으로 기간을 입력합니다. 여기서 d는 일, h는 시간, m은 분, s는 초를 나타냅니다.
예를 들어 15시간 간격을 지정하려면 15:00:00을 입력합니다. 기본값은 30일(30.00:00:00)입니다.
매개 변수 속성
| 형식: | EnhancedTimeSpan |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IrmLogMaxDirectorySize
적용 가능: Exchange Server 2010
IrmLogMaxDirectorySize 매개 변수는 IRM 로그의 최대 디렉터리 크기를 지정합니다. 최대 디렉터리 크기에 도달하면 서버는 먼저 이전 로그 파일을 삭제합니다.
사용할 수 있는 값은 최대 909.5테라바이트(999999999999999바이트)까지의 숫자 또는 unlimited 값입니다. 기본값은 250MB(262144000바이트)입니다.
사용할 수 있는 값은 최대 1.999999999테라바이트(2199023254528바이트)까지의 숫자 또는 unlimited 값입니다. 기본값은 6기가바이트(6442450944바이트)입니다.
- B(바이트)
- KB(킬로바이트)
- MB(메가바이트)
- GB(기가바이트)
- TB(테라바이트)
정규화되지 않은 값은 일반적으로 바이트로 처리되지만 작은 값은 가장 가까운 킬로바이트까지 반올림될 수 있습니다.
매개 변수 속성
| 형식: | Unlimited |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IrmLogMaxFileSize
적용 가능: Exchange Server 2010
IrmLogMaxFileSize 매개 변수는 IRM 로그의 최대 크기를 지정합니다. 이 값은 IrmLogMaxDirectorySize 매개 변수 값보다 클 수 없습니다.
유효한 값은 최대 4GB(4294967296 바이트)의 숫자입니다. 기본값은 10MB(10485760바이트)입니다.
사용할 수 있는 값은 최대 1.999999999테라바이트(2199023254528바이트)까지의 숫자 또는 unlimited 값입니다. 기본값은 6기가바이트(6442450944바이트)입니다.
- B(바이트)
- KB(킬로바이트)
- MB(메가바이트)
- GB(기가바이트)
정규화되지 않은 값은 일반적으로 바이트로 처리되지만 작은 값은 가장 가까운 킬로바이트까지 반올림될 수 있습니다.
이 매개 변수의 값은 ReceiveProtocolLogMaxDirectorySize 매개 변수의 값 이하여야 합니다.
매개 변수 속성
| 형식: | ByteQuantifiedSize |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IrmLogPath
적용 가능: Exchange Server 2010
IrmLogPath 매개 변수는 IRM 로그 파일의 위치를 지정합니다. 기본 위치는 %ExchangeInstallPath%Logging\IRMLogs입니다.
이 매개 변수의 값을 $null로 설정하면 IRM 로깅을 실질적으로 사용할 수 없게 됩니다. 그러나 IrmLogEnabled 매개 변수의 값이 $true 경우 Exchange는 애플리케이션 이벤트 로그에 오류를 추가합니다. 기본적으로는 IRM 로깅을 사용하지 않도록 설정하려면 IrmLogEnabled 매개 변수를 $false로 설정합니다.
매개 변수 속성
| 형식: | LocalLongFullPath |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IsOutOfService
적용 가능: Exchange Server 2010
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RemoveAlternateServiceAccountCredentials
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
RemoveAlternateServiceAccountCredentials 스위치는 이전에 배포한 대체 서비스 계정을 제거할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
AlternateServiceAccount
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
WhatIf 스위치는 명령을 변경하지 않고 수행하는 작업을 보여줍니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.