Set-SPExcelServiceApplication
Establece las propiedades globales para la aplicación de Servicios de Excel.
Syntax
Set-SPExcelServiceApplication
[[-Identity] <SPExcelServiceApplicationPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-CachingOfUnusedFilesEnable]
[-Confirm]
[-CrossDomainAccessAllowed]
[-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>] Set-SPExcelServiceApplication
[[-Identity] <SPExcelServiceApplicationPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-CachingOfUnusedFilesEnable]
[-Confirm]
[-CrossDomainAccessAllowed]
[-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 Set-ExcelServiceApplication cmdlet cambia las propiedades del entorno de ejecución global para Excel Services Application.
Los cambios en las propiedades que se realizan mediante este cmdlet afectan a todas las máquinas de la granja de servidores que ejecutan una instancia de la aplicación de servicio web de aplicación Excel Services especificada.
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------------
$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -SessionsPerUserMax 10En este ejemplo se establece la aplicación Excel Services para permitir que cada usuario no abra más de 10 sesiones a la vez en un servidor de aplicaciones back-end que ejecuta Excel Services Application.
--------------EJEMPLO 2------------
$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -PrivateBytesMax -1En este ejemplo se establece el número máximo de bytes privados de memoria en el equipo en un valor de -1, lo que indica que Excel Services Application consumirá el 50 por ciento de los recursos de memoria disponibles.
Parámetros
-AssignmentCollection
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.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-CachingOfUnusedFilesEnable
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-CrossDomainAccessAllowed
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-EncryptedUserConnectionRequired
Requiere que se use el cifrado entre el usuario final y el servidor que ejecuta Excel Services Application. 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.
| Type: | EncryptedConnectionMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ExternalDataConnectionLifetime
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 admitidos son:
-1 Nunca reciclar
1 a 2073600 Permanecer activo de 1 segundo a 24 días.
El valor predeterminado es 1800.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-FileAccessMethod
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.
| Type: | FileAccessMethod |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Identity
Especifica el objeto SPExcelServiceApplication para actualizar.
El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh; un nombre válido de una aplicación de servicio web de aplicación de Excel Services en la granja de servidores (por ejemplo, MyExcelService1); o una instancia de un objeto SPExcelServiceApplication válido.
| Type: | SPExcelServiceApplicationPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-LoadBalancingScheme
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 diferentes equipos de back-end Excel Services Application. El valor predeterminado es WorkbookURL.
El tipo debe ser uno de los siguientes: RoundRobin, Local o WorkbookURL.
| Type: | LoadBalancingScheme |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-MemoryCacheThreshold
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-PrivateBytesMax
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-SessionsPerUserMax
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 elimina 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-SiteCollectionAnonymousSessionsMax
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-TerminateProcessOnAccessViolation
Finaliza Excel Services aplicación cuando se produce una infracción de acceso en el proceso.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ThrottleAccessViolationsPerSiteCollection
Especifica que si un libro produce un error de infracción de acceso en Excel Services Application, todos los archivos que se originen en la colección de sitios de ese libro no se cargarán 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UnattendedAccountApplicationId
Especifica el identificador de aplicación que se usa para buscar las credenciales de cuenta de servicio desatendida del servicio de almacenamiento seguro especificado por el parámetro UnattendedAccountSecureServiceAppName. El servicio de almacenamiento 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UnattendedServiceAccount
La cuenta de servicio desatendida es una única cuenta que todos los libros pueden usar para actualizar datos. Esta cuenta es necesaria para actualizar los datos cuando las conexiones del libro especifican "Usar la cuenta de servicio desatendida" sin usar credenciales de Windows.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013 |
-UnusedObjectAgeMax
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
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UseEffectiveUserName
La propiedad UseEffectiveUserName es una alternativa a la delegación de Windows para permitir que los usuarios accedan de forma segura a los datos de Analysis Services.
La configuración solo afectará a las conexiones de datos externos basadas en conexiones de libro de Analysis Services con una configuración de autenticación de "Usar la cuenta del usuario autenticado".
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013 |
-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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WorkbookCache
Especifica la ubicación del sistema de archivos local de la memoria caché que se usa para almacenar los libros que usa 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
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WorkbookCacheSizeMax
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WorkbookModelUsageTracker
{{Fill WorkbookModelUsageTracker Description}}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013 |