Set-MailboxFolderPermission
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.
Set-MailboxFolderPermission cmdlet을 사용하여 사서함의 사용자에 대해 폴더 수준 권한을 수정할 수 있습니다. 이 cmdlet은 기존 사용 권한 항목을 수정한다는 점에서 Add-MailboxFolderPermission cmdlet과 다릅니다. 일정 정보가 외부 사용자에게 표시되도록 사서함에 대한 일정 게시 또는 공유 설정을 구성하려면 Set-MailboxCalendarFolder cmdlet을 사용합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Set-MailboxFolderPermission
[-Identity] <MailboxFolderIdParameter>
-AccessRights <MailboxFolderAccessRight[]>
-User <MailboxFolderUserIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-SendNotificationToUser <Boolean>]
[-SharingPermissionFlags <MailboxFolderPermissionFlags>]
[-WhatIf]
[<CommonParameters>] Description
Exchange Online PowerShell에서 SendNotificationToUser 또는 SharingPermissionFlags 매개 변수를 사용하지 않는 경우 cmdlet의 기능은 변경되지 않습니다. 예를 들어 사용자가 기존 대리자이고 SendNotificationToUser 또는 SharingPermissionFlags 매개 변수를 사용하지 않고 해당 권한을 편집기로 변경하는 경우 사용자는 대리자로 유지됩니다. 그러나 SendNotificationToUser 매개 변수($true 또는 $false)를 사용하는 경우 SharingPermissionFlags 매개 변수에는 기존 사용자의 대리자 액세스에 영향을 줄 수 있는 기본값인 None이 있습니다. 예를 들어 기존 대리자의 권한을 편집기로 변경하고 값이 $true SendNotificationToUser를 사용합니다. 사용자는 더 이상 대리자가 되지 않으며 폴더에 대한 편집기 권한만 갖습니다.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Set-MailboxFolderPermission -Identity ayla@contoso.com:\Marketing -User ed@contoso.com -AccessRights Owner이 예제에서는 Ayla의 사서함에 있는 마케팅 폴더에 대한 Ed의 기존 권한을 덮어씁니다. 이제 Ed에 폴더의 소유자 역할이 부여됩니다.
예 2
Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate -SendNotificationToUser $trueExchange Online 이 예제에서는 유효 권한을 변경하지 않고 기존 대리자에게 공유 초대를 다시 보냅니다(Ed는 이미 Ayla의 사서함에 대한 편집기 권한이 있는 대리자임).
예 3
Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags DelegateExchange Online 이 예제에서는 기존 대리자를 위한 프라이빗 항목에 대한 액세스를 제거합니다.
예 4
Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags NoneExchange Online 이 예제에서는 기존 일정 대리자를 편집기로 변경합니다.
예 5
Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights EditorExchange Online 이 예제에서는 현재 대리자 상태 변경하지 않고 기존 사용자의 권한을 편집기로 변경합니다.
예 6
Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SendNotificationToUser $falseExchange Online 이 예제에서는 기존 사용자의 권한을 편집기로 변경하고 현재 대리자 상태 제거합니다.
매개 변수
-AccessRights
AccessRights 매개 변수는 사서함 폴더의 사용자에 대해 수정할 권한을 지정합니다. 지정한 값은 폴더의 사용자에 대한 기존 사용 권한을 바꿉니다.
개별 폴더 권한 또는 권한 조합에 해당하는 역할을 지정할 수 있습니다. 여러 개의 권한 및 역할을 쉼표로 구분하여 지정할 수 있습니다.
다음 개별 권한을 사용할 수 있습니다.
- 없음: 사용자는 폴더 또는 해당 내용을 보거나 상호 작용할 수 있는 액세스 권한이 없습니다.
- CreateItems: 사용자가 지정된 폴더에 항목을 만들 수 있습니다.
- CreateSubfolders: 사용자가 지정된 폴더에 하위 폴더를 만들 수 있습니다.
- DeleteAllItems: 사용자가 지정된 폴더의 모든 항목을 삭제할 수 있습니다.
- DeleteOwnedItems: 사용자는 지정된 폴더에서 만든 항목만 삭제할 수 있습니다.
- EditAllItems: 사용자가 지정된 폴더의 모든 항목을 편집할 수 있습니다.
- EditOwnedItems: 사용자는 지정된 폴더에서 만든 항목만 편집할 수 있습니다.
- FolderContact: 사용자가 지정된 공용 폴더의 연락처입니다.
- FolderOwner: 사용자가 지정된 폴더의 소유자입니다. 사용자는 폴더를 보고, 폴더를 이동하고, 하위 폴더를 만들 수 있습니다. 사용자가 항목에 대한 읽기, 편집, 삭제 또는 만들기를 수행할 수 없습니다.
- FolderVisible: 사용자는 지정된 폴더를 볼 수 있지만 지정된 공용 폴더 내에서 항목을 읽거나 편집할 수는 없습니다.
- ReadItems: 사용자가 지정된 폴더 내의 항목을 읽을 수 있습니다.
할당한 권한 및 사용 가능한 역할은 다음 목록에 설명되어 있습니다.
- 작성자: CreateItems, DeleteOwnedItems, EditOwnedItems, FolderVisible, ReadItems
- 기여자: CreateItems, FolderVisible
- 편집기: CreateItems, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
- NonEditingAuthor: CreateItems, DeleteOwnedItems, FolderVisible, ReadItems
- 소유자: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderContact, FolderOwner, FolderVisible, ReadItems
- PublishingAuthor: CreateItems, CreateSubfolders, DeleteOwnedItems, EditOwnedItems, FolderVisible, ReadItems
- PublishingEditor: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
- 검토자: FolderVisible, ReadItems
다음 역할은 일정 폴더에 적용됩니다.
- AvailabilityOnly: 가용성 데이터만 보기
- LimitedDetails: 주체 및 위치를 사용하여 가용성 데이터 보기
편집기 역할이 일정 폴더에 적용되면 대리인은 사서함에서 모임 요청을 수동으로 선택하여 모임을 수락하거나 거부할 수 있습니다. Exchange Online 모임을 수락하거나 거부할 수 있는 대리인에게 모임 요청을 보내려면 SharingPermissionFlags 매개 변수를 대리자 값과 함께 사용합니다.
| Type: | MailboxFolderAccessRight[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-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 |
-Identity
Identity 매개 변수는 대상 사서함 및 폴더를 지정합니다. 구문은 입니다 MailboxID:\ParentFolder[\SubFolder].
값의 MailboxID경우 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- 별칭
- DN(고유 이름)
- DN(고유 이름)
- Domain\Username
- 전자 메일 주소
- GUID
- LegacyExchangeDN
- SamAccountName
- 사용자 ID 또는 UPN(사용자 계정 이름)
이 매개 변수의 예제 값은 또는 John:\Inbox\Reports입니다john@contoso.com:\Calendar.
| Type: | MailboxFolderIdParameter |
| 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 |
-SendNotificationToUser
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
SendNotificationToUser 매개 변수는 일정 권한을 수정할 때 사용자에게 공유 초대를 보낼지 여부를 지정합니다. 메시지는 받는 사람이 수락할 수 있는 일반 일정 공유 초대입니다. 유효한 값은 다음과 같습니다.
- $true: 공유 초대가 전송됩니다.
- $false: 공유 초대가 전송되지 않습니다. 이 값은 기본값입니다.
이 매개 변수는 일정 폴더에만 적용되며 다음 AccessRights 매개 변수 값에만 사용할 수 있습니다.
- AvailabilityOnly
- LimitedDetails
- Reviewer
- 편집자
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SharingPermissionFlags
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
SharingPermissionFlags 매개 변수는 일정 대리자 권한을 할당합니다. 이 매개 변수는 일정 폴더에만 적용되며 AccessRights 매개 변수 값이 편집기인 경우에만 사용할 수 있습니다. 유효한 값은 다음과 같습니다.
- 없음: 대리인 권한을 제거하고 사용자가 사서함에 대한 모임 초대 및 응답 수신을 중지할 수 있도록 모임 메시지 규칙을 업데이트합니다. SharingPermissionFlags 매개 변수에 대한 값을 지정하지 않고 SendNotificationToUser 매개 변수를 사용할 때 기본값입니다.
- 대리인: 사용자는 모임 초대 및 응답 수신을 포함하는 일정 대리자가 됩니다. 다른 대리인이 없는 경우 이 값은 모임 메시지 규칙을 만듭니다. 기존 대리자가 있는 경우 대리자 메시지를 보내는 방법을 변경하지 않고 사용자가 모임 메시지 규칙에 추가됩니다.
- CanViewPrivateItems: 사용자가 일정의 개인 항목에 액세스할 수 있습니다. 대리자 값과 함께 이 값을 사용해야 합니다.
쉼표로 구분하여 여러 값을 지정할 수 있습니다.
| Type: | MailboxFolderPermissionFlags |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-User
User 매개 변수는 사서함 폴더에 대한 권한이 부여된 사서함, 메일 사용자 또는 메일 사용이 가능한 보안 그룹(보안 주체)을 지정합니다. 사용자나 그룹을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- 별칭
- DN(고유 이름)
- DN(고유 이름)
- 정식 DN
- GUID
| Type: | MailboxFolderUserIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.
관련 링크
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기