Get-PublicFolder
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수 및 설정은 한 환경 또는 다른 환경에만 사용할 수 있습니다.
Get-PublicFolder cmdlet을 사용하여 공용 폴더 또는 공용 폴더 집합의 특성을 검색할 수 있습니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
GetChildren
Get-PublicFolder
[[-Identity] <PublicFolderIdParameter>]
[-GetChildren]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[-Server <ServerIdParameter>]
[<CommonParameters>]
Recurse
Get-PublicFolder
[[-Identity] <PublicFolderIdParameter>]
[-Recurse]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[-Server <ServerIdParameter>]
[<CommonParameters>]
LostAndFound
Get-PublicFolder
[-LostAndFound]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Identity
Get-PublicFolder
[[-Identity] <PublicFolderIdParameter>]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-Server <ServerIdParameter>]
[<CommonParameters>]
Description
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 문서에서는 cmdlet에 대한 모든 매개 변수를 나열하지만 할당된 권한에 포함되지 않은 경우 일부 매개 변수에 액세스할 수 없을 수 있습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Get-PublicFolder
이 예에서는 매개 변수 없이 Get-PublicFolder 명령을 사용하여 루트 공용 폴더 개체(IPM_SUBTREE)를 반환합니다.
예 2
Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name
이 예에서는 시스템 폴더 루트(\NON_IPM_SUBTREE)에서 시작하여 기본적으로 표시되지 않는 모든 시스템 폴더의 이름을 반환합니다.
예 3
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"
이 예에서는 \Legal\Documents\의 Pending Litigation 공용 폴더가 반환됩니다.
예 4
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse
이 예에서는 \Legal\Documents\의 Pending Litigation 공용 폴더 및 Pending Litigation 공용 폴더 아래에 있는 모든 공용 폴더가 반환됩니다. 결과 크기가 지정되지 않았으므로 최대 10,000개의 공용 폴더가 반환됩니다.
예 5
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited
이 예에서는 \Legal\Documents\의 Pending Litigation 공용 폴더 및 Pending Litigation 공용 폴더 아래에 있는 모든 공용 폴더가 개수에 제한 없이 반환됩니다.
예 6
Get-PublicFolder -Mailbox "Legal Department" -ResidentFolders
이 예에서는 공용 폴더 콘텐츠 사서함 Legal Department에 있는 공용 폴더가 반환됩니다.
매개 변수
-DomainController
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com
매개 변수 속성
| 형식: | Fqdn |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-GetChildren
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
GetChildren 스위치는 Identity 매개 변수로 지정된 폴더의 자식만 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
Recurse 또는 LostAndFound 스위치에서는 이 스위치를 사용할 수 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetChildren
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Identity 매개 변수는 보려는 공용 폴더의 이름과 경로를 지정합니다. 유효한 값은 구문을 \Level1\Level2\...\LevenN\PublicFolder사용합니다. 예: "\Customer Discussion" 또는 "\Engineering\Customer Discussion".
주의: identity 매개 변수의 값 $null 또는 존재하지 않는 값은 Identity 매개 변수 없이 Get- 명령을 실행한 것처럼 모든 개체를 반환합니다. Identity 매개 변수에 대한 값 목록이 정확하고 존재하지 않는 $null 값이 포함되어 있지 않은지 확인합니다.
매개 변수 속성
| 형식: | PublicFolderIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetChildren
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
Recurse
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
Identity
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-LostAndFound
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
LostAndFound 스위치는 \NON_IPM_SUBTREE\LOST_AND_FOUND 있는 분리된 폴더만 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
LOST_AND_FOUND 폴더에는 폴더가 보조 공용 폴더 사서함에 있지만 주 폴더에는 없는 경우 공용 폴더 계층 조정 프로세스에서 다시 만들어지는 누락된 폴더가 있습니다.
Identity 매개 변수 또는 Recurse 또는 LostAndFound 스위치에는 이 스위치를 사용할 수 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
LostAndFound
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Mailbox
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Mailbox 매개 변수는 계층 구조 공용 폴더 사서함의 ID를 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- 별칭
- DN(고유 이름)
- DN(고유 이름)
- Domain\Username
- 전자 메일 주소
- GUID
- LegacyExchangeDN
- SamAccountName
- 사용자 ID 또는 UPN(사용자 계정 이름)
매개 변수 속성
| 형식: | MailboxIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Organization
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
매개 변수 속성
| 형식: | OrganizationIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Recurse
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Recurse 스위치는 지정된 공용 폴더와 모든 자식을 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
GetChildren 또는 LostAndFound 스위치에서는 이 스위치를 사용할 수 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Recurse
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ResidentFolders
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
ResidentFolders 스위치는 특정 콘텐츠 공용 폴더 사서함에 있는 공용 폴더를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 스위치를 사용하지 않는 경우 명령은 기본 계층 공용 폴더 사서함에 콘텐츠가 있는 공용 폴더만 반환합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ResultSize
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 기본 최대값은 10,000입니다. 반환된 결과에 제한을 두지 않으려면 이 매개 변수를 Unlimited로 설정합니다. Recurse 또는 GetChildren 매개 변수와 함께 사용하는 경우에만 이 매개 변수를 전달할 수 있습니다.
매개 변수 속성
| 형식: | Unlimited |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetChildren
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
Recurse
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
LostAndFound
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Server
적용 가능: Exchange Server 2010
이 매개 변수는 Exchange Server 2010에서만 사용할 수 있습니다.
서버 매개 변수는 지정된 Exchange 서버로 결과를 필터링합니다. 서버를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예제:
- 이름
- FQDN
- DN(고유 이름)
- Exchange 레거시 DN
매개 변수 속성
| 형식: | ServerIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
GetChildren
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
Recurse
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
Identity
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.