Set-OutlookProvider

모듈:: ExchangePowerShell

적용 대상:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

이 cmdlet은 온-프레미스 Exchange에서만 제공됩니다.

Set-OutlookProvider cmdlet을 사용하여 Active Directory의 msExchAutoDiscoverConfig 개체에서 msExchOutlookProvider 특성을 사용하여 특정 전역 설정을 설정합니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

구문

Set-OutlookProvider
   [-Identity] <OutlookProviderIdParameter>
   [-CertPrincipalName <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Name <String>]
   [-OutlookProviderFlags <OutlookProviderFlags>]
   [-RequiredClientVersions <String[]>]
   [-Server <String>]
   [-TTL <Int32>]
   [-WhatIf]
   [<CommonParameters>]

Description

Set-OutlookProvider cmdlet은 자동 검색 서비스의 전역 설정을 만듭니다. Active Directory의 전역 설정 개체 아래에 AutoDiscoverConfig 개체를 설정하고 Parameters 섹션에 나열된 매개 변수에 지정된 특성을 설정합니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Set-OutlookProvider -Identity msExchAutoDiscoverConfig -TTL 2

다음은 Microsoft Outlook 공급자 msExchAutoDiscoverConfig에 대해 자동 검색 서비스 설정이 유효한 기간을 변경하는 예제입니다.

매개 변수

-CertPrincipalName

CertPrincipalName 매개 변수는 외부 위치에서 Exchange에 연결하는 데 필요한 SSL(Secure Sockets Layer) 인증서 주체 이름을 지정합니다.

이 매개 변수는 Outlook Anywhere 클라이언트에만 사용됩니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DomainController

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

형식:	Fqdn
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Identity

Identity 매개 변수는 전역 설정을 설정할 MAPI 프로토콜의 ADIDParameter 값을 지정합니다.

형식:	OutlookProviderIdParameter
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Name

Name 매개 변수는 Outlook Provider Configuration 개체의 일반 이름을 지정합니다. 식별을 위해 사용자에게 친숙한 이름일 수 있습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-OutlookProviderFlags

OutlookProviderFlags 매개 변수는 Exchange Server에 Outlook 클라이언트를 연결하는 방법을 지정합니다. 값을 ServerExclusiveConnect, ExternalClientsRequireSSL, InternalClientsRequireSSL 또는 None으로 설정하여 플래그를 지울 수 있습니다. 권장값은 기본 설정인 None입니다.

형식:	OutlookProviderFlags
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RequiredClientVersions

RequiredClientVersions 매개 변수는 Exchange 서버에 연결할 수 있는 최소 버전의 Microsoft Outlook을 지정합니다. 이 정보는 자동 검색 시 클라이언트 연결 요청에 응답합니다. 이 매개 변수는 "MinimumVersion, ExpirationDate" 구문을 사용합니다.

MinimumVersion은 xx.x.xxxx.xxxx 형식의 Outlook 버전입니다. 예를 들어 Outlook 2010 SP2(서비스 팩 2)를 지정하려면 값 14.0.7012.1000을 사용합니다.

ExpirationDate는 이전 버전의 Outlook에 의한 연결이 차단되는 UTC 날짜 시간입니다. UTC 날짜-시간은 ISO 8601 날짜-시간 형식으로 표시됩니다. yyyy-MM-ddThh:mm:ss.fffZ, 여기서 yyyy = year, MM = month, dd = day, T는 시간 구성 요소의 시작을 나타냅니다. hh = hour, mm = minute, ss = second, fff = 초의 분수 및 Z는 UTC를 나타내는 또 다른 방법인 Zulu를 나타냅니다.

이 매개 변수에 유효한 값의 예는 입니다 "14.0.7012.1000, 2020-01-01T12:00:00Z".

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Server

Server 매개 변수는 Outlook Anywhere 클라이언트에 사용할 사서함 서버를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-TTL

TTL 매개 변수는 지정된 설정이 유효한 기간(시간)을 지정합니다.

값을 지정하면 이 매개 변수로 지정된 기간 후에 자동 검색 서비스를 통해 설정이 다시 검색됩니다. 0 값을 지정하면 다시 검색할 필요가 없습니다. 기본값은 1시간입니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

Input types

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

출력

Output types

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.