Set-SPExcelFileLocation

Establece las propiedades de una ubicación de archivo de confianza para la aplicación de Servicios de Excel.

Syntax

Set-SPExcelFileLocation
   [-Identity] <SPExcelFileLocationPipeBind>
   -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
   [-AbortOnRefreshOnOpenFail]
   [-Address <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AutomaticVolatileFunctionCacheLifetime <Int32>]
   [-ChartAndImageSizeMax <Int32>]
   [-ConcurrentDataRequestsPerSessionMax <Int32>]
   [-Confirm]
   [-DefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
   [-Description <String>]
   [-DisplayGranularExtDataErrors]
   [-ExternalDataAllowed <AllowExternalData>]
   [-IncludeChildren]
   [-LocationType <LocationType>]
   [-ManualExtDataCacheLifetime <Int32>]
   [-NewWorkbookSessionTimeout <Int32>]
   [-PeriodicExtDataCacheLifetime <Int32>]
   [-RequestDurationMax <Int32>]
   [-RESTExternalDataAllowed]
   [-SessionTimeout <Int32>]
   [-ShortSessionTimeout <Int32>]
   [-UdfsAllowed]
   [-WarnOnDataRefresh]
   [-WhatIf]
   [-WorkbookSizeMax <Int32>]
   [-ChartRenderDurationMax <Int32>]
   [<CommonParameters>]

Description

El Set-SPExcelFileLocation cmdlet establece las propiedades de una ubicación desde la que Excel Services Application carga libros. Excel Services Application solo carga los libros almacenados en una ubicación de archivo de confianza. Las propiedades de las ubicaciones de archivos de confianza controlan cómo se pueden usar los libros cuando se cargan en Excel Services aplicación. Excel Services Application siempre aplica las propiedades definidas por la ubicación de archivo de confianza desde la que se cargó un libro. Las propiedades usadas por la ubicación de archivos de confianza se determinan comparando la ruta del archivo del libro con el parámetro Address de la ubicación de archivos de confianza.

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

Get-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed Dcl

En este ejemplo se obtienen todas las ubicaciones de archivos de confianza de la aplicación de servicio web de aplicación Excel Services denominada My Excel Service que permite que las conexiones de datos se carguen desde archivos de libro y especifica que las ubicaciones deben usar una biblioteca de conexiones de datos para cargar conexiones de datos.

--------------EJEMPLO 2------------

Get-SPExcelServiceApplication | Get-SPExcelFileLocation | where {$_.Address -eq "https://"} | Set-SPExcelFileLocation -Description "This is the default trusted file location for Excel Services Application. It allows any file from anywhere in SharePoint to load."

En este ejemplo se cambia la descripción de la ubicación de archivo predeterminada para cada aplicación de servicio web de aplicación Excel Services de la granja de servidores.

Parámetros

- AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-AbortOnRefreshOnOpenFail

Especifica que la carga de un archivo de aplicación de Excel Services produce un error automáticamente si se produce un error en una operación de actualización automática de datos cuando se abre el archivo. Se produce un error en la carga solo si las siguientes condiciones son verdaderas:

-- El usuario tiene permisos de solo lectura para el archivo de aplicación de Excel Services. -- El archivo del libro tiene conexiones de datos que se actualizan automáticamente cuando se abre el archivo de Excel.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Address

System.String

Especifica una carpeta web o directorio de archivos desde el que Excel Services Aplicación puede cargar libros.

El tipo debe ser una dirección URL válida, con el formato https://myPortal/myTeam; o una ruta de acceso UNC válida en forma, \\server_name\folder_name

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-AutomaticVolatileFunctionCacheLifetime

Especifica el tiempo máximo es segundos que se almacena en la memoria caché un valor computado para una función volátil con el fin de realizar nuevos cálculos automáticos. Los valores válidos incluyen:

-1: calcular una vez al cargar el libro

0: calcular siempre

1 a 2073600: almacenar en la memoria caché de 1 segundo a 24 días

El tipo debe ser los números enteros -1 o 0 o un valor entero entre 1 y 2073600

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ChartAndImageSizeMax

Especifica el tamaño máximo en megabytes de un gráfico o imagen que se puede abrir. El valor predeterminado es 1.

El tipo debe ser un número entero válido mayor que 0.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ChartRenderDurationMax

El tiempo máximo (en segundos) dedicado a representar cualquier gráfico único.

Valores válidos: -1 (sin límite); de 1 a 2073600 (24 días).

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ConcurrentDataRequestsPerSessionMax

Specifies the maximum number of concurrent external data requests allowed in each session. If a session must issue more than this number of requests, additional requests must be queued. The scope of this setting is the logical server. The default value is 5.

El tipo debe ser un entero positivo.

Type:Int32
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-DefaultWorkbookCalcMode

Especifica el modo de cálculo de los libros. Todos los ajustes excepto File invalidan los ajustes del libro. Si se cambia este parámetro, se aplica a todas las sesiones nuevas de Excel Services Application cuando se actualiza la caché de propiedades de ConfigDB. El valor predeterminado es File.

El tipo debe ser uno de los siguientes: File, Manual, Auto o AutoDataTables.

Type:DefaultWorkbookCalcMode
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Description

Especifica una descripción simplificada de la nueva ubicación del archivo.

El tipo debe ser una cadena válida; por ejemplo, "Ésta es la ubicación del archivo del informe de ventas mensuales".

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-DisplayGranularExtDataErrors

Muestra mensajes de error granulares para los archivos de esta ubicación con error en los datos externos.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ExcelServiceApplication

Especifica la aplicación de servicio web de aplicación Excel Services que contiene el objeto de lista SPExcelFileLocation.

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:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ExternalDataAllowed

Especifica el tipo de acceso a datos externos permitido para los libros: Ninguno especifica que la actualización de datos está deshabilitada. Dcl especifica que los datos se actualizan únicamente cuando usan un archivo de conexión en una Biblioteca de conexiones de datos de confianza. DclandEmbedded especifica que se puede usar una Biblioteca de conexiones de datos, aunque no es obligatoria. El ámbito de este valor es la ubicación de confianza.

El valor predeterminado es None.

El tipo debe ser uno de los siguientes: None, Dcl o DclAndEmbedded.

Type:AllowExternalData
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Identidad

Especifica el objeto FileLocation para actualizar. El nombre debe ser único en la lista de ubicaciones de archivos.

El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh; una cadena válida que identifica la ubicación del archivo, con el formato https://myPortal/myTeam; una cadena válida que identifica la ruta de acceso, con el formato C:\folder_name; o una instancia de un objeto SPExcelFileLocation válido.

Type:SPExcelFileLocationPipeBind
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-IncludeChildren

Indica que las direcciones URL subordinadas, directorios y bibliotecas son de confianza. Por ejemplo, si la ubicación de archivo de confianza es https://portaly IncludeChildren es true, https://portal/subSite también es de confianza, al igual que cualquier subURL en la dirección URL especificada en Dirección.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-LocationType

El tipo de ubicación. LocationType indica cómo Excel Services Application recupera los archivos de esa ubicación especificada en Dirección. El valor predeterminado es SharePoint.

El tipo debe ser uno de los siguientes: SharePoint, UNC o HTTP.

Type:LocationType
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ManualExtDataCacheLifetime

Especifica el tiempo, en segundos, que Excel Services aplicación espera antes de volver a emitir una solicitud de datos externa manual o iniciada por el usuario. Durante este período, es posible que se devuelvan los resultados de la solicitud de datos externos anterior de una memoria caché de datos externos.

Los valores admitidos son:

-1: no actualizar nunca después de la primera consulta

De 1 a 2073600 cachés de 1 segundo a 24 días.

El valor predeterminado es 300.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-NewWorkbookSessionTimeout

Especifica el tiempo, en segundos, que una sesión de un nuevo libro, sin guardar, permanecerá activa en Excel Services aplicación sin actividad de usuario. El valor predeterminado es 1800. Valores válidos:

-1, la sesión nunca expira

0, la sesión expira al final de una sola solicitud

1 a 2073600, permanece activo de 1 segundo a 24 días.

El tipo debe ser -1, 0 o un número entero entre 1 y 2073600.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-PeriodicExtDataCacheLifetime

Especifica el tiempo, en segundos, que Excel Services Aplicación espera antes de volver a emitir una solicitud de datos externa en abierto o periódica (es decir, automática). Durante este período, es posible que se devuelvan los resultados de la consulta de datos externos anterior de una memoria caché de datos externos. Un valor -1 especifica que nunca se actualice después de la primera consulta.

El tipo debe ser -1, 0 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
Applies to:SharePoint Server 2010, SharePoint Server 2013

-RequestDurationMax

Especifica la duración máxima en segundos de una sola solicitud en una sesión. Una vez transcurrido ese período, la solicitud supera el tiempo de espera.

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
Applies to:SharePoint Server 2010, SharePoint Server 2013

-RESTExternalDataAllowed

Especifica si las solicitudes de la interfaz de programación de aplicaciones (API) de Transferencia de estado de representación (REST, Representational state transfer) pueden actualizar conexiones de datos externos.

El parámetro RESTExternalDataAllowed no tiene efecto si el parámetro External DataAllowed está ajustado en None.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-SessionTimeout

Especifica el tiempo, en segundos, que una sesión permanecerá activa en Excel Services aplicación sin actividad de usuario. El valor predeterminado es 300 segundos. El valor predeterminado es 300. Los valores válidos son:

-1: la sesión nunca caduca

0, la sesión expira al final de una sola solicitud

1 a 2073600: permanece activa de 1 segundo a 24 días

El tipo debe ser -1, 0 o un número entero entre 1 y 2073600.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ShortSessionTimeout

Specifies the time, in seconds, that a user has to make the initial interaction with a spreadsheet. After this time has elapsed, if the user is not active, then the session is closed. The value must always be less than SessionTimeout. If the ShortSessionTimeout value is greater than or equal to SessionTimeout, an error is returned. The default value is 75.

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-UdfsAllowed

Especifica que las funciones definidas por el usuario pueden ser llamadas por libros cargados de la ubicación de confianza especificada en Address.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-WarnOnDataRefresh

Especifica que se muestre una advertencia para el usuario al actualizar los datos del libro por primera vez. El valor predeterminado es True.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-WorkbookSizeMax

Especifica el tamaño máximo en megabytes de un libro que se puede cargar. El valor predeterminado es 10.

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

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013