Compartir a través de


New-SPExcelServiceApplication

Crea una nueva instancia de la aplicación de Servicios de Excel.

Sintaxis

ExistingTargetApplicationParameterSet

New-SPExcelServiceApplication
    -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
    [-Name <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-Default]
    [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
    [-ExternalDataConnectionLifetime <Int32>]
    [-FileAccessMethod <FileAccessMethod>]
    [-LoadBalancingScheme <LoadBalancingScheme>]
    [-MemoryCacheThreshold <Int32>]
    [-PrivateBytesMax <Int32>]
    [-SessionsPerUserMax <Int32>]
    [-SiteCollectionAnonymousSessionsMax <Int32>]
    [-TerminateProcessOnAccessViolation]
    [-ThrottleAccessViolationsPerSiteCollection <Int32>]
    [-UnattendedAccountApplicationId <String>]
    [-UnusedObjectAgeMax <Int32>]
    [-WhatIf]
    [-WorkbookCache <String>]
    [-WorkbookCacheSizeMax <Int32>]
    [-UseEffectiveUserName]
    [-WorkbookModelUsageTracker <String>]
    [<CommonParameters>]

NewTargetApplicationParameterSet

New-SPExcelServiceApplication
    -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
    [-Name <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-Default]
    [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
    [-ExternalDataConnectionLifetime <Int32>]
    [-FileAccessMethod <FileAccessMethod>]
    [-LoadBalancingScheme <LoadBalancingScheme>]
    [-MemoryCacheThreshold <Int32>]
    [-PrivateBytesMax <Int32>]
    [-SessionsPerUserMax <Int32>]
    [-SiteCollectionAnonymousSessionsMax <Int32>]
    [-TerminateProcessOnAccessViolation]
    [-ThrottleAccessViolationsPerSiteCollection <Int32>]
    [-UnusedObjectAgeMax <Int32>]
    [-WhatIf]
    [-WorkbookCache <String>]
    [-WorkbookCacheSizeMax <Int32>]
    [-UnattendedServiceAccount <PSCredential>]
    [-UseEffectiveUserName]
    [-WorkbookModelUsageTracker <String>]
    [<CommonParameters>]

Description

El New-SPExcelServiceApplication cmdlet crea una nueva aplicación de servicio web de aplicación Excel Services con una nueva configuración. Después de crear una nueva aplicación de servicio web de aplicación Excel Services, puede usar el Set-SPExcelServiceApplication cmdlet para modificar la configuración global de la nueva aplicación.

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

EJEMPLO 1

New-SPExcelServiceApplication -Name "MyExcelService" -ApplicationPool "SharePoint Services"

En este ejemplo se crea una nueva instancia de Excel Services Application con el nombre para mostrar MyExcelService.

EJEMPLO 2

New-SPExcelServiceApplication -Name "My Excel Service" -ApplicationPool "SharePoint Services" -SessionsPerUserMax 5

En este ejemplo se crea una nueva instancia de Excel Services Application con el nombre para mostrar My Excel Service y solo se permiten cinco sesiones por usuario para cada equipo del servidor de aplicaciones back-end que ejecuta Excel Services Application.

Parámetros

-ApplicationPool

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica el grupo de aplicaciones de IIS para ejecutar el servicio web de la nueva aplicación de Excel Services.

El tipo debe ser un objeto SPIisWebServiceApplicationPool válido.

Propiedades del parámetro

Tipo:SPIisWebServiceApplicationPoolPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AssignmentCollection

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

Propiedades del parámetro

Tipo:SPAssignmentCollection
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CachingOfUnusedFilesEnable

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica que los archivos que ya no usan Excel Services Application pueden permanecer en la memoria caché para su uso posterior. El valor predeterminado es true cuando el parámetro no se especifica en el comando.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CrossDomainAccessAllowed

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica que los elementos web o las páginas que residen en otros dominios HTTP pueden solicitar y representar archivos de conexiones de datos y libros de confianza.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Default

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica que el proxy de esta aplicación de servicio se agrega al grupo de proxy predeterminado del conjunto de servidores.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EncryptedUserConnectionRequired

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Requiere que se use el cifrado entre el usuario final y el servidor de aplicaciones de Excel Services. El ámbito de este ajuste es el servidor lógico. El valor predeterminado es None.

El tipo debe ser uno de los siguientes: None o Connection.

Propiedades del parámetro

Tipo:EncryptedConnectionMode
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ExternalDataConnectionLifetime

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica el número máximo de segundos que puede permanecer abierta una conexión de datos externos en el grupo de conexiones. Los valores válidos incluyen:

-1 Nunca reciclar

1 a 2073600 Permanecer activo de 1 segundo a 24 días.

El valor predeterminado es 1800.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FileAccessMethod

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica el método de autenticación que Excel Services Application usa para recuperar archivos. UseFileAccessAccount especifica que todos los libros siempre usan las credenciales de la cuenta de servicio que ejecuta Excel Services Application. UseImpersonation especifica que Excel Services Application recupera los archivos del libro como el usuario que realiza la solicitud. El valor predeterminado es UseImpersonation.

El tipo debe ser uno de los siguientes: UseImpersonation o UseFileAccessAccount.

Propiedades del parámetro

Tipo:FileAccessMethod
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-LoadBalancingScheme

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica el esquema de equilibrio de carga que usa la aplicación de servicio web de aplicación de Excel Services para enviar solicitudes a distintos equipos back-end que ejecutan Excel Calculation Services. El valor predeterminado es WorkbookURL.

El tipo debe ser uno de los siguientes: RoundRobin, Local o WorkbookURL.

Propiedades del parámetro

Tipo:LoadBalancingScheme
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MemoryCacheThreshold

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica el porcentaje de bytes privados máximos que se pueden asignar a objetos inactivos. Cuando se supera el umbral de la memoria caché, se liberan los objetos almacenados en la memoria caché que actualmente no están en uso. Al ajustar este valor en 0 se deshabilita el almacenamiento de objetos inactivos en la memoria caché. El valor predeterminado es 90.

El tipo debe ser un número entero entre 0 y 95.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica un nombre descriptivo para la nueva aplicación de servicio web de aplicación Excel Services. El nombre que use debe ser un nombre único de una aplicación de servicio web de aplicación Excel Services que se encuentra en esta granja de servidores. El nombre puede tener 128 caracteres como máximo. El valor predeterminado es Servicio_número_de_aplicaciones+1.

El tipo debe ser una cadena válida; por ejemplo, MiAplicaciónExcelService1.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PrivateBytesMax

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica el número máximo de bytes privados, en megabytes, que usa Excel Services Application. Cuando está establecido en -1, el valor de bytes privados máximos se ajusta en 50 por ciento de memoria física de forma predeterminada en el equipo. Los valores válidos incluyen -1 (sin límite) y cualquier número entero positivo. El valor predeterminado es -1.

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SessionsPerUserMax

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica el número máximo de sesiones permitido para un usuario. Si un usuario alcanza este máximo, la sesión más antigua se eliminará al iniciar una nueva sesión. Los valores válidos incluyen -1 (sin límite) y cualquier número entero positivo. El valor predeterminado es 25.

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

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SiteCollectionAnonymousSessionsMax

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica el número máximo de sesiones anónimas que se permite por colección de sitios. Un valor de 0 especifica que no se permiten sesiones anónimas. Los valores válidos incluyen -1 (sin límite), 0 para deshabilitar el ajuste o cualquier número entero positivo. El valor predeterminado es 25.

El tipo debe ser -1, 0 o cualquier número entero positivo.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TerminateProcessOnAccessViolation

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Finaliza Excel Services aplicación cuando se produce una infracción de acceso en el proceso.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ThrottleAccessViolationsPerSiteCollection

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica que si un libro produce un error de infracción de acceso en Excel Services Aplicación, todos los archivos que se originan en la colección de sitios de ese libro no se cargan durante el período especificado (en segundos). No se afectan las sesiones existentes de archivos en esa colección de sitios. Los valores válidos incluyen 0 para deshabilitar el ajuste y entre 1 a 2073600 segundos (24 días). El valor predeterminado es 0.

El tipo debe ser un valor entero entre 0 y 2073600.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UnattendedAccountApplicationId

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica el identificador de aplicación que se usa para buscar las credenciales de cuenta de servicio desatendida del servicio de almacén seguro especificado por UnattendedAccountSecureServiceAppName. El servicio de almacén seguro se contacta cuando este parámetro está establecido y se generan casos de error específicos. Los valores válidos son cadenas alfanuméricas con un máximo de 256 caracteres. El valor predeterminado es una cadena vacía.

El tipo debe ser una cadena válida de caracteres alfanuméricos; por ejemplo, IDCuentaServicioDesatendido.

La cuenta desatendida es una sola cuenta que pueden usar todos los libros para actualizar datos. Cuando las conexiones de libro especifican None para la autenticación o cuando se usan credenciales que no pertenecen a Windows para actualizar datos, requiere una cuenta desatendida.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ExistingTargetApplicationParameterSet
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UnattendedServiceAccount

Aplicable: SharePoint Server 2010, SharePoint Server 2013

{{Fill UnattendedServiceAccount Description}}

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

NewTargetApplicationParameterSet
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UnusedObjectAgeMax

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica una cantidad de tiempo máxima en minutos para conservar en la memoria caché los objetos que actualmente no están en uso en una sesión. Los valores máximos incluyen -1 (sin valor máximo) y un número entero positivo entre 1 y 34560 minutos (24 días). El valor predeterminado es -1.

El tipo debe ser -1 o un número entero entre 1 y 34560

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UseEffectiveUserName

Aplicable: SharePoint Server 2010, SharePoint Server 2013

{{Fill UseEffectiveUserName Description}}

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: SharePoint Server 2010, SharePoint Server 2013

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WorkbookCache

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica la ubicación del sistema de archivos local de la memoria caché que se usa para almacenar los libros usados por Excel Services Application.

Si no hay un valor especificado, el valor predeterminado es un subdirectorio del directorio temporal del sistema.

El tipo debe ser una ruta válida con alguna de las siguientes formas:

-- C:\folder_name -- \\server_name\folder_name

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WorkbookCacheSizeMax

Aplicable: SharePoint Server 2010, SharePoint Server 2013

Especifica el tamaño máximo admisible, en megabytes, de una sesión individual. El valor predeterminado es 0.

El tipo debe ser cualquier entero positivo.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WorkbookModelUsageTracker

Aplicable: SharePoint Server 2010, SharePoint Server 2013

{{Fill WorkbookModelUsageTracker Description}}

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.