Set-MailboxAutoReplyConfiguration

참조

모듈:: ExchangePowerShell

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

cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.

Set-MailboxAutoReplyConfiguration cmdlet을 사용하면 특정 사서함의 자동 회신 설정을 구성할 수 있습니다.

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

Syntax

Set-MailboxAutoReplyConfiguration
   [-Identity] <MailboxIdParameter>
   [-AutoDeclineFutureRequestsWhenOOF <Boolean>]
   [-AutoReplyState <OofState>]
   [-Confirm]
   [-CreateOOFEvent <Boolean>]
   [-DeclineAllEventsForScheduledOOF <Boolean>]
   [-DeclineEventsForScheduledOOF <Boolean>]
   [-DeclineMeetingMessage <String>]
   [-DomainController <Fqdn>]
   [-EndTime <DateTime>]
   [-EventsToDeleteIDs <String[]>]
   [-ExternalAudience <ExternalAudience>]
   [-ExternalMessage <String>]
   [-IgnoreDefaultScope]
   [-InternalMessage <String>]
   [-OOFEventSubject <String>]
   [-StartTime <DateTime>]
   [-WhatIf]
   [<CommonParameters>]

Description

특정 사서함이나 조직에 대해 자동 회신을 사용하지 않도록 설정할 수 있습니다.

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

예제

예 1

Set-MailboxAutoReplyConfiguration -Identity tony@contoso.com -AutoReplyState Scheduled -StartTime "7/10/2018 08:00:00" -EndTime "7/15/2018 17:00:00" -InternalMessage "Internal auto-reply message"

다음은 지정된 시작 날짜와 종료 날짜 사이에 보낼 Tony 사서함에 대한 자동 회신을 구성하고 내부 회신을 포함하는 예제입니다.

예 2

Set-MailboxAutoReplyConfiguration -Identity tony@contoso.com -AutoReplyState Enabled -InternalMessage "Internal auto-reply message." -ExternalMessage "External auto-reply message." -ExternalAudience All

다음은 Tony 사서함의 자동 회신을 전송하도록 구성하고, 내부 및 외부 보낸 사람의 메시지에 대한 회신을 지정하고, 외부 회신이 외부 주소로 전송되도록 지정하는 예제입니다.

매개 변수

-AutoDeclineFutureRequestsWhenOOF

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

AutoDeclineFutureRequestsWhenOOF 매개 변수는 자동 회신이 전송되는 예약된 기간 동안 사서함에 전송되는 새 모임 요청을 자동으로 거부할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 예약된 기간 동안 수신된 새 모임 요청은 자동으로 거부됩니다.
$false: 예약된 기간 동안 수신된 모임 요청은 자동으로 거부되지 않습니다. 이 값은 기본값입니다.

AutoReplyState 매개 변수가 Scheduled로 설정된 경우에만 이 매개 변수를 사용할 수 있습니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-AutoReplyState

AutoReplyState 매개 변수는 사서함에서 자동 회신을 사용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

사용: 사서함에 대해 자동 회신이 전송됩니다.
사용 안 함: 사서함에 대해 자동 회신이 전송되지 않습니다. 이 값은 기본값입니다.
예약됨: StartTime 및 EndTime 매개 변수에 지정된 기간 동안 사서함에 대해 자동 회신이 전송됩니다.

Enabled 및 Scheduled 값에는 다음의 추가 설정이 필요합니다.

InternalMessageValue 매개 변수의 값입니다.
ExternalAudience 매개 변수가 Known 또는 All로 설정된 경우 ExternalMessageValue 매개 변수의 값입니다.

Type:	OofState
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Confirm

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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CreateOOFEvent

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

CreateOOFEvent 매개 변수는 사서함에 대해 자동 회신을 보낼 때 예약된 기간에 해당하는 일정 이벤트를 만들지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: AutoReplyState 매개 변수에 대해 Scheduled 값을 사용하여 자동 회신에 대해 예약된 기간을 구성하면 해당 날짜에 대한 일정 이벤트가 사서함에 만들어집니다. OOFEventSubject 매개 변수를 사용하여 이벤트에 대한 제목을 지정할 수 있습니다.
$false: AutoReplyState 매개 변수에 대해 Scheduled 값을 사용하여 자동 회신에 대해 예약된 기간을 구성할 때 해당 날짜에 대한 일정 이벤트가 만들어지지 않습니다. 이 값은 기본값입니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-DeclineAllEventsForScheduledOOF

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

