Set-OfficeWebAppsFarm

Sintaxis

Default (Es el valor predeterminado).

Set-OfficeWebAppsFarm
    [-Force]
    [-FarmOU <String>]
    [-InternalURL <String>]
    [-ExternalURL <String>]
    [-AllowHttp]
    [-AllowOutboundHttp]
    [-SSLOffloaded]
    [-CertificateName <String>]
    [-S2SCertificateName <String>]
    [-EditingEnabled]
    [-Proxy <String>]
    [-LogLocation <String>]
    [-LogRetentionInDays <UInt32>]
    [-LogVerbosity <String>]
    [-CacheLocation <String>]
    [-MaxMemoryCacheSizeInMB <Int32>]
    [-DocumentInfoCacheSize <UInt32>]
    [-CacheSizeInGB <Int32>]
    [-ClipartEnabled]
    [-TranslationEnabled]
    [-MaxTranslationCharacterCount <Int32>]
    [-TranslationServiceAppId <String>]
    [-TranslationServiceAddress <String>]
    [-RenderingLocalCacheLocation <String>]
    [-RecycleActiveProcessCount <UInt32>]
    [-AllowCEIP]
    [-ExcelRequestDurationMax <Int32>]
    [-ExcelSessionTimeout <Int32>]
    [-ExcelWorkbookSizeMax <Int32>]
    [-ExcelPrivateBytesMax <Int32>]
    [-ExcelConnectionLifetime <Int32>]
    [-ExcelExternalDataCacheLifetime <Int32>]
    [-ExcelAllowExternalData]
    [-ExcelUseEffectiveUserName]
    [-ExcelWarnOnDataRefresh]
    [-ExcelUdfsAllowed]
    [-ExcelMemoryCacheThreshold <Int32>]
    [-ExcelUnusedObjectAgeMax <Int32>]
    [-ExcelCachingUnusedFiles]
    [-ExcelAbortOnRefreshOnOpenFail]
    [-ExcelAutomaticVolatileFunctionCacheLifeTime <Int32>]
    [-ExcelConcurrentDataRequestsPerSessionMax <Int32>]
    [-ExcelDefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
    [-ExcelRestExternalDataEnabled]
    [-ExcelChartAndImageSizeMax <Int32>]
    [-OpenFromUrlEnabled]
    [-OpenFromUncEnabled]
    [-OpenFromUrlThrottlingEnabled]
    [-PicturePasteDisabled]
    [-RemovePersonalInformationFromLogs]
    [-AllowHttpSecureStoreConnections]
    [-WhatIf]
    [-Confirm]

Description

Ejemplos

EJEMPLO 1

Set-OfficeWebAppsFarm -ClipartEnabled:$true

EJEMPLO 2

Set-OfficeWebAppsFarm -EditingEnabled:$true

EJEMPLO 3

Set-OfficeWebAppsFarm -OpenFromUncEnabled:$false

Parámetros

-AllowCEIP

Habilita los informes del Programa de mejora de la experiencia del cliente (CEIP) en todos los servidores de la granja de Office Online Server.

Debe reiniciar todos los servidores de la granja de Office Online Server para que este cambio surta efecto.

Propiedades del parámetro

Conjuntos de parámetros

-AllowHttp

Indica que los sitios iis deben aprovisionarse en el puerto 80 para el acceso HTTP. Use AllowHTTP solo en entornos en los que todos los PC necesiten IPSEC (cifrado completo) o en entornos de prueba que no contengan archivos confidenciales.

Se habilita automáticamente al habilitar SSLOffloaded.

Debe reiniciar todos los servidores de la granja de servidores para que este cambio tenga efecto.

Propiedades del parámetro

Conjuntos de parámetros

-AllowHttpSecureStoreConnections

Indica que se pueden establecer conexiones seguras con el almacén usando conexiones sin SSL (como HTTP). El valor predeterminado es False.

Use AllowHTTPSecureStoreConnections solo en entornos en que todos los PC requieran IPSEC (cifrado completo) o en entornos de prueba que no contengan archivos confidenciales.

Propiedades del parámetro

Conjuntos de parámetros

-AllowOutboundHttp

Permite conexiones HTTP salientes desde Office Online Server.

Propiedades del parámetro

Conjuntos de parámetros

-CacheLocation

Especifica la ubicación de la caché de disco global que se usa para almacenar archivos de imagen representados. La ubicación predeterminada es %programdata%\Microsoft\OfficeWebApps\Working\d\.

Propiedades del parámetro

Conjuntos de parámetros

-CacheSizeInGB

Especifica el tamaño máximo de la caché de disco global en gigabytes. El tipo debe ser un valor entero entre 0 y cualquier entero positivo. El tamaño predeterminado es 15 GB.

Propiedades del parámetro

Conjuntos de parámetros

-CertificateName

Especifica el nombre descriptivo del certificado que Office Online Server usa para crear enlaces HTTPS.

Si el certificado especificado no se encuentra o ha expirado, o si el valor especificado está asociado a más de un certificado, se registra un error y no se crea la granja de servidores.

Este valor se usa en todos los servidores que se unen a la granja de Office Online Server. Por lo tanto, todos los servidores de la granja de servidores deben tener un certificado que tenga este nombre descriptivo.

No es necesario especificar el parámetro CertificateName si usa el parámetro AllowHttp o SSLOffloaded.

Debe reiniciar todos los servidores de la granja de servidores para que este cambio tenga efecto.

Propiedades del parámetro

Conjuntos de parámetros

-ClipartEnabled

Permite la compatibilidad con la inserción de imágenes prediseñadas de Office.com en documentos de Office. Esta característica requiere que exista una comunicación entre servidor y web, ya sea configurada directamente o mediante un proxy que especifique con el parámetro Proxy.

Propiedades del parámetro

Conjuntos de parámetros

-Confirm

Le pide confirmación antes de ejecutar el comando.

Propiedades del parámetro

Conjuntos de parámetros

-DocumentInfoCacheSize

Especifica el número máximo de registros de conversión de documentos que hay almacenados en una caché de memoria.

El valor predeterminado es 5000 registros.

Propiedades del parámetro

Conjuntos de parámetros

-EditingEnabled

Habilita la compatibilidad para editar en el explorador. El valor predeterminado es False. Solo puede definirlo como True si tiene la licencia adecuada para usar la función de edición.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelAbortOnRefreshOnOpenFail

Impide que un libro se cargue si se produce un error de actualización de datos. Esto ayuda a evitar que los usuarios vean información sin actualizar o que puedan consultar información a la que no deberían tener acceso.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelAllowExternalData

Habilita la actualización de datos externos admitidos en libros de Excel en un explorador donde los libros contienen conexiones a datos externos. El valor predeterminado es True.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelAutomaticVolatileFunctionCacheLifeTime

Especifica la cantidad de tiempo máxima, en segundos, durante la que un valor calculado para una función volátil se almacena en caché con el fin de realizar nuevos cálculos automáticos.

• -1: Realiza el cálculo una vez al cargar el libro.
• 0: se calcula siempre.
• 1 a 2073600: se almacena en la memoria caché de 1 segundo a 24 días.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelCachingUnusedFiles

Habilite el almacenamiento en caché de archivos que ya no se usan en las sesiones web de Excel.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelChartAndImageSizeMax

Especifica el tamaño máximo, en megabytes, de un gráfico o imagen que Excel puede abrir en un explorador. El valor debe ser un entero mayor que 0.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelConcurrentDataRequestsPerSessionMax

Especifica el número máximo de solicitudes de datos externos simultáneas que se permite en cada sesión. Si en una sesión se debe emitir un número mayor de solicitudes, las solicitudes adicionales se pondrán en cola.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelConnectionLifetime

Especifica la duración, en segundos, de las conexiones de datos externos para Excel en un explorador. El valor predeterminado es de 1800 segundos.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelDefaultWorkbookCalcMode

PARAMVALUE: Archivo | Manual | Automático | Tablas de datos automáticas

Propiedades del parámetro

Conjuntos de parámetros

-ExcelExternalDataCacheLifetime

Especifica la duración, en segundos, de la duración de la caché de datos externa en Excel en un explorador. El valor predeterminado es 300 segundos.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelMemoryCacheThreshold

Especifica el porcentaje del máximo de bytes privados que se puede asignar a objetos inactivos. Cuando se supera el umbral de caché, se liberan los objetos almacenados en caché que actualmente no están en uso. Valores aceptados: 0 (deshabilita el almacenamiento en caché de objetos inactivos); desde 1 a través de 95.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelPrivateBytesMax

Especifica el número máximo de bytes privados, en megabytes, utilizados por Excel en un explorador. Cuando se establece en -1, el máximo de bytes privados usa el 50 por ciento de la memoria física del PC.

El tipo debe ser -1 o cualquier número entero positivo. El valor predeterminado es -1.

Debe reiniciar todos los servidores de la granja de servidores para que este cambio tenga efecto.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelRequestDurationMax

Especifica la duración máxima, en segundos, para una única solicitud en una sesión. Transcurrido este tiempo, expira la solicitud.

El tipo debe ser -1 (sin límite) o un número entero entre 1 y 2073600. El valor predeterminado es 300.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelRestExternalDataEnabled

Permita solicitudes de la API de REST para actualizar las conexiones de datos externos. Esta configuración no surtirá ningún efecto si la opción Permitir datos externos está establecida en None. Casilla Bool. El valor predeterminado es False.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelSessionTimeout

Especifica el tiempo, en segundos, que una sesión permanece activa en Excel en un explorador cuando no hay ninguna actividad de usuario. Valores válidos:

• -1 La sesión nunca expira.
• 0 La sesión expira al final de una sola solicitud.
• De 1 a 2073600: la sesión permanece activa de 1 segundo a 24 días.

El valor predeterminado es 450.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelUdfsAllowed

Habilita funciones definidas por el usuario para Excel en un explorador. El valor predeterminado es False.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelUnusedObjectAgeMax

La cantidad de tiempo máxima (en minutos) durante la que los objetos inactivos permanecen en la memoria caché. Los objetos inactivos son los objetos que no se usan en una sesión.

Valores válidos:

• -1 (sin máximo)
• De 1 a 34560 (24 días).

El valor predeterminado es -1.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelUseEffectiveUserName

Habilita el uso del parámetro EffectiveUserName de Analysis Services con Excel en un explorador. El valor predeterminado es False.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelWarnOnDataRefresh

Desactiva o activa el cuadro de diálogo de advertencia que se muestra cuando los datos se actualizan en Excel en un explorador.

Propiedades del parámetro

Conjuntos de parámetros

-ExcelWorkbookSizeMax

Especifica el tamaño máximo en megabytes de un libro que se puede cargar.

El tipo debe ser un valor entero entre 1 y 2000. El valor predeterminado es 10.

Propiedades del parámetro

Conjuntos de parámetros

-ExternalURL

Especifica la raíz de dirección URL que los clientes usan para acceder a la granja de Office Online Server desde Internet. En el caso de una granja de servidores de Office Online Server con equilibrio de carga y varios servidores, la dirección URL externa se enlaza a la dirección IP del equilibrador de carga externo.

Una granja de Office Online Server requiere al menos una dirección URL, que se establece mediante ExternalURL o InternalURL. También puede establecer URL tanto internas como externas.

Propiedades del parámetro

Conjuntos de parámetros

-FarmOU

Especifica el nombre de la unidad organizativa (UO) de Active Directory de la que los servidores deben ser miembros para unirse a la granja de Office Online Server. Use este parámetro para evitar que los servidores no autorizados (es decir, los servidores que no están en la unidad organizativa) se unan a una granja de Office Online Server.

Propiedades del parámetro

Conjuntos de parámetros

-Force

Suprime los mensajes de los usuarios respondiendo "Sí".

Propiedades del parámetro

Conjuntos de parámetros

-InternalURL

Especifica la raíz de dirección URL que los clientes deben usar para acceder a la granja de Office Online Server desde la intranet.

Una granja de Office Online Server requiere al menos una dirección URL. Se establece mediante ExternalURL o InternalURL. También puede establecer URL tanto internas como externas.

Propiedades del parámetro

Conjuntos de parámetros

-LogLocation

Especifica la ubicación del PC local en la que se almacenan los registros de actividad.

La ubicación se aplica para todos los servidores y no se puede personalizar por cada servidor. La ubicación predeterminada es %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS\.

Asegúrese de dejar el suficiente espacio en disco en la unidad en la que se almacenan los registros.

Debe reiniciar todos los servidores de la granja de servidores para que este cambio tenga efecto.

Propiedades del parámetro

Conjuntos de parámetros

-LogRetentionInDays

Especifica el número de días que se almacenan las entradas del registro. Las que son anteriores a la fecha configurada se recortan.

El tipo debe ser un valor entero entre 0 y 365. El valor predeterminado es 7 días.

Debe reiniciar todos los servidores de la granja de servidores para que este cambio tenga efecto.

Propiedades del parámetro

Conjuntos de parámetros

-LogVerbosity

Especifica cuánta información se almacena en los archivos del registro de seguimiento. Los valores son los siguientes:

• VerboseEX escribe detalle de bajo nivel en el archivo del registro de seguimiento. Es útil para seguimientos que puedan tener un gran volumen.
• Verbose escribe detalle de bajo nivel en el archivo del registro de seguimiento.
• Medium escribe detalle de nivel medio en el archivo del registro de seguimiento.
• High escribe detalle de alto nivel en el archivo del registro de seguimiento.
• Monitorable escribe seguimientos que representan una ruta de acceso de código poco habitual y acciones que deben supervisarse.
• Unexpected escribe seguimientos que representan una ruta de acceso de código inesperada que debe supervisarse.
• None no escribe ninguna información de seguimiento en el archivo del registro de seguimiento.

Si deja LogVerbosity en un nivel bajo durante un período de tiempo prolongado, el rendimiento se verá afectado de manera negativa.

Debe reiniciar todos los servidores de la granja de servidores para que este cambio tenga efecto.

Propiedades del parámetro

Conjuntos de parámetros

-MaxMemoryCacheSizeInMB

Especifica, en megabytes, la cantidad máxima de memoria que puede usar la caché de representación.

El tipo debe ser un valor entero entre 0 y cualquier entero positivo. El tamaño predeterminado es 1024 MB.

Propiedades del parámetro

Conjuntos de parámetros

-MaxTranslationCharacterCount

Especifica la cantidad máxima de caracteres que puede tener un documento para traducirse.

El tipo debe ser un valor entero. Se puede definir en 0 para indicar que no hay ningún límite o entre 2000 y 2.000.000. El valor predeterminado es 125.000.

Propiedades del parámetro

Conjuntos de parámetros

-OpenFromUncEnabled

Activa o desactiva la capacidad de usar visores en línea pera ver archivos de Office de una ruta de acceso UNC.

Para que los visores en línea puedan mostrar los archivos de rutas de acceso UNC, es necesario definir OpenFromUrlEnabled en True.

Propiedades del parámetro

Conjuntos de parámetros

-OpenFromUrlEnabled

Activa o desactiva la capacidad de usar visores en línea para ver archivos de Office desde una dirección URL o una ruta de acceso UNC.

Propiedades del parámetro

Conjuntos de parámetros

-OpenFromUrlThrottlingEnabled

Limita el número de solicitudes de apertura desde direcciones URL de un servidor específico en un período de tiempo determinado. Los valores de limitación predeterminados, que no son configurables, asegúrese de que una granja de Office Online Server no saturará un único servidor con solicitudes de contenido que se verán en los Visores en línea.

Propiedades del parámetro

Conjuntos de parámetros

-PicturePasteDisabled

Desactiva la posibilidad de que los usuarios peguen imágenes de una página web en Office en un explorador. El valor predeterminado es False. Si OpenFromURLEnabled está establecido en True y PicturePasteDisabled no está establecido o establecido en False, los usuarios pueden pegar imágenes en Office en un explorador.

Propiedades del parámetro

Conjuntos de parámetros

-Proxy

Especifica la URL del servidor proxy que se configura para permitir solicitudes HTTP a sitios externos. Por lo general, se configura con los parámetros ClipartEnabled y TranslationEnabled.

Propiedades del parámetro

Conjuntos de parámetros

-RecycleActiveProcessCount

Especifica el número de archivos que un solo proceso de Word o PowerPoint puede representar antes de reciclar el proceso. El tipo debe ser un valor entero entre 1 y 1000. El valor predeterminado es 5.

Debe reiniciar todos los servidores de la granja de servidores para que este cambio tenga efecto.

Propiedades del parámetro

Conjuntos de parámetros

-RemovePersonalInformationFromLogs

Proporciona un mejor esfuerzo de limpieza de la información personal de los registros de Office Online Server y reemplaza los valores por un hash SHA256. La información potencialmente validada puede ser:

• Nombres de documentos y direcciones URL
• Direcciones IP
• Dirección de correo
• Nombres de usuario

El valor predeterminado es False. Tenga en cuenta que habilitar este parámetro no garantiza que la información personal no se registre en los registros de Office Online Server.

Propiedades del parámetro

Conjuntos de parámetros

-RenderingLocalCacheLocation

Especifica la ubicación de la caché temporal para que la usen los Word y PowerPoint Viewing Services.

La ubicación predeterminada es %programdata%\Microsoft\OfficeWebApps\Working\waccache\.

Propiedades del parámetro

Conjuntos de parámetros

-S2SCertificateName

Nombre descriptivo del certificado que se va a usar para la autenticación de servidor a servidor con SharePoint Server.

Propiedades del parámetro

Conjuntos de parámetros

-SSLOffloaded

Indica a los servidores de la granja de Office Online Server que SSL se descarga en el equilibrador de carga. Cuando SSLOffloaded está habilitado, las aplicaciones web están enlazadas al puerto 80 (HTTP) del servidor local. Sin embargo, el HTML que hace referencia a otros recursos, como CSS o imágenes, usa direcciones URL de HTTPS para dichas referencias.

Debe reiniciar todos los servidores de la granja de servidores para que este cambio tenga efecto.

Propiedades del parámetro

Conjuntos de parámetros

-TranslationEnabled

Habilita la compatibilidad para la traducción automática de documentos usando Microsoft Translator, un servicio en línea que traduce texto entre idiomas. El archivo traducido se muestra en Word. Como Microsoft Translator es un servicio en línea, debe habilitar la comunicación entre servidor y web directamente o usando un proxy que puede especificar con el parámetro Proxy.

Microsoft Translator puede recopilar datos para mejorar la calidad de las traducciones.

Propiedades del parámetro

Conjuntos de parámetros

-TranslationServiceAddress

Especifica la URL del servidor de traducción al que se envían las solicitudes de traducción. El valor predeterminado es el servicio en línea de Microsoft Translator. Normalmente, este parámetro no se usa, a menos que deba cambiar los servicios de traducción.

Debe reiniciar todos los servidores de la granja de Office Online Server para que este cambio surta efecto.

Propiedades del parámetro

Conjuntos de parámetros

-TranslationServiceAppId

Especifica el identificador de la aplicación del servicio de traducción. El valor predeterminado es el identificador de aplicación pública para Office en un explorador. Normalmente, este parámetro no se usa a menos que haya negociado servicios adicionales con Microsoft Translator y le hayan dado un identificador de aplicación privada.

Propiedades del parámetro

Conjuntos de parámetros

-WhatIf

Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando.

Propiedades del parámetro

Conjuntos de parámetros