次の方法で共有

Get-AddressList

モジュール:
Exchange PowerShell

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または他の環境に限定される場合があります。

Get-AddressList コマンドレットを使用して、アドレス一覧を表示します。

Exchange Online で、このコマンドレットはアドレス一覧の役割でのみ使用できます。既定では、この役割は役割グループに割り当てられていません。 このコマンドレットを使用するには、アドレス一覧の役割を役割グループ (たとえば、組織の管理 役割グループ) に追加する必要があります。 詳細については、「役割グループへ役割を追加する」を参照してください。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Container 

Get-AddressList
    -Container <AddressListIdParameter>
    [-DomainController <Fqdn>]
    [<CommonParameters>]

Identity 

Get-AddressList
    [[-Identity] <AddressListIdParameter>]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

SearchSet 

Get-AddressList
    [-SearchText <String>]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

説明

Get-AddressList コマンドレットの出力を、これらの各コマンドレットで Identity パラメーターを使用する代わりに、Remove-AddressList、Set-AddressList、Update-AddressList、Move-AddressList コマンドレットにパイプできます。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Get-AddressList

この例では、すべてのアドレス一覧の要約リストを返します。

例 2

Get-AddressList -Identity "All Users\Sales\building4" | Format-List

この例では、All Users\Sales\ にある building4 という名前のアドレス一覧に関する詳細情報を返します。

パラメーター

-Container

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

Container パラメーターは、アドレス一覧の場所に基づいて結果をフィルター処理します。 指定されたパスにあるアドレス一覧のみが返されます。 このパラメーターの有効な入力は、ルートパス "\" (すべてのアドレス一覧とも呼ばれます) または既存のアドレス一覧です。 アドレス一覧を一意に識別する任意の値を使用できます。 例:

  • 名前
  • 識別名 (DN)
  • GUID
  • パス: "\AddressListName" または "\ContainerName\AddressListName" ( "\All Users" や "\All Contacts\Marketing"など)

このパラメーターは Identity パラメーターや SearchText パラメーターと併用できません。

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

型:AddressListIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Container
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-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 です。

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

型:Fqdn
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

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

Identity 表示したい アドレス一覧を指定します。 アドレス一覧を一意に識別する任意の値を使用できます。 例:

  • 名前
  • 識別名 (DN)
  • GUID
  • パス: "\AddressListName" または "\ContainerName\AddressListName" ( "\All Users" や "\All Contacts\Marketing"など)

このパラメーターは Container パラメーターや SearchText パラメーターと併用できません。

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

型:AddressListIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Identity
配置:1
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-SearchText

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

SearchText パラメーターは、アドレス一覧の名前と表示名に基づいて結果をフィルター処理します。 指定したテキスト文字列を含む名前または表示名を持つアドレス一覧のみが返されます。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

このパラメーターは Container パラメーターや Identity パラメーターと併用できません。

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

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SearchSet
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。