New-OfflineAddressBook

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2008-01-21

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

Sintaxis

New-OfflineAddressBook -Name <String> -AddressLists <AddressBookBaseIdParameter[]> -Server <ServerIdParameter> [-Confirm [<SwitchParameter>]] [-DiffRetentionPeriod <Nullable>] [-DomainController <Fqdn>] [-IsDefault <$true | $false>] [-PublicFolderDatabase <DatabaseIdParameter>] [-PublicFolderDistributionEnabled <$true | $false>] [-Schedule <Schedule>] [-SkipPublicFolderInitialization <SwitchParameter>] [-TemplateInstance <PSObject>] [-Versions <Collection>] [-VirtualDirectories <VirtualDirectoryIdParameter[]>] [-WhatIf [<SwitchParameter>]]

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 que use 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.
Confirm	Opcional	System.Management.Automation.SwitchParameter	El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.
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].
SkipPublicFolderInitialization	Opcional	System.Management.Automation.SwitchParameter	Si está creando una OAB que usa la distribución de carpetas públicas, utilice el parámetro SkipPublicFolderInitialization para omitir la creación inmediata de las carpetas públicas de OAB. La OAB no se podrá descargar hasta que se haya completado el siguiente ciclo de mantenimiento de carpetas del sitio. No es necesario especificar ningún valor con el parámetro SkipPublicFolderInitialization. La omisión de este parámetro puede dar lugar a que la tarea se ponga en pausa mientras establece la comunicación con el servidor de carpetas públicas responsable para crear las carpetas públicas necesarias. Si en ese momento el servidor está inaccesible o resulta costoso obtener acceso al él, el tiempo de pausa puede ser significativo.
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.
WhatIf	Opcional	System.Management.Automation.SwitchParameter	El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

Tipos de entrada

Tipos de valores devueltos

Errores

Error	Descripción

Excepciones

Excepciones	Descripción

Ejemplo

En este ejemplo se usan 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"