New-OfflineAddressBook

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

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

En Exchange Online, este cmdlet solo está disponible en el rol Listas de direcciones y, de forma predeterminada, el rol no está asignado a ningún grupo de roles. Para usar este cmdlet, debe agregar el rol Listas de direcciones a un grupo de funciones (por ejemplo, al grupo de roles Administración de la organización). Para obtener más información, vea Agregar un rol a un grupo de roles.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

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

Description

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

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

En Exchange Server 2010 y 2013, en este ejemplo se usan dos comandos para crear la OAB denominada OAB AgencyB que incluye todas las listas de direcciones en las que AgencyB forma parte del _ nombre. Mediante la configuración que se muestra, myserver.contoso.com genera una OAB los lunes y miércoles de 01:00 (1 a.m.) a 02:00 (2 a.m.). Este comando de ejemplo también crea la OAB predeterminada para la organización.

Ejemplo 2

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

En este ejemplo se crea una nueva OAB denominada Contoso Executives OAB con las siguientes propiedades:

  • Listas de direcciones incluidas en la OAB: Lista global de direcciones predeterminada y Lista de direcciones de ejecutivos de Contoso
  • Todos los directorios virtuales de OAB de la organización pueden aceptar solicitudes para descargar la OAB.

El buzón de la organización responsable de generar la OAB es SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c} (no usamos el parámetro GeneratingMailbox para especificar un buzón de la organización diferente).

Los buzones y las bases de datos de buzones de correo que no tienen una OAB especificada no usan la OAB (no usamos el parámetro IsDefault con el valor $true).

Ejemplo 3

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

En Exchange Server 2010, en este ejemplo se crea la OAB nueva OAB que usa la distribución basada en web para clientes de Microsoft Office Outlook 2007 o versiones posteriores en SERVER01 mediante el directorio virtual predeterminado.

Ejemplo 4

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

En Exchange Server 2010, en este ejemplo se crea la OAB heredada de OAB que usa la distribución de carpetas públicas para los clientes de Outlook 2003 Service Pack 1 (SP1) y Outlook 98 Service Pack 2 (SP2) en SERVER01.

Si configura OAB para usar la distribución de carpetas públicas, pero su organización no tiene ninguna infraestructura de carpetas públicas, se devolverá un error. Para obtener más información, vea Administración de carpetas públicas.

Parámetros

- Name

El parámetro Name especifica el nombre único de la OAB. La longitud máxima es de 64 caracteres. Si el valor contiene espacios, escríbalo entre comillas.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-AddressLists

El parámetro AddressLists especifica las listas de direcciones o las listas globales de direcciones que se incluyen en la OAB. Puede usar cualquier valor que identifique de forma exclusiva la lista de direcciones. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID

Update Si los valores contienen espacios o requieren comillas, use la sintaxis siguiente: "Value1","Value2",..."ValueN" .

Puede encontrar los valores de identificación de las listas de direcciones y las listas globales de direcciones mediante los cmdlets Get-AddressList y Get-GlobalAddressList de direcciones.

Type:AddressBookBaseIdParameter[]
Position:Named
Default value:None
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

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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

El parámetro DiffRetentionPeriod especifica el número de días que los archivos de diferencia de OAB se almacenan en el servidor. Los valores válidos son enteros comprendidos entre 7 y 1825 o el valor ilimitado. El valor predeterminado es 30.

Type:Unlimited
Position:Named
Default value:None
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

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

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

Este parámetro solo está disponible en Exchange local.

El parámetro GeneratingMailbox especifica el buzón de arbitraje donde se genera la OAB. En concreto, el buzón de arbitraje debe contener el valor OrganizationCapabilityOABGen para la propiedad PersistedCapability. Un buzón de arbitraje con esta función también se conoce como un buzón de la organización. Es posible usar cualquier valor que identifique exclusivamente el buzón. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Nombre de usuario del \ dominio
  • Dirección de correo
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

El valor predeterminado para este parámetro es el buzón de la organización denominado SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}.

Un único buzón de la organización puede generar varias OAB (puede usar el mismo valor para este parámetro en la configuración de varias OAB), pero en Exchange 2013 CU5 o posterior, una OAB solo puede generarse mediante un único buzón de la organización (este parámetro no acepta varios valores). Para tener una copia de solo lectura de la OAB (también conocida como instantánea) disponible en otros buzones de la organización, use el parámetro ShadowMailboxDistributionEnabled.

Type:MailboxIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-GlobalWebDistributionEnabled

Este parámetro solo está disponible en Exchange local.

El parámetro GlobalWebDistributionEnabled especifica si todos los directorios virtuales de OAB de la organización pueden aceptar solicitudes para descargar la OAB. El servicio de detección automática anuncia estas ubicaciones. Los valores válidos son:

  • $true: cualquier directorio virtual de OAB de la organización puede aceptar solicitudes para descargar la OAB. No puede usar esta configuración con el parámetro VirtualDirectories.
  • $false: solo los directorios virtuales de OAB especificados por el parámetro VirtualDirectories aceptan solicitudes para descargar la OAB. Este es el valor predeterminado.

