Share via

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 を参照してください。