Get-MailPublicFolder

構文

AnrSet

Get-MailPublicFolder
    [-Anr <String>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [-Server <ServerIdParameter>]
    [-SortBy <String>]
    [<CommonParameters>]

Identity

Get-MailPublicFolder
    [[-Identity] <MailPublicFolderIdParameter>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [-Server <ServerIdParameter>]
    [-SortBy <String>]
    [<CommonParameters>]

説明

例

例 1

Get-MailPublicFolder -ResultSize 100 | Format-List

例 2

Get-MailPublicFolder -Identity \Marketing\Reports

例 3

Get-MailPublicFolder -Anr Marketing*

パラメーター

-Anr

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Anr パラメーターには、あいまいな名前を解決 (ANR) するための検索を実行する際に使用する文字列を指定します。 部分的な文字列を指定して、その文字列に一致する属性を持つオブジェクトを検索することができます。 既定で検索対象となっているのは、以下の属性です。

• CommonName (CN)
• DisplayName
• FirstName
• LastName
• Alias

パラメーターのプロパティ

パラメーター セット

-Credential

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Credential パラメーターは、このコマンドの実行に使用されるユーザー名とパスワードを指定します。 通常、このパラメーターはスクリプトや、必要なアクセス許可を持つ別の資格情報を入力する必要がある場合に使用します。

このパラメーターの値には、Get-Credential コマンドレットが必要です。 このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(Get-Credential)を使用します。 または、このコマンドを実行する前に、資格情報を変数 (たとえば、$cred = Get-Credential) に保存し、このパラメーターに変数名 ($cred) を使用します。 詳細については、Get-Credentialに関するページをご覧ください。

パラメーターのプロパティ

パラメーター セット

-DomainController

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

パラメーターのプロパティ

パラメーター セット

-Filter

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Filter パラメーターは、OPATH 構文を使用して、指定したプロパティと値で結果をフィルター処理します。 検索条件は構文"Property -ComparisonOperator 'Value'"を使用します。

• OPATH フィルター全体を二重引用符 " " で囲みます。 フィルターにシステム値 (例えば、$true、$false、または $null) が含まれている場合は、代わりに単一引用符 ' ' を使用します。 このパラメーターは文字列 (システム ブロックではありません) ですが、波かっこ { } を使用することもできますが、これはフィルターに変数が含まれていない場合のみです。
• Property はフィルタリング可能なプロパティです。 Exchange サーバーとExchange Onlineのフィルター可能なプロパティの詳細については、「Filter パラメーターのフィルター可能なプロパティ」を参照してください。
• ComparisonOperator は OPATH 比較演算子です (たとえば、文字列比較の場合は等号と-likeの-eq)。 比較演算子の詳細については、「about_Comparison_Operators」を参照してください。
• Value は、検索するプロパティ値です。 テキスト値と変数を一重引用符 ('Value'または'$Variable') で囲みます。 変数値に一重引用符が含まれている場合、変数を正しく展開するには、一重引用符を識別する (エスケープする) 必要があります。 たとえば、'$User'の代わりに'$($User -Replace "'","''")'を使用します。 整数またはシステム値を引用符で囲まないでください (たとえば、代わりに 500、 $true、 $false、または $null を使用します)。

論理演算子 -and および -or を使用すると、複数の検索条件を連結することができます。 たとえば、"Criteria1 -and Criteria2" または "(Criteria1 -and Criteria2) -or Criteria3" です。

Exchange の OPATH フィルターの詳細については、「 その他の OPATH 構文情報」を参照してください。

パラメーターのプロパティ

パラメーター セット

-Identity

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Identity パラメーターは、特定のパブリック フォルダーを表す GUID またはパブリック フォルダー名を指定します。 また、最上位のパブリック フォルダー\パブリック フォルダー という形式を使用してパスを含めることもできます。

パラメーター ラベルを省略して、パブリック フォルダー名または GUID のみを入力することもできます。

注意: Identity パラメーターの値$null値または存在しない値は、Identity パラメーターなしで Get- コマンドを実行したかのように 、すべての オブジェクトを返します。 Identity パラメーターの値の一覧が正確であり、存在しない$null値が含まれていないことを確認します。

パラメーターのプロパティ

パラメーター セット

-IgnoreDefaultScope

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

IgnoreDefaultScope スイッチは、Exchange PowerShell セッションに対する受信者の範囲の既定の設定を無視し、フォレスト全体を範囲として使用するようにコマンドに指示します。 このスイッチで値を指定する必要はありません。

このスイッチを使用すると、コマンドは、既定の範囲では現在使用できない Active Directory オブジェクトにアクセスできますが、次の制限もあります。

• DomainController パラメーターは使用できません。 このコマンドは、適切なグローバル カタログ サーバーを自動的に使用します。
• Identity パラメーターの DN しか使用できません。 エイリアスや GUID などの他の形式の ID は使用できません。

パラメーターのプロパティ

パラメーター セット

-IncludeGrantSendOnBehalfToWithDisplayNames

適用対象: Exchange Online

このパラメーターは、クラウドベースのサービスでのみ使用できます。

{{ Fill IncludeGrantSendOnBehalfToWithDisplayNames Description }}

パラメーターのプロパティ

パラメーター セット

-ReadFromDomainController

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

ReadFromDomainController スイッチは、情報がユーザーのドメインのドメイン コントローラーから読み取られることを指定します。 このスイッチで値を指定する必要はありません。

コマンド: Set-AdServerSettings -ViewEntireForest $true フォレスト内のすべてのオブジェクトを含めるには、ReadFromDomainController スイッチが必要です。 それ以外の場合、コマンドは、古い情報を含むグローバル カタログを使用する可能性があります。 また、情報を取得するには、ReadFromDomainController スイッチを使用してコマンドの繰り返しを複数回実行する必要がある場合があります。

既定では、受信者の範囲は、Exchange サーバーをホストするドメインに設定されています。

パラメーターのプロパティ

パラメーター セット

-ResultSize

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。

パラメーターのプロパティ

パラメーター セット

-Server

適用対象: Exchange Server 2010

このパラメーターは Exchange Server 2010 でのみ使用できます。

Server パラメーターは、指定した Exchange サーバーによって結果をフィルター処理します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。

• 名前
• FQDN
• 識別名 (DN)
• Exchange の従来の DN

パラメーターのプロパティ

パラメーター セット

-SortBy

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

SortBy パラメーターは、結果を並べ替えるためのプロパティを指定します。 並べ替えの基準にできるのは、一度に 1 つのプロパティのみです。 結果は昇順で並べ替えられます。

既定のビューに並べ替えの対象のプロパティが含まれていない場合は、コマンドを | Format-Table -Auto Property1,Property2,...PropertyXで追加できます。 をクリックして、表示するすべてのプロパティを含む新しいビューを作成します。 プロパティ名にはワイルドカード (*) がサポートされています。

以下のプロパティで並べ替えることができます。

• 名前
• DisplayName
• Alias
• ID

パラメーターのプロパティ

パラメーター セット

CommonParameters

入力

Input types

出力

Output types