Set-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 Set-OfflineAddressBook para modificar la configuración de la libreta 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
Set-OfflineAddressBook
[-Identity] <OfflineAddressBookIdParameter>
[-AddressLists <AddressBookBaseIdParameter[]>]
[-ApplyMandatoryProperties]
[-ConfiguredAttributes <MultiValuedProperty>]
[-Confirm]
[-DiffRetentionPeriod <Unlimited>]
[-DomainController <Fqdn>]
[-FullOabDownloadPreventionThreshold <Int32>]
[-GeneratingMailbox <MailboxIdParameter>]
[-GlobalWebDistributionEnabled <Boolean>]
[-IsDefault <Boolean>]
[-MaxBinaryPropertySize <Int32>]
[-MaxMultivaluedBinaryPropertySize <Int32>]
[-MaxMultivaluedStringPropertySize <Int32>]
[-MaxStringPropertySize <Int32>]
[-Name <String>]
[-PublicFolderDistributionEnabled <Boolean>]
[-Schedule <Schedule>]
[-ShadowMailboxDistributionEnabled <Boolean>]
[-UpgradeFromE14]
[-UseDefaultAttributes]
[-Versions <MultiValuedProperty>]
[-VirtualDirectories <VirtualDirectoryIdParameter[]>]
[-WhatIf]
[-ZipOabFilesBeforeUploading <Boolean>]
[<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
Set-OfflineAddressBook -Identity "Default Offline Address Book" -VirtualDirectories $null -GlobalWebDistributionEnabled $trueEn este ejemplo se configura la OAB denominada Libreta de direcciones sin conexión predeterminada para que esté disponible para las solicitudes de descarga de todos los directorios virtuales de OAB de la organización.
Ejemplo 2
Set-OfflineAddressBook -Identity "\Default Offline Address Book" -GeneratingMailbox OABGen2En este ejemplo se cambia el buzón de la organización responsable de generar la OAB.
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: | 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 |
-ApplyMandatoryProperties
El modificador ApplyMandatoryProperties especifica si se deben actualizar las propiedades obligatorias de un OAB heredado. No es necesario especificar un valor con este modificador.
Este modificador se usó en entornos de coexistencia cuando se migró una OAB desde Exchange 2003.
| Type: | SwitchParameter |
| 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 |
-ConfiguredAttributes
El parámetro ConfiguredAttributes especifica las propiedades MAPI del destinatario que están disponibles en la OAB. Este parámetro usa la sintaxis: "Name1,Type1","Name2,Type2",..."NameN,TypeN" donde Name es el nombre de la propiedad MAPI (por ejemplo, MobileTelephoneNumber) y Type es el valor ANR (resolución de nombres ambiguos), Value o Indicator.
Para restablecer este parámetro a los valores predeterminados, use el modificador UseDefaultAttributes.
| Type: | MultiValuedProperty |
| 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 |
-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 |
-FullOabDownloadPreventionThreshold
Este parámetro está reservado para uso interno de Microsoft.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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 |
-Identity
El parámetro Identity especifica la OAB que desea modificar. Puede usar cualquier valor que identifique de forma exclusiva la OAB. Por ejemplo:
- Nombre o \Nombre
- Nombre completo (DN)
- GUID
| Type: | OfflineAddressBookIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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.
| 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 |
-MaxBinaryPropertySize
Este parámetro solo está disponible en Exchange local.
El parámetro MaxBinaryPropertySize especifica el tamaño máximo en bytes para los atributos binarios de la OAB antes de truncarse. Los valores válidos son enteros de 0 a 999999999. El valor predeterminado es 65536.
| Type: | Int32 |
| 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 |
-MaxMultivaluedBinaryPropertySize
Este parámetro solo está disponible en Exchange local.
El parámetro MaxMultivaluedBinaryPropertySize especifica el tamaño máximo en bytes para los atributos binarios multivalor en la OAB antes de truncarse. Los valores válidos son enteros de 0 a 999999999. El valor predeterminado es 65536 (64 kilobytes).
| Type: | Int32 |
| 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 |
-MaxMultivaluedStringPropertySize
Este parámetro solo está disponible en Exchange local.
El parámetro MaxMultivaluedStringPropertySize especifica el tamaño máximo de los atributos de cadena multivalor en la OAB antes de truncarse. Los valores válidos son enteros de 0 a 999999999. El valor predeterminado es 65536 (64 kilobytes).
| Type: | Int32 |
| 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 |
-MaxStringPropertySize
Este parámetro solo está disponible en Exchange local.
El parámetro MaxStringPropertySize especifica el tamaño máximo en bytes para los atributos de cadena antes de truncarse. Los valores válidos son enteros de 0 a 999999999. El valor predeterminado es 3400.
| Type: | Int32 |
| 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 |
-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: | 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 |
-PublicFolderDistributionEnabled
Este parámetro solo está disponible en Exchange Server 2010.
El parámetro PublicFolderDistributionEnabled especifica si la OAB se va a distribuir a través de carpetas públicas. Al establecer el parámetro PublicFolderDistributionEnabled en un valor de $true se establece la OAB que se va a distribuir a través de carpetas públicas. El valor predeterminado es $true.
| 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 funciona en Exchange 2010.
En Exchange 2013 o posterior, este parámetro ya no es responsable de la programación de generación de OAB. Para obtener más información, vea Cambiar la programación de generación de libreta de direcciones sin conexión en Exchange.
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"
Nota: En Exchange Online, el valor de solo lectura de esta propiedad se muestra en Hora universal coordinada (UTC).
| Type: | Schedule |
| 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 |
-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 |
-UpgradeFromE14
Este parámetro está reservado para uso interno de Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-UseDefaultAttributes
El modificador UseDefaultAttributes especifica si se deben revertir las propiedades MAPI del destinatario que están disponibles en la OAB a la lista predeterminada. No es necesario especificar un valor con este modificador.
Puede usar este modificador para deshacer los cambios realizados en la lista predeterminada mediante el parámetro ConfiguredAttributes.
| Type: | SwitchParameter |
| 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 |
-Versions
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 en Exchange 2010 o posterior; el único valor disponible en Exchange 2013 o posterior)
| Type: | MultiValuedProperty |
| 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 |
-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 de 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}) al crear la OAB (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 este parámetro en $null y, a continuación, 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 de OAB entrantes 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 |
-ZipOabFilesBeforeUploading
ZipOabFilesBeforeUploading especifica si se debe usar la compresión de archivos ZIP en los archivos OAB antes de cargarlos en el servidor. Los valores admitidos son:
- $true: ZIP los archivos OAB.
- $false: no comprima los archivos OAB. 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 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