Get-PublicFolder (RTM)
適用先: Exchange Server 2007
トピックの最終更新日: 2007-06-06
単一または複数のパブリック フォルダの属性を取得するには、Get-PublicFolder コマンドレットを使用します。
構文
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 コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。
- 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 |
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
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。