New-OfflineAddressBook

リファレンス

モジュール:: ExchangePowerShell

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

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

オフラインアドレス帳 (OAB) を作成するには、New-OfflineAddressBook コマンドレットを使用します。

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

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

構文

New-OfflineAddressBook
   [-Name] <String>
   -AddressLists <AddressBookBaseIdParameter[]>
   [-Confirm]
   [-DiffRetentionPeriod <Unlimited>]
   [-DomainController <Fqdn>]
   [-GeneratingMailbox <MailboxIdParameter>]
   [-GlobalWebDistributionEnabled <Boolean>]
   [-IsDefault <Boolean>]
   [-PublicFolderDatabase <DatabaseIdParameter>]
   [-PublicFolderDistributionEnabled <Boolean>]
   [-Schedule <Schedule>]
   [-Server <ServerIdParameter>]
   [-ShadowMailboxDistributionEnabled <Boolean>]
   [-SkipPublicFolderInitialization]
   [-Versions <MultiValuedProperty>]
   [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

説明

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

例

例 1

$a = Get-AddressList | Where {$_.Name -Like "*AgencyB*"}

New-OfflineAddressBook -Name "OAB_AgencyB" -Server myserver.contoso.com -AddressLists $a -Schedule "Mon.01:00-Mon.02:00, Wed.01:00-Wed.02:00"

Exchange Server 2010 および 2013 では、この例では 2 つのコマンドを使用して、AgencyB が名前の一部であるすべてのアドレス一覧を含む OAB_AgencyB という名前の OAB を作成します。表示されている設定を使用すると、月曜日と水曜日の 01:00 (午前 1 時) から 02:00 (午前 2 時) に myserver.contoso.com によって OAB が生成されます。このコマンド例では、organizationの既定の OAB も作成します。

例 2

New-OfflineAddressBook -Name "Contoso Executives OAB" -AddressLists "Default Global Address List","Contoso Executives Address List" -GlobalWebDistributionEnabled $true

次の例では、Contoso Executives OAB という新しい OAB を、次のプロパティで作成します。

OAB に含まれるアドレス一覧: 既定のグローバルアドレス一覧と Contoso エグゼクティブアドレス一覧
組織内のすべての OAB 仮想ディレクトリは、OAB をダウンロードする要求を受け入れることができます。

OAB の作成に責任を持つ組織のメールボックスは SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c} です (別の組織のメールボックスを指定するための GeneratingMailbox パラメーターは使用していません)。

OAB は、OAB が指定されていないメールボックスとメールボックスデータベースに使用されていません (IsDefault パラメーターに値 $true を設定していません)。

例 3

New-OfflineAddressBook -Name "New OAB" -AddressLists "\Default Global Address List" -Server SERVER01 -VirtualDirectories "SERVER01\OAB (Default Web Site)"

Exchange Server 2010 では、この例では、既定の仮想ディレクトリを使用して SERVER01 上の Microsoft Office Outlook 2007 以降のクライアントの Web ベースの配布を使用する OAB 新しい OAB を作成します。

例 4

New-OfflineAddressBook -Name "Legacy OAB" -AddressLists "\Default Global Address List" -Server SERVER01 -PublicFolderDatabase "PFDatabase" -PublicFolderDistributionEnabled $true -Versions Version1,Version2

Exchange Server 2010 では、この例では、Outlook 2003 Service Pack 1 (SP1) および Outlook 98 Service Pack 2 (SP2) クライアントのパブリックフォルダー配布を使用する OAB レガシ OAB を SERVER01 に作成します。

パブリックフォルダーの配布を使用するように ORB を構成しても、organizationにパブリックフォルダーインフラストラクチャがない場合は、エラーが返されます。詳細については、「パブリックフォルダーの管理」を参照してください。

パラメーター

-AddressLists

AddressLists パラメーターは、OAB に含まれるアドレス一覧またはグローバルアドレス一覧を指定します。アドレス一覧を一意に識別する任意の値を使用できます。例:

名前
識別名 (DN)
GUID

Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

Get-AddressList と Get-GlobalAddressList のコマンドレットを使って、アドレス一覧およびグローバルアドレス一覧の識別値を検索することができます。

Type:	AddressBookBaseIdParameter[]
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

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

Type:	SwitchParameter
Aliases:	cf
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, Exchange Online

-DiffRetentionPeriod

