New-OfficeWebAppsFarm

Crea una nueva granja de servidores de Office Online Server en el equipo local.

Syntax

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

El cmdlet New-OfficeWebAppsFarm crea una nueva granja de Office Online Server en el equipo local. Este cmdlet se ejecuta en el primer servidor de la granja de Office Online Server y, a continuación, se agregan más servidores a la granja de servidores mediante el cmdlet New-OfficeWebAppsMachine.

Ejemplos

------------------EJEMPLO 1---------------------

New-OfficeWebAppsFarm -ExternalUrl "https://office.contoso.com" -CertificateName "Office Server Cert" -EditingEnabled:$true

En este ejemplo se crea una granja de Office Online Server en el servidor local que tiene la edición habilitada para Office en un explorador. En este ejemplo, solo se usa una única dirección URL para usuarios internos y externos. El valor nombre del certificado es el nombre descriptivo del certificado tal como aparece en el almacén de certificados del equipo.

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.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AllowOutboundHttp

Permite conexiones HTTP salientes desde Office Online Server.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ClipartEnabled

Permite la compatibilidad con la inserción de imágenes de Bing 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.

Para que las imágenes de Bing funcionen, el parámetro OpenFromUrlEnabled debe estar establecido en True. El valor predeterminado es False.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EditingEnabled

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ExcelCachingUnusedFiles

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ExcelDefaultWorkbookCalcMode

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

Type:DefaultWorkbookCalcMode
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ExcelUdfsAllowed

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-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 aceptados: -1 (no hay máximo); desde 1 a través de 34560 (24 días). El valor predeterminado es -1.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ExcelUseEffectiveUserName

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ExcelWarnOnDataRefresh

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-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 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, establecida mediante ExternalURL o InternalURL. También puede establecer URL tanto internas como externas.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

Suprime cualquier mensaje de usuario al responder Sí.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InternalURL

Especifica la raíz de dirección URL que los clientes usan 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, establecida mediante ExternalURL o InternalURL. También puede establecer URL tanto internas como externas.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-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 75 MB.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-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. El valor predeterminado es False.

Debe establecer este parámetro en True cuando use ClipartEnabled.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RecycleActiveProcessCount

Especifica el número de archivos que un único 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.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RenderingLocalCacheLocation

Especifica la ubicación de la memoria caché temporal para que la usen Los servicios de visualización de Word y PowerPoint.

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-S2SCertificateName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-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 URL de HTTPS para dichas referencias.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False