Get-EXOMailboxFolderPermission
이 cmdlet은 Exchange Online PowerShell 모듈에서만 사용할 수 있습니다. 자세한 내용은 Exchange Online PowerShell 모듈 정보를 참조하세요.
Get-ExOMailboxFolderPermission cmdlet을 사용하여 사서함의 폴더 수준 권한을 볼 수 있습니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Get-EXOMailboxFolderPermission
[[-Identity] <String>]
[-ExternalDirectoryObjectId <Guid>]
[-GroupMailbox]
[-PrimarySmtpAddress <String>]
[-User <String>]
[-UserPrincipalName <String>]
[<CommonParameters>]
Description
이 cmdlet을 사용하여 사서함에서 폴더 수준 권한을 검색합니다.
예제
예 1
Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports
이 예제에서는 John의 사서함에 포함된 Marketing 폴더의 Reports 하위 폴더에 대한 현재의 사용자 권한 목록을 반환합니다.
예 2
Get-EXOMailboxFolderPermission -Identity john@contoso.com:\Marketing\Reports -User Kim@contoso.com
이 예제에서는 John의 사서함에 있는 동일한 폴더에 대한 사용 권한을 반환하지만 사용자 Kim에 대해서만 반환합니다.
매개 변수
-ExternalDirectoryObjectId
적용 가능: Exchange Online
ExternalDirectoryObjectId 매개 변수는 Microsoft Entra ID ObjectId에서 보려는 사서함을 식별합니다.
Identity, PrimarySmtpAddress 또는 UserPrincipalName 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
매개 변수 속성
| 형식: | Guid |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-GroupMailbox
적용 가능: Exchange Online
결과에서 Microsoft 365 그룹 반환하려면 GroupMailbox 스위치가 필요합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Online
Identity 매개 변수는 보려는 사서함 폴더를 지정합니다. 이 매개 변수는 <Mailbox>:\<Folder> 구문을 사용합니다. 최상의 성능을 위해 사용자 ID 또는 UPN(사용자 계정 이름)을 사용하여 사서함을 식별하는 것이 좋습니다.
그렇지 않으면 사서함을 고유하게 식별하는 값을 사용할 수 있습니다. 예시:
- 이름
- 별칭
- DN(고유 이름)
- DN(고유 이름)
- LegacyExchangeDN
- SamAccountName
ExternalDirectoryObjectId, PrimarySmtpAddress 또는 UserPrincipalName 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
주의: identity 매개 변수의 값 $null 또는 존재하지 않는 값은 Identity 매개 변수 없이 Get- 명령을 실행한 것처럼 모든 개체를 반환합니다. Identity 매개 변수에 대한 값 목록이 정확하고 존재하지 않는 $null 값이 포함되어 있지 않은지 확인합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-PrimarySmtpAddress
적용 가능: Exchange Online
PrimarySmtpAddress는 기본 SMTP 전자 메일 주소(예 navin@contoso.com: )로 보려는 사서함을 식별합니다.
ExternalDirectoryObjectId, Identity 또는 UserPrincipalName 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-User
적용 가능: Exchange Online
User 매개 변수는 사서함 폴더에 대한 권한이 부여된 지정된 사서함, 메일 사용자 또는 메일 사용 보안 그룹(보안 주체)을 기준으로 결과를 필터링합니다. 사용자나 그룹을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:
- 이름
- 별칭
- DN(고유 이름)
- DN(고유 이름)
- 정식 DN
- GUID
참고: 사서함 폴더에 액세스할 수 있는 권한이 없는 사용자를 지정하면 명령에서 오류를 반환합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-UserPrincipalName
적용 가능: Exchange Online
UserPrincipalName 매개 변수는 UPN(예 navin@contoso.onmicrosoft.com: )으로 보려는 사서함을 식별합니다.
ExternalDirectoryObjectId, Identity 또는 PrimarySmtpAddress 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.