DiffRetentionPeriod パラメーターは、OAB の差分ファイルがサーバーに格納される日数を指定します。有効な値は、7 から 1825 の整数、または値 unlimited です。既定値は 30 です。

Type:	Unlimited
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, 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

-GeneratingMailbox

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

GeneratingMailbox パラメーターは、OAB が生成される調停メールボックスを指定します。具体的には、調停メールボックスに PersistedCapability プロパティの OrganizationCapabilityOABGen 値が含まれている必要があります。この機能を持つ調停メールボックスは、組織のメールボックスとも呼ばれます。メールボックスを一意に識別する任意の値を使用できます。次に例を示します。

名前
Alias
識別名 (DN)
正規 DN
Domain\Username
電子メールアドレス
GUID
LegacyExchangeDN
SamAccountName
ユーザー ID またはユーザープリンシパル名 (UPN)

このパラメーターの既定値は、SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c} という名前の組織のメールボックスです。

1 つのorganizationメールボックスで複数の OAB を生成できますが (複数の OAB の設定でこのパラメーターに同じ値を使用できます)、Exchange 2013 CU5 以降では、OAB は 1 つのorganization メールボックスによってのみ生成できます (このパラメーターは複数の値を受け入れられません)。他の組織のメールボックスで使用可能な OAB の読み取り専用のコピー (シャドウコピーとも呼ばれる) を持つには、ShadowMailboxDistributionEnabled パラメーターを使います。

Type:	MailboxIdParameter
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

-GlobalWebDistributionEnabled

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

GlobalWebDistributionEnabled パラメーターは、組織内のすべての OAB 仮想ディレクトリで OAB をダウンロードする要求を受け入れられるようにするかどうかを指定します。自動検出サービスによって、これらの場所が通知されます。有効な値は次のとおりです。

$true: organization内のすべての OAB 仮想ディレクトリは、OAB のダウンロード要求を受け入れます。 VirtualDirectories パラメーターでは、この設定を使用できません。
$false: VirtualDirectories パラメーターで指定された OAB 仮想ディレクトリのみが、OAB のダウンロード要求を受け入れます。これは既定の値です。

Exchange 2013 CU7 以降では、このパラメーターに$true値を使用することをお勧めします。任意のメールボックスサーバー上のクライアントアクセスサービスは、受信 OAB ダウンロード要求を正しい場所にプロキシできます。

Type:	Boolean
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

-IsDefault

IsDefault パラメーターは、OAB の指定のないすべてのメールボックスとメールボックスデータベースで OAB を使用するかどうかを指定します。有効な値は次のとおりです。

$true: OAB は既定の OAB です。
$false: OAB は既定の OAB ではありません。これは既定の値です。

Type:	Boolean
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, Exchange Online

-Name

Name パラメーターは、OAB の一意の名前を指定します。最大の長さは 64 文字です。値にスペースが含まれている場合は、値を引用符で囲んでください。

Type:	String
Position:	1
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

-PublicFolderDatabase

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

PublicFolderDatabase パラメーターは、OAB の配布に使用されるパブリックフォルダーデータベースを指定します。データベースを一意に識別する、任意の値を使用できます。以下に例を示します。

名前
識別名 (DN)
GUID

このパラメーターを使用するには、PublicFolderDistributionEnabled パラメーターを $true に設定する必要があります。

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-PublicFolderDistributionEnabled

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

PublicFolderDistributionEnabled パラメーターは、OAB をパブリックフォルダー経由で配布するかどうかを指定します。 PublicFolderDistributionEnabled パラメーターの値が$trueされている場合、OAB はパブリックフォルダーを介して配布されます。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Schedule

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

Schedule パラメーターは、Exchange 2010 以前で OAB を生成する間隔を指定します。

このパラメーターの構文はです。 StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM]

日数は次の値を使用できます。

その日のフルネーム。
日付の省略名。
0 から 6 までの整数。0 = 日曜日。

時刻を 24 時間形式で入力し、AM/PM 値を省略できます。時刻を 12 時間形式で入力する場合は、時刻と AM/PM 値の間にスペースを含めます。

日付/時刻形式を混在させ、一致させることができます。

開始時刻と終了時刻は 15 分以上離れている必要があります。分は 0、15、30、または 45 に切り捨てられます。

次に、いくつかの例を示します:

"Sun.11:30 PM-Mon.1:30 AM"
"6.22:00-6.22:15" (土曜日の午後 10:00 から土曜日の午後 10:15 まで実行されます。
"Sun.1:15 AM-Monday.23:00"

Type:	Schedule
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Server

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

Server パラメーターは、このコマンドの実行先となる Exchange サーバーを指定します。サーバーを一意に識別する任意の値を使用できます。次に例を示します。

名前
FQDN
識別名 (DN)
ExchangeLegacyDN

このパラメーターを使用しない場合、コマンドはローカルサーバー上で実行されます。

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-ShadowMailboxDistributionEnabled

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

ShadowMailboxDistributionEnabled パラメーターは、OAB (シャドウコピーとも呼ばれる) の読み取り専用のコピーを、その他の OAB 生成メールボックス (組織のメールボックスとも呼ばれる) すべてに配布するかどうかを指定します。これにより、OAB をダウンロードするための要求のエンドポイントにするメールボックスサーバーを追加することで、ユーザーが低速の WAN リンク経由で OAB をダウンロードすることがないようにします。有効な値は次のとおりです。

$true: OAB は、他のすべてのorganizationメールボックスに配布されます。
$false: OAB は他のorganizationメールボックスに配布されません。これは既定の値です。

このパラメーターの値は、複数のorganizationメールボックスがある場合にのみ意味があり、複数の Active Directory サイトを持つ Exchange 組織でのみ役立ちます。

Type:	Boolean
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

-SkipPublicFolderInitialization

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

SkipPublicFolderInitialization スイッチは、パブリックフォルダー配布を使用する OAB を作成する場合に、OAB パブリックフォルダーの即時作成をスキップするかどうかを指定します。このスイッチで値を指定する必要はありません。

OAB は、次のサイトフォルダーのメンテナンスサイクルが完了するまでダウンロードできません。このスイッチを省略すると、タスクが責任あるパブリックフォルダーサーバーに接続して必要なパブリックフォルダーを作成している間にタスクが一時停止する可能性があります。サーバーに現在到達できない場合や、接続にコストがかかる場合は、一時停止が重要になる可能性があります。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Versions

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

Versions パラメーターは、クライアントのダウンロード用に生成される OAB のバージョンを指定します。有効な値は次のとおりです。

Version2 (パブリックフォルダーの配布が必要)
Version3 (パブリックフォルダーの配布が必要)
Version4 (既定値)

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-VirtualDirectories

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

VirtualDirectories パラメーターは、OAB のダウンロード要求を受け入れる OAB 仮想ディレクトリを指定します。自動検出サービスで、これらの場所が通知されます。

仮想ディレクトリを一意に識別する任意の値を使用できます。例:

名前またはサーバー\Name
識別名 (DN)
GUID

Name 値は、仮想ディレクトリのプロパティの構文 "VirtualDirectoryName (WebsiteName)" を使用します。構文 VirtualDirectoryName*を使用して、既定の Web サイトの代わりにワイルドカード文字 (*) を指定できます。

このパラメーターの既定値は、OAB 生成メールボックス (GeneratingMailbox パラメーターまたは SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c} を保持するメールボックスサーバー上のクライアントアクセスサービス (フロントエンド) とバックエンド OAB 仮想ディレクトリです。たとえば、Mailbox01\OAB (既定の Web サイト)、Mailbox01\OAB (Exchange バックエンド)。

このパラメーターを使用するには、GlobalWebDistributionEnabled パラメーターの値を $false にする必要があります。

Exchange 2013 CU7 以降では、任意のメールボックスサーバー上のクライアントアクセスサービスが受信 OAB ダウンロード要求を正しい場所にプロキシできるため、GlobalWebDistributionEnabled パラメーターを $true に設定することをお勧めします。

Type:	VirtualDirectoryIdParameter[]
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

-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Aliases:	wi
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, Exchange Online

入力

Input types

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

出力

Output types

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

New-OfflineAddressBook

構文

説明

例

例 1

例 2

例 3

例 4

パラメーター

-AddressLists

-Confirm

-DiffRetentionPeriod

-DomainController

-GeneratingMailbox

-GlobalWebDistributionEnabled

-IsDefault

-Name

-PublicFolderDatabase

-PublicFolderDistributionEnabled

-Schedule

-Server

-ShadowMailboxDistributionEnabled

-SkipPublicFolderInitialization

-Versions

-VirtualDirectories

-WhatIf

入力

出力

フィードバック

フィードバック

その他のリソース