Get-AddressList

リファレンス

モジュール:: ExchangePowerShell

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

このコマンドレットは、オンプレミスの Exchange およびクラウドベースのサービスで使用できます。一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

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

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

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

構文

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

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

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

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

名前
識別名 (DN)
GUID
パス: "\AddressListName" または "\ContainerName\AddressListName" (たとえば、 "\All Users" または "\All Contacts\Marketing")

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

Type:	AddressListIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

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

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

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

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

名前
識別名 (DN)
GUID
パス: "\AddressListName" または "\ContainerName\AddressListName" (たとえば、 "\All Users" または "\All Contacts\Marketing")

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

Type:	AddressListIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SearchText

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

入力

Input types

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

出力

Output types

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