DeclineAllEventsForScheduledOOF 매개 변수는 자동 회신이 전송되는 예약된 기간 동안 사서함의 모든 기존 일정 이벤트를 거부할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 예약된 기간 동안 발생하는 사서함의 기존 일정 이벤트는 일정에서 거부되고 제거됩니다. 사서함이 모임 이끌이인 경우 다른 모든 참석자에 대해 이벤트가 취소됩니다.
$false: 예약된 기간 동안 발생하는 사서함의 기존 일정 이벤트는 일정에 남아 있습니다. 이 값은 기본값입니다.

DeclineEventsForScheduledOOF 매개 변수가 $true 설정된 경우에만 이 매개 변수를 사용할 수 있습니다.

EventsToDeleteIDs 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-DeclineEventsForScheduledOOF

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

DeclineEventsForScheduledOOF 매개 변수는 자동 회신이 전송되는 예약된 기간 동안 사서함의 기존 일정 이벤트를 거부할 수 있는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 예약된 기간 동안 발생하는 사서함의 기존 일정 이벤트를 거부하여 일정에서 제거할 수 있습니다. 사서함이 모임 이끌이인 경우 다른 모든 참석자에 대해 이벤트가 취소됩니다.

예약된 기간 동안 특정 이벤트를 거부하려면 EventsToDeleteIDs 매개 변수를 사용합니다. 예약된 기간 동안 모든 이벤트를 거부하려면 DeclineAllEventsForScheduledOOF 매개 변수를 사용합니다.
$false: 예약된 기간 동안 발생하는 사서함의 기존 일정 이벤트는 일정에 남아 있습니다. 이 값은 기본값입니다.

AutoReplyState 매개 변수가 Scheduled로 설정된 경우에만 이 매개 변수를 사용할 수 있습니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-DeclineMeetingMessage

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

DeclineMeetingMessage 매개 변수는 사서함으로 전송되는 모임 요청이 자동으로 거부될 때 메시지의 텍스트를 지정합니다. 예를 들면

AutoDeclineFutureRequestsWhenOOF 매개 변수는 $true 설정됩니다.
DeclineEventsForScheduledOOF 매개 변수는 $true 설정되고 DeclineAllEventsForScheduledOOF 매개 변수는 $true 설정되거나 EventsToDeleteIDs 매개 변수를 사용하여 개별 이벤트를 지정합니다.

값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다. HTML 태그는 텍스트에 자동으로 추가되지 않지만 HTML 태그가 포함된 값을 사용할 수 있습니다. 예를 들면 "<html><body>I'm on vacation. I can't attend the meeting.</body></html>"와 같습니다.

이 매개 변수의 값을 지우려면 값 $null 사용합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

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

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-EndTime

EndTime 매개 변수는 사서함에 대해 자동 회신을 보내는 종료 날짜와 시간을 지정합니다. AutoReplyState 매개 변수가 Scheduled로 설정되는 경우에만 이 매개 변수를 사용해야 하며 이 매개 변수의 값은 AutoReplyState가 Scheduled인 경우에만 의미가 있습니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-EventsToDeleteIDs

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

EventsToDeleteIDs 매개 변수는 DeclineEventsForScheduledOOF 매개 변수가 $true 설정된 경우 사서함에서 삭제할 일정 이벤트를 지정합니다.

여러 일정 이벤트를 쉼표로 구분하여 지정할 수 있습니다.

DeclineAllEventsForScheduledOOF 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-ExternalAudience

ExternalAudience 매개 변수는 외부 보낸 사람에게 자동 회신을 보낼지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

없음: 자동 회신은 외부 보낸 사람에게 전송되지 않습니다.
알려진: 자동 회신은 사서함의 연락처 목록에 지정된 외부 보낸 사람에게만 전송됩니다.
모두: 자동 회신은 모든 외부 보낸 사람에게 전송됩니다. 이 값은 기본값입니다.

이 매개 변수의 값은 AutoReplyState 매개 변수가 Enabled 또는 Scheduled로 설정된 경우에만 의미가 있습니다.

Type:	ExternalAudience
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ExternalMessage

ExternalMessage 매개 변수는 외부 보낸 사람 또는 조직 외부의 보낸 사람에게 보내는 자동 회신 메시지를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

HTML 태그가 텍스트에 자동으로 추가됩니다. 예를 들어 "휴가 중입니다"라는 텍스트를 입력하면 값이 자동으로 가 됩니다 <html><body>I'm on vacation</body></html>. 추가 HTML 태그는 값을 큰따옴표로 묶으면 지원됩니다. 예를 들면 "<html><body>I'm on vacation. I'll respond when I return.</body></html>"와 같습니다.

이 매개 변수의 값은 다음 두 조건이 모두 충족될 때만 의미가 있습니다.

AutoReplyState 매개 변수가 Enabled 또는 Scheduled로 설정된 경우
ExternalAudience 매개 변수가 Known 또는 All로 설정된 경우

더 이상 필요 없을 때 이 매개 변수의 값을 지우려면(예를 들어 ExternalAudience 매개 변수를 None으로 변경하는 경우) 값 $null을 사용합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Identity 매개 변수는 수정할 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

이름
별칭
DN(고유 이름)
DN(고유 이름)
Domain\Username
전자 메일 주소
GUID
LegacyExchangeDN
SamAccountName
사용자 ID 또는 UPN(사용자 계정 이름)

Type:	MailboxIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

IgnoreDefaultScope 스위치는 명령에 Exchange PowerShell 세션에 대한 기본 수신자 scope 설정을 무시하고 전체 포리스트를 scope 사용하도록 지시합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하면 명령이 기본 scope 현재 사용할 수 없는 Active Directory 개체에 액세스할 수 있지만 다음과 같은 제한 사항도 도입됩니다.

DomainController 매개 변수는 사용할 수 없습니다. 명령은 자동으로 적절한 글로벌 카탈로그 서버를 사용합니다.
DomainController 매개 변수는 사용할 수 없습니다. 명령은 자동으로 적절한 글로벌 카탈로그 서버를 사용합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-InternalMessage

InternalMessage 매개 변수는 내부 보낸 사람 또는 조직 내의 보낸 사람에게 보내는 자동 회신 메시지를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

HTML 태그가 텍스트에 자동으로 추가됩니다. 예를 들어 "휴가 중입니다"라는 텍스트를 입력하면 값이 자동으로 가 됩니다 <html><body>I'm on vacation</body></html>. 추가 HTML 태그는 값을 큰따옴표로 묶으면 지원됩니다. 예를 들면 "<html><body>I'm on vacation. Please contact my manager.</body></html>"와 같습니다.

이 매개 변수의 값은 AutoReplyState 매개 변수가 Enabled 또는 Scheduled로 설정된 경우에만 의미가 있습니다.

더 이상 필요 없을 때 이 매개 변수의 값을 지우려면(예를 들어 AutoReplyState 매개 변수를 Disabled으로 변경하는 경우) 값 $null을 사용합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-OOFEventSubject

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

OOFEventSubject 매개 변수는 CreateOOFEvent 매개 변수가 $true 설정될 때 자동으로 생성되는 일정 이벤트의 제목을 지정합니다.

값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다. 이 매개 변수의 값을 지우려면 값 $null 사용합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

-StartTime

StartTime 매개 변수는 지정된 사서함에 대해 자동 회신을 보내는 시작 날짜와 시간을 지정합니다. AutoReplyState 매개 변수가 Scheduled로 설정되는 경우에만 이 매개 변수를 사용해야 하며 이 매개 변수의 값은 AutoReplyState가 Scheduled인 경우에만 의미가 있습니다.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

입력

Input types

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

출력

Output types

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

Set-MailboxAutoReplyConfiguration

Syntax

Description

예제

예 1

예 2

매개 변수

-AutoDeclineFutureRequestsWhenOOF

-AutoReplyState

-Confirm

-CreateOOFEvent

-DeclineAllEventsForScheduledOOF

-DeclineEventsForScheduledOOF

-DeclineMeetingMessage

-DomainController

-EndTime

-EventsToDeleteIDs

-ExternalAudience

-ExternalMessage

-Identity

-IgnoreDefaultScope

-InternalMessage

-OOFEventSubject

-StartTime

-WhatIf

입력

출력

피드백

피드백

추가 리소스