Set-MailboxPlan

모듈:

ExchangePowerShell

적용 대상:

Exchange Online, Exchange Online Protection

이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.

Set-MailboxPlan cmdlet을 사용하여 클라우드 기반 서비스에서 사서함 계획의 설정을 수정할 수 있습니다.

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

Syntax

Set-MailboxPlan
   [-Identity] <MailboxPlanIdParameter>
   [-Confirm]
   [-Force]
   [-IsDefault]
   [-IssueWarningQuota <Unlimited>]
   [-MaxReceiveSize <Unlimited>]
   [-MaxSendSize <Unlimited>]
   [-ProhibitSendQuota <Unlimited>]
   [-ProhibitSendReceiveQuota <Unlimited>]
   [-RecipientLimits <Unlimited>]
   [-RetainDeletedItemsFor <EnhancedTimeSpan>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Description

사서함 계획은 사서함 속성을 자동으로 구성하는 템플릿입니다. 사서함 계획은 라이선스 유형에 해당하며 사용자에게 라이선스를 부여할 때 적용됩니다. 사서함 계획의 가용성은 서비스에 등록할 때 선택한 항목과 조직의 연령에 따라 결정됩니다.

사서함 계획의 설정을 수정해도 사서함 계획을 사용하여 만든 기존 사서함에는 영향을 주지 않습니다. 사서함 계획을 사용하여 기존 사서함의 설정을 수정하는 유일한 방법은 사용자에게 다른 라이선스를 할당하는 것이며, 이 라이선스는 사서함에 해당 사서함 계획을 적용합니다.

각 사서함 계획에는 이름과 표시 이름 값이 같은 해당 CAS(클라이언트 액세스 서비스) 사서함 계획이 있습니다. Set-CasMailboxPlan cmdlet을 사용하여 신규 또는 새로 사용하도록 설정된 사서함에 대한 POP3, IMAP4 또는 EAS(Exchange ActiveSync) 액세스를 사용하거나 사용하지 않도록 설정하고 사서함에 대한 웹용 Outlook(이전의 Outlook Web App) 사서함 정책을 지정할 수 있습니다.

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

예제

예 1

Set-MailboxPlan -Identity ExchangeOnlineEnterprise -ProhibitSendReceiveQuota 40GB -ProhibitSendQuota 39.5GB -IssueWarningQuota 39GB

이 예에서는 ExchangeOnlineEnterprise라는 사서함 계획에서 기본 사서함 할당량을 줄입니다.

매개 변수

-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 Online, Exchange Online Protection

-Force

강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

관리 입력에 대한 확인 메시지를 표시하는 것이 부적절한 경우 이 스위치를 사용하여 작업을 프로그래밍 방식으로 실행할 수 있습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Identity

Identity 매개 변수는 수정할 사서함 계획을 지정합니다. 사서함 계획을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

• 이름
• 별칭
• 표시 이름
• DN(고유 이름)
• GUID

Type:	MailboxPlanIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IsDefault

IsDefault 스위치는 사서함 계획을 기본 사서함 계획으로 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

새로 사용하도록 설정된 새 사서함과 새로 사용하도록 설정된 사서함은 기본 사서함 계획의 설정을 받습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-IssueWarningQuota

IssueWarningQuota 매개 변수는 사서함 계획을 사용하여 만들거나 사용하도록 설정된 사서함 크기에 대한 경고 임계값을 지정합니다. 이 매개 변수는 기본적으로 디버깅 목적으로 사용됩니다.

유효한 값은 최대 1.9999999999 테라바이트(2199023254528 바이트) 또는 무제한 값입니다. 사용할 수 있는 값은 최대 1.999999999테라바이트(2199023254528바이트)까지의 숫자 또는 unlimited 값입니다. 기본값은 20기가바이트(21474836480바이트)입니다.

• B(바이트)
• KB(킬로바이트)
• MB(메가바이트)
• GB(기가바이트)
• TB(테라바이트)

TB(테라바이트)

정규화되지 않은 값은 대개 바이트로 처리되지만 작은 값은 가장 가까운 킬로바이트로 반올림될 수 있습니다.

최대값은 사서함 계획에 의해 결정됩니다. 값을 낮출 수도 있고 높일 수도 있지만 사서함 계획에 해당하는 구독 또는 라이선스에 의해 지정된 최대값을 초과할 수는 없습니다.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-MaxReceiveSize

MaxReceiveSize 매개 변수는 사서함에 보낼 수 있는 메시지의 최대 크기를 지정합니다. 최대 크기보다 큰 메시지는 거부됩니다.

사용할 수 있는 값은 최대 1.999999999테라바이트(2199023254528바이트)까지의 숫자 또는 unlimited 값입니다. 기본값은 6기가바이트(6442450944바이트)입니다.

• B(바이트)
• KB(킬로바이트)
• MB(메가바이트)

TB(테라바이트)

유효한 값은 최대 150MB의 숫자입니다. 기본값은 36MB입니다.

최대값은 사서함 계획(구독 및 라이선스)에 따라 결정됩니다. 값을 낮출 수도 있고 높일 수도 있지만 사서함 계획에 해당하는 구독 또는 라이선스에 의해 지정된 최대값을 초과할 수는 없습니다.

이 매개 변수를 사용하여 만든 새 사서함의 MaxReceiveSize 값을 변경합니다. Set-Mailbox cmdlet의 MaxReceiveSize 매개 변수를 사용하여 기존 사서함의 값을 구성합니다.

Base64 인코딩을 사용하면 메시지 크기가 약 33% 증가하므로 적용하려는 실제 최대 메시지 크기보다 33% 더 큰 값을 지정합니다. 예를 들어 값이 64MB이면 최대 메시지 크기는 약 48MB입니다.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-MaxSendSize

MaxSendSize 매개 변수는 사서함이 보낼 수 있는 메시지의 최대 크기를 지정합니다.

사용할 수 있는 값은 최대 1.999999999테라바이트(2199023254528바이트)까지의 숫자 또는 unlimited 값입니다. 기본값은 6기가바이트(6442450944바이트)입니다.

• B(바이트)
• KB(킬로바이트)
• MB(메가바이트)

TB(테라바이트)

유효한 값은 최대 150MB의 숫자입니다. 기본값은 35MB입니다.

최대값은 사서함 계획(구독 및 라이선스)에 따라 결정됩니다. 값을 낮출 수도 있고 높일 수도 있지만 사서함 계획에 해당하는 구독 또는 라이선스에 의해 지정된 최대값을 초과할 수는 없습니다.

이 매개 변수를 사용하여 만든 새 사서함의 MaxSendSize 값을 변경합니다. Set-Mailbox cmdlet의 MaxSendSize 매개 변수를 사용하여 기존 사서함의 값을 구성합니다.

Base64 인코딩을 사용하면 메시지 크기가 약 33% 증가하므로 적용하려는 실제 최대 메시지 크기보다 33% 더 큰 값을 지정합니다. 예를 들어 값이 64MB이면 최대 메시지 크기는 약 48MB입니다.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ProhibitSendQuota

규칙의 우선 순위 값을 수정하면 목록의 규칙 위치가 지정한 우선 순위 값과 일치하도록 변경됩니다. 즉, 규칙의 우선 순위 값을 기존 규칙과 같은 값으로 설정하면 기존 규칙과 우선 순위가 더 낮은 다른 모든 규칙의 우선 순위 값이 1씩 커집니다.

유효한 값은 최대 1.9999999999 테라바이트(2199023254528 바이트) 또는 무제한 값입니다. 사용할 수 있는 값은 최대 1.999999999테라바이트(2199023254528바이트)까지의 숫자 또는 unlimited 값입니다. 기본값은 20기가바이트(21474836480바이트)입니다.

• B(바이트)
• KB(킬로바이트)
• MB(메가바이트)
• GB(기가바이트)
• TB(테라바이트)

TB(테라바이트)

정규화되지 않은 값은 대개 바이트로 처리되지만 작은 값은 가장 가까운 킬로바이트로 반올림될 수 있습니다.

최대값은 사서함 계획에 의해 결정됩니다. 값을 낮출 수도 있고 높일 수도 있지만 사서함 계획에 해당하는 구독 또는 라이선스에 의해 지정된 최대값을 초과할 수는 없습니다.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ProhibitSendReceiveQuota

ProhibitSendReceiveQuota 매개 변수는 사서함의 크기 제한을 지정합니다. 사서함이 이 크기에 도달하거나 초과하는 경우 사서함은 새 메시지를 보내거나 받을 수 없습니다. 사서함으로 전송된 메시지는 설명 오류 메시지와 함께 보낸 사람에게 반환됩니다. 이 값은 사서함의 최대 크기를 효과적으로 결정합니다.

유효한 값은 최대 1.9999999999 테라바이트(2199023254528 바이트) 또는 무제한 값입니다. 사용할 수 있는 값은 최대 1.999999999테라바이트(2199023254528바이트)까지의 숫자 또는 unlimited 값입니다. 기본값은 20기가바이트(21474836480바이트)입니다.

• B(바이트)
• KB(킬로바이트)
• MB(메가바이트)
• GB(기가바이트)
• TB(테라바이트)

TB(테라바이트)

값은 ProhibitSendQuota 또는 IssueWarningQuota 값보다 크거나 같아야 합니다.

최대값은 사서함 계획에 의해 결정됩니다. 값을 낮출 수는 있지만 사서함 계획에 해당하는 구독 또는 라이선스에 의해 지정된 최대값을 초과할 수는 없습니다.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RecipientLimits

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RetainDeletedItemsFor

RetainDeletedItemsFor 매개 변수는 사서함에 대해 일시 삭제된 항목을 유지하는 데 걸리는 시간을 지정합니다. 일시 삭제된 항목은 다음 메서드를 사용하여 삭제된 항목입니다.

• RetainDeletedItemsFor 매개 변수는 사서함의 일시 삭제된 항목의 보존 기간을 지정합니다. 일시 삭제된 항목은 다음이 방법 중 하나를 사용하여 삭제된 항목입니다.
• 지운 편지함 폴더에서 항목 삭제
• 지운 편지함 폴더 비우기 작업 선택

Shift+Delete를 사용하여 항목 삭제

삭제된 항목 보존 기간이 만료되기 전에 사용자는 Outlook에서 일시 삭제된 항목을 복구하고 삭제된 항목 복구 기능을 사용하여 웹용 Outlook 수 있습니다. 자세한 내용은 Exchange Online 복구 가능한 항목 폴더를 참조하세요.

값을 지정하려면 시간 범위로 입력합니다. dd.hh:mm:ss 여기서 dd = 일, hh = 시, mm = 분 및 ss = 초입니다.

기본값은 14일(14.00:00:00)입니다. Exchange Online 값을 최대 30일로 늘릴 수 있습니다.

Type:	EnhancedTimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RetentionPolicy

RetentionPolicy 매개 변수는 사용자가 만든 새 사서함에 적용되는 보존 정책을 지정합니다. 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

• 이름
• DN(고유 이름)
• GUID

보존 정책은 항목을 보존할 기간을 결정하기 위해 사서함 폴더와 메일 항목에 적용되는 태그로 구성됩니다. 사용 가능한 보존 정책을 확인하려면 Get-RetentionPolicy cmdlet을 사용합니다.

기본적으로 이 매개 변수의 값은 비어 있습니다($null). 즉, 기본 보존 정책(IsDefault 속성 값이 True인 보존 정책)이 새 사서함에 할당됩니다. 기본적으로 기본 보존 정책의 이름은 기본 MRM 정책입니다.

이 매개 변수에 대한 값을 설정하지 않으면 New-RetentionPolicy 또는 Set-RetentionPolicy cmdlet에서 IsDefault 스위치를 사용하여 기본값인 보존 정책을 변경하는 경우 기존 사서함도 업데이트됩니다.

참고: 이 매개 변수의 값을 지정하면 다음과 같은 잠재적인 문제가 있습니다.

• 이 매개 변수의 값이 비어 있지 않은 경우($null) 지정된 보존 정책은 조직에 대해 구성된 기본 Exchange 보존 정책이어야 합니다. 그렇지 않으면 새 사서함을 만들고, 비활성화된 사서함을 사용하도록 설정하고, 라이선스를 변경할 때 환경이 일관되지 않을 수 있습니다.
• 사서함에 기본 정책이 아닌 Exchange 보존 정책이 할당된 경우 라이선스를 변경할 때 사서함의 RetentionPolicy 값을 덮어쓰고 수동으로 원래 값으로 다시 설정해야 합니다.
• 업데이트가 필요한 수백 또는 수천 개의 사서함이 있는 경우 기존 사서함에 영향을 주는 기본 보존 정책을 변경하면 네트워크가 포화될 수 있습니다.

자세한 내용은 Exchange Online 사서함 계획을 참조하세요.

Type:	MailboxPolicyIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RoleAssignmentPolicy

RoleAssignmentPolicy 매개 변수는 사서함에 적용되는 역할 할당 정책을 지정합니다. 역할 할당 정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

• 이름
• DN(고유 이름)
• GUID

기본값은 기본 역할 할당 정책입니다.

사용 가능한 역할 할당 정책을 보려면 Get-RoleAssignmentPolicy cmdlet을 사용합니다.

Type:	MailboxPolicyIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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 Online, Exchange Online Protection

입력

Input types

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

출력

Output types

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