Get-PublicFolder(RTM)
적용 대상: Exchange Server 2007
마지막으로 수정된 항목: 2007-06-06
Get-PublicFolder cmdlet를 사용하여 공용 폴더 또는 공용 폴더 집합의 특성을 검색할 수 있습니다.
구문
Get-PublicFolder [-Identity <PublicFolderIdParameter>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
자세한 정보
Get-PublicFolder cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.
- Exchange 보기 권한만 있는 관리자 역할
사용 권한, 역할 위임 및 Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
매개 변수
| 매개 변수 | 필수 | 종류 | 설명 |
|---|---|---|---|
GetChildren |
필수 |
System.Management.Automation.SwitchParameter |
Identity 매개 변수에서 지정한 폴더의 자식만 검색하려면 GetChildren 매개 변수를 사용합니다. GetChildren 매개 변수를 Recurse 매개 변수와 함께 사용할 수 없습니다. |
Recurse |
필수 |
System.Management.Automation.SwitchParameter |
Recurse 매개 변수는 명령이 지정된 공용 폴더와 모든 자식을 반환해야 함을 지정합니다. |
DomainController |
선택 |
Microsoft.Exchange.Data.Fqdn |
Active Directory 디렉터리 서비스에서 데이터를 검색하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 명령에 DomainController 매개 변수를 포함시킵니다. |
Identity |
선택 |
Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter |
특정 공용 폴더를 나타내는 GUID 또는 공용 폴더 이름을 지정하려면 Identity 매개 변수를 사용합니다. TopLevelPublicFolder\PublicFolder 형식을 사용하여 경로도 포함할 수 있습니다. 매개 변수 레이블 Identity를 생략하고 공용 폴더 이름 또는 GUID만 지정할 수도 있습니다. |
ResultSize |
선택 |
Microsoft.Exchange.Data.Unlimited |
ResultSize 매개 변수는 반환할 결과의 최대 수를 지정합니다. 기본 최대값은 10,000입니다. 반환된 결과에 제한을 두지 않으려면 이 매개 변수를 Unlimited로 설정합니다. Recurse 또는 GetChildren 매개 변수와 함께 사용하는 경우에만 이 매개 변수를 전달할 수 있습니다. |
Server |
선택 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Server 매개 변수는 선택한 작업을 수행하기 위한 서버를 지정합니다. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
|
예외
| 예외 | 설명 |
|---|---|
|
예제
다음은 Get-PublicFolder 명령을 사용하는 방법을 보여주는 코드 예입니다.
첫 번째 예는 매개 변수 없이 Get-PublicFolder 명령을 사용하여 루트 공용 폴더 개체(IPM_SUBTREE)를 반환합니다.
두 번째 예는 시스템 폴더 루트(\NON_IPM_SUBTREE)에서 시작하여 기본적으로 표시되지 않는 모든 시스템 폴더의 이름을 반환합니다.
세 번째 예는 지정된 장기 항목 식별자와 함께 공용 폴더를 반환합니다.
네 번째 예는 \Legal\Documents\에서 Pending Litigation 공용 폴더를 반환합니다.
다섯 번째 예는 \Legal\Documents\에서 Pending Litigation 공용 폴더 및 Pending Litigation 공용 폴더 아래에서 최대 9,999개의 공용 폴더를 반환합니다.
여섯 번째 예는 \Legal\Documents\에서 Pending Litigation 공용 폴더 및 그 아래의 모든 공용 폴더를 반환합니다. 반환되는 개수에는 제한이 없습니다.
Get-PublicFolder
Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name
Get-PublicFolder -Identity <long-term entry identifier of a public folder>
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited