Get-PublicFolder
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2009-05-12
単一または複数のパブリック フォルダの属性を取得するには、Get-PublicFolder コマンドレットを使用します。
構文
Get-PublicFolder [-Identity <PublicFolderIdParameter>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
解説
Get-PublicFolder コマンドレットを実行するには、使用するアカウントに次の役割が委任されている必要があります。
- 対象サーバーの Exchange パブリック フォルダ管理者の役割およびローカルの Administrators グループ
パラメータ
パラメータ | 必須かどうか | 種類 | 説明 |
---|---|---|---|
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 |
Identity パラメータを使用して、特定のパブリック フォルダを表す GUID またはパブリック フォルダ名を指定します。また、最上位のパブリック フォルダ\パブリック フォルダという形式を使用してパスを含めることもできます。 パラメータ ラベルの 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) が返されます。
- 2 番目の例では、システム フォルダのルート (\NON_IPM_SUBTREE) から始まるすべてのシステム フォルダの名前 (既定では表示されません) が返されます。
- 3 番目の例では、指定した長期のエントリ ID を持つパブリック フォルダが返されます。
- 4 番目の例では、\Legal\Documents\ の Pending Litigation パブリック フォルダが返されます。
- 5 番目の例では、\Legal\Documents\ の Pending Litigation パブリック フォルダと、Pending Litigation の下にある最大 9,999 のパブリック フォルダが返されます。
- 6 番目の例では、\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
Get-PublicFolder コマンドレットを実行したときに UseDatabaseQuotaDefaults の値が True になっている場合は、次の値が Get-PublicFolderDatabase からのデータベース値と共に表示されます。
- MaxItemSize
- IssueWarningQuota
- ProhibitPostQuota
さらに、各値には文字列 "(InheritFromDB)" が付加されます。
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。