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 se asigna a ningún grupo de roles. Para usar este cmdlet, debe agregar el rol Listas de direcciones a un grupo de roles (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 $trueEn este ejemplo se crea una nueva OAB denominada Contoso Executives OAB con las siguientes propiedades:
- Listas de direcciones incluidas en 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 el OAB es SystemMailbox{bb558c35-97f1-4cb9-8ff7-d53741dc928c} (no se usó el parámetro GeneratingMailbox para especificar un buzón de la organización diferente).
Los buzones de correo y las bases de datos de buzones de correo no usan OAB que no tienen especificado un OAB (no se ha usado 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 New OAB que usa la distribución basada en Web para clientes de Microsoft Office Outlook 2007 o 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,Version2En Exchange Server 2010, este ejemplo crea el OAB heredado 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 los 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, consulte Administración de carpetas públicas.
Parámetros
-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 necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".
Puede encontrar los valores de identificación de listas de direcciones y listas de direcciones globales mediante los cmdlets Get-AddressList y 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
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, 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 demás cmdlets (por ejemplo, los cmdlets 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 |
| 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
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 de 7 a 1825 o el valor ilimitado. El valor predeterminado es 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
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 |
| 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
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 de 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)
- Dominio\Nombre de usuario
- Dirección de correo electrónico
- 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 varios OAB (puede usar el mismo valor para este parámetro en la configuración de varios OAB), pero en Exchange 2013 CU5 o posterior, un OAB solo puede ser generado por 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 correo de la organización, use el parámetro 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
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 Detección automática anuncia estas ubicaciones. Los valores admitidos son:
- $true: cualquier directorio virtual de OAB de la organización puede aceptar solicitudes para descargar la OAB. No se 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 de cualquier servidor de buzones pueden proxy de las solicitudes de descarga de OAB entrantes en la ubicación correcta.
| 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
El parámetro IsDefault especifica si todos los buzones de correo y las bases de datos de buzones de correo que no tienen una OAB especificada usan la OAB. Los valores admitidos 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 |
| 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
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 |
| 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
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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 de 0 a 6, donde 0 = domingo.
Puede especificar la hora en formato de 24 horas y omitir el valor de AM/PM. Si escribe la hora en formato de hora 12, incluya un espacio entre la hora y el valor de AM/PM.
Puede mezclar y coincidir con 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.
Estos son algunos ejemplos:
- "Dom.23:30-Lun.1:30"
- "6.22:00-6.22:15" (Se ejecuta desde el sábado a las 10:00 p.m. hasta el sábado a las 10:15 p. m.).
- "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
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 |
| Required: | False |
| 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 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 admitidos 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 en las organizaciones de Exchange que tienen varios sitios de Active Directory.
| 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
Este parámetro solo está disponible en Exchange Server 2010.
El modificador SkipPublicFolderInitialization especifica si se omite la creación inmediata de las carpetas públicas de OAB si se crea una OAB que usa la distribución de carpetas públicas. No es necesario especificar un valor con este modificador.
OAB no está disponible para su descarga hasta que se complete el siguiente ciclo de mantenimiento de carpetas del sitio. La omisión de este modificador puede hacer que la tarea se detenga mientras se pone en contacto con el servidor de carpetas públicas responsable para crear las carpetas públicas necesarias. Si el servidor no es accesible actualmente o, de lo contrario, resulta costoso ponerse en contacto con él, la pausa podría ser significativa.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 las versiones de OAB que se generan para la descarga del cliente. Los valores admitidos son:
- Versión 2 (requiere distribución de carpetas públicas)
- Versión 3 (requiere distribución de carpetas públicas)
- Versión4 (valor predeterminado)
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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. Por ejemplo:
- Nombre o Servidor\Nombre
- Nombre completo (DN)
- GUID
El valor Name usa la sintaxis "VirtualDirectoryName (WebsiteName)" 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 back-end de OAB 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, Mailbox01\OAB (sitio web predeterminado),Mailbox01\OAB (back-end de Exchange).
Para usar este parámetro, se debe $false el valor del parámetro GlobalWebDistributionEnabled.
En Exchange 2013 CU7 o posterior, se recomienda establecer el parámetro GlobalWebDistributionEnabled en $true, ya que los servicios de acceso de cliente de cualquier servidor de buzones pueden proxy de las solicitudes de descarga entrantes de OAB en la ubicación correcta.
| 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
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 |
| 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 |
Entradas
Input types
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
Output types
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.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de