New-OfflineAddressBook (RTM)
適用先: Exchange Server 2007
トピックの最終更新日: 2007-06-05
オフライン アドレス帳 (OAB) を新しく作成するには、New-OfflineAddressBook コマンドレットを使用します。
構文
New-OfflineAddressBook -Name <String> -AddressLists <AddressBookBaseIdParameter[]> -Server <ServerIdParameter> [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>]
解説
New-OfflineAddressBook コマンドレットを使用すると、管理者は OAB を新しく作成することができます。たとえば、OAB が含まれるクライアント アクセス サーバーをアンインストールする場合は、OAB を別のクライアント アクセス サーバーに再作成する必要があります。
New-OfflineAddressBook コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。
- Exchange 組織管理者の役割
アクセス許可、役割の委任、および Exchange Server 2007 の管理に必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
パラメータ | 必須 | 種類 | 説明 |
---|---|---|---|
AddressLists |
必須 |
Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[] |
AddressLists パラメータには、OAB に含めるアドレス一覧 ID の配列を指定します。 |
Name |
必須 |
System.String |
Name パラメータには、OAB オブジェクトを Exchange システム マネージャに記述するための名前を指定します (最大 64 文字)。 |
Server |
必須 |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Server パラメータには、新しい OAB を作成するサーバーを指定します。 |
DiffRetentionPeriod |
省略可能 |
System.Nullable |
DiffRetentionPeriod パラメータには、OAB 生成サーバーおよびクライアント アクセス サーバー上で OAB 差分ファイルを保持する期間 (日数) を指定します。OAB 差分ファイルを無期限に保持するには、"Unlimited" という値を使用します。 |
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
DomainController パラメータには、OAB の作成に使用するドメイン コントローラを指定します。 |
IsDefault |
省略可能 |
System.Boolean |
IsDefault パラメータの値が $true である場合、すべての新しいメールボックス データベースに対してこの OAB が既定の OAB に設定されます。値が $false の場合、この OAB は既定の OAB として設定されません。 |
PublicFolderDatabase |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
PublicFolderDatabase パラメータには、パブリック フォルダ データベースの ID を指定します。 |
PublicFolderDistributionEnabled |
省略可能 |
System.Boolean |
PublicFolderDistributionEnabled パラメータの値を |
Schedule |
省略可能 |
Microsoft.Exchange.Data.Schedule |
Schedule パラメータには、新しい OAB を生成するスケジュール間隔を指定します。 Schedule パラメータには、次の形式で範囲を指定する必要があります。曜日.時:分 [AM/PM]-曜日.時:分 [AM/PM] |
TemplateInstance |
省略可能 |
System.Management.Automation.PSObject |
TemplateInstance パラメータには、新しい OAB の作成に使用するテンプレートを指定します。 |
Versions |
省略可能 |
System.Collections.ObjectModel.Collection |
Versions パラメータには、生成する OAB のバージョンを指定します。以下のいずれかの値を指定できます。
|
VirtualDirectories |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[] |
VirtualDirectories パラメータには、OABVirtualDirectory オブジェクトの配列を指定します。VirtualDirectories パラメータを指定する場合は、OAB の Version4 を生成する必要があります。 |
入力の種類
戻り値の種類
エラー
エラー | 説明 |
---|---|
|
例外
例外 | 説明 |
---|---|
|
例
この例では、2 つのコマンドを使用して、組織内の使用可能なすべてのアドレス一覧を含む、OfflineAddressBook という名前の OAB が新しく作成されます。この設定では、月曜日と水曜日の 01:00 (午前 1:00) ~ 02:00 (午前 2:00) の間に、myserver.contoso.com によって OAB が生成されます。このコマンドで作成されるのは、組織の既定の OAB です。
$a = Get-AddressList
New-OfflineAddressBook -Name "OfflineAddressBook" -Server myserver.contoso.com -AddressLists $a -Schedule "Mon.01:00-Mon.02:00, Wed.01:00-Wed.02:00"
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。