Compartir a través de

New-OfflineAddressBook (RTM)

  • Artículo

 

Se aplica a: Exchange Server 2007

Última modificación del tema: 2007-06-05

Utilice el cmdlet New-OfflineAddressBook para crear una nueva libreta de direcciones sin conexión (OAB).

Sintaxis

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[]>]

Descripción detallada

El cmdlet New-OfflineAddressBook permite a los administradores crear OAB nuevas. Por ejemplo, si desinstala un servidor de acceso de cliente que contiene una OAB, será necesario crearla en otro servidor de acceso de cliente.

Para ejecutar el cmdlet New-OfflineAddressBook, la cuenta utilizada debe tener delegado lo siguiente:

  • Función Administrador de la organización de Exchange

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

AddressLists

Necesario

Microsoft.Exchange.Configuration.Tasks.AddressBookBaseIdParameter[]

El parámetro AddressLists especifica una matriz de identidades de lista de direcciones que se incluyen en la OAB.

Name

Necesario

System.String

El parámetro Name especifica el nombre que describe el objeto de OAB en el Administrador del sistema de Exchange (hasta 64 caracteres).

Server

Necesario

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

El parámetro Server especifica el servidor en el que se va a crear la nueva OAB.

DiffRetentionPeriod

Opcional

System.Nullable

El parámetro DiffRetentionPeriod especifica la cantidad de tiempo, en días, durante la cual los archivos de diferencia de OAB se retienen en el servidor que está generando la OAB y en el servidor de acceso de cliente. Para retener los archivos de diferencia de OAB de forma indefinida, utilice el valor "Ilimitado".

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

El parámetro DomainController especifica el controlador de dominio que se va a utilizar para la creación de la OAB.

IsDefault

Opcional

System.Boolean

Si el valor del parámetro IsDefault es $true, se establece la OAB como la OAB predeterminada para todas las bases de datos de buzones nuevas. Si el valor es $false, la OAB no se establece como la OAB predeterminada.

PublicFolderDatabase

Opcional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

El parámetro PublicFolderDatabase especifica la identidad de una base de datos de carpetas públicas.

PublicFolderDistributionEnabled

Opcional

System.Boolean

Si el valor del parámetro PublicFolderDistributionEnabled es $true, la OAB se distribuirá a través de las carpetas públicas.

Schedule

Opcional

Microsoft.Exchange.Data.Schedule

El parámetro Schedule especifica el intervalo programado para generar la OAB nueva.

El parámetro Schedule adopta el formato siguiente y debe incluir un intervalo: DíaDeLaSemana.Hora:Minuto[AM/PM]-DíaDeLaSemana.Hora:Minuto[AM/PM].

TemplateInstance

Opcional

System.Management.Automation.PSObject

El parámetro TemplateInstance especifica la plantilla utilizada para crear la OAB nueva.

Versions

Opcional

System.Collections.ObjectModel.Collection

El parámetro Versions especifica la versión de la OAB que se va a generar. Los valores permitidos son:

  • Version1

  • Version2

  • Version3

  • Version4

VirtualDirectories

Opcional

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter[]

El parámetro VirtualDirectories especifica la matriz de los objetos OABVirtualDirectory. Si se especifica el parámetro VirtualDirectories, debe generarse Version4 de la OAB.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

Excepciones

Excepciones Descripción

 

Ejemplo

Este ejemplo utiliza dos comandos para crear una OAB nueva con el nombre OfflineAddressBook que incluye todas las listas de direcciones disponibles de la organización. Con las opciones que se muestran, myserver.contoso.com genera una OAB los lunes y los miércoles de 01:00 (1:00 a.m.) a 02:00 (2:00 a.m.). El comando también crea la OAB predeterminada para la organización.

$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"