En Exchange 2013 CU7 o posterior, se recomienda usar el valor $true para este parámetro. Los servicios de acceso de cliente en cualquier servidor de buzones de correo pueden realizar proxy de las solicitudes de descarga de OAB entrantes en la ubicación correcta.

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

El parámetro IsDefault especifica si todos los buzones y bases de datos de buzones de correo que no tienen una OAB especificada usan la OAB. Los valores válidos son:

  • $true: la OAB es la OAB predeterminada.
  • $false: la OAB no es la OAB predeterminada. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
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

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro PublicFolderDatabase especifica la base de datos de carpetas públicas que se usa para distribuir la OAB. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID

Para usar este parámetro, el parámetro PublicFolderDistributionEnabled debe establecerse en $true.

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

Este parámetro solo está disponible en Exchange Server 2010.

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

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

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro Schedule especifica el intervalo para generar la OAB en Exchange 2010 o versiones anteriores.

La sintaxis de este parámetro es: StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM] .

Puede usar los siguientes valores durante días:

  • Nombre completo del día.
  • Nombre abreviado del día.
  • Entero entre 0 y 6, donde 0 = domingo.

Puede especificar la hora en formato de 24 horas y omitir el valor am/PM. Si escribe la hora en formato de 12 horas, incluya un espacio entre la hora y el valor am/PM.

Puedes mezclar y hacer coincidir los formatos de fecha y hora.

Entre la hora de inicio y la de finalización debe haber al menos un intervalo de 15 minutos. Los minutos se redondean a 0, 15, 30 ó 45.

Aquí le mostramos otros ejemplos:

  • "Dom.23:30-Lun.1:30"
  • "6.22:00-6.22:15" (Ejecutar desde el sábado a las 10:00 p.m. hasta el sábado a las 10:15 p.m.).
  • "Dom.1:15 AM-Lunes.23:00"
Type:Schedule
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-Server

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro Server especifica el servidor Exchange en el que desea ejecutar este comando. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:

  • Name
  • FQDN
  • Distinguished name (DN)
  • ExchangeLegacyDN

Nombre distintivo (DN) heredado de Exchange

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

Este parámetro solo está disponible en Exchange local.

El parámetro ShadowMailboxDistributionEnabled especifica si una copia de solo lectura de la OAB (también conocida como instantánea) se distribuye a todos los demás buzones de generación de OAB (también conocidos como buzones de la organización). Esto permite que los servidores de buzones de correo adicionales sean puntos de conexión para que las solicitudes descarguen la OAB, lo que puede ayudar a evitar que los usuarios descarguen la OAB a través de vínculos WAN lentos. Los valores válidos son:

  • $true: la OAB se distribuye a todos los demás buzones de la organización.
  • $false: la OAB no se distribuye a otros buzones de la organización. Este es el valor predeterminado.

El valor de este parámetro solo es significativo si tiene varios buzones de la organización y solo es beneficioso para las organizaciones de Exchange que tienen varios sitios de Active Directory.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-SkipPublicFolderInitialization

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro SkipPublicFolderInitialization especifica si se omite la creación inmediata de las carpetas públicas de OAB si está creando una OAB que usa la distribución de carpetas públicas. La OAB no está disponible para su descarga hasta que se complete el siguiente ciclo de mantenimiento de carpetas del sitio. No tiene que especificar un valor con el parámetro SkipPublicFolderInitialization. Si se omite este parámetro, la tarea puede pausarse mientras se pone en contacto con el servidor de carpetas públicas responsable para crear las carpetas públicas necesarias. Si actualmente no se puede tener acceso al servidor o, de lo contrario, es costoso ponerse en contacto, la pausa podría ser importante.

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

Este parámetro solo está disponible en Exchange Server 2010.

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

  • Versión 1
  • Versión 2
  • Versión 3
  • Versión 4
Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-VirtualDirectories

Este parámetro solo está disponible en Exchange local.

El parámetro VirtualDirectories especifica los directorios virtuales de OAB que aceptan solicitudes para descargar la OAB. Estas ubicaciones se anuncian en el servicio Detección automática.

You can use any value that uniquely identifies the virtual directory. For example:

  • Nombre o nombre del \ servidor
  • Nombre completo (DN)
  • GUID

El valor Name usa la "VirtualDirectoryName (WebsiteName)" sintaxis de las propiedades del directorio virtual. Puede especificar el carácter comodín ( ) en * lugar del sitio web predeterminado mediante la sintaxis VirtualDirectoryName* .

El valor predeterminado de este parámetro son los servicios de acceso de cliente (front-end) y los directorios virtuales de OAB back-end en el servidor de buzones de correo que contiene el buzón de generación de OAB (el parámetro GeneratingMailbox o SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c}). Por ejemplo, OAB Mailbox01 \ (sitio web predeterminado), OAB Mailbox01 \ (back-end de Exchange).

Para usar este parámetro, el valor del parámetro GlobalWebDistributionEnabled debe ser $false.

En Exchange 2013 CU7 o posterior, se recomienda establecer el parámetro GlobalWebDistributionEnabled en $true, ya que los servicios de acceso de cliente en cualquier servidor de buzones de correo pueden proxy de las solicitudes de descarga de OAB entrantes en la ubicación correcta.

Type:VirtualDirectoryIdParameter[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Entradas

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.