Compartir a través de

New-SPExcelFileLocation

  • Referencia
Módulo:
SharePointServer
Se aplica a:
SharePoint Server 2010, SharePoint Server 2013

Agrega una nueva ubicación de confianza a la aplicación de Servicios de Excel.

Syntax

New-SPExcelFileLocation
   -Address <String>
   -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
   [-AbortOnRefreshOnOpenFail]
   [-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 New-SPExcelFileLocation cmdlet agrega una nueva ubicación a la lista de ubicaciones de archivos de confianza en una aplicación de servicio web de aplicación Excel Services. 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 que usa 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.

La coincidencia más larga tiene prioridad. Por ejemplo, si https://portal/site/ y https://portal/site/subsite son ubicaciones de confianza y carga un libro desde el subsitio, la aplicación usa las propiedades de la ubicación de confianza del subsitio porque tiene la dirección coincidente más larga.

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-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "https://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$false

En este ejemplo se agrega una nueva ubicación de archivo de confianza a la lista de ubicaciones de archivos de confianza que se encuentra en la aplicación de servicio web de aplicación Excel Services denominada MyExcelService.

Este ejemplo permite que los libros se carguen desde cualquier elemento secundario o subcarpeta que comience por https://myPortal/myTeam. Todos los libros cargados desde esta ubicación deben tener un tamaño inferior a 50 megabytes (MB). Los libros pueden actualizar datos externos usando conexiones incrustadas en el archivo del libro o almacenadas en una biblioteca de conexiones de datos. No se mostrará un mensaje de advertencia indicando que el libro está intentando actualizar datos externos.

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

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address https://myPortal/myTeam/managers -locationType SharePoint -description "This is the manager's subsite for myTeam."

En este ejemplo se agrega una nueva ubicación de archivo de confianza a la lista de ubicaciones de archivos de confianza que se encuentra en la aplicación de servicio web de aplicación Excel Services denominada MyExcelService con una dirección y una descripción dadas.

Parámetros

-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 de productos y tecnologías de SharePoint para el archivo.
  • El archivo de libro tiene conexiones de datos que se actualizan automáticamente cuando se abre el archivo de aplicación de Excel Services.
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

-Address

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, en el formulario https://myPortal/myTeam; o una ruta de acceso UNC válida en forma, \\server_name\folder_name

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

-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

-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 Calcula una vez cuando se carga el libro.

0 Calcula siempre.

De 1 a 2073600 cachés de 1 segundo a 24 días. El valor de número entero predeterminado es 300.

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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ChartRenderDurationMax

{{Fill ChartRenderDurationMax Description}}

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

-ConcurrentDataRequestsPerSessionMax

Especifica en número máximo de solicitudes de datos externos concurrentes que se permite en cada sesión. Si una sesión debe asignar más solicitudes que este número, se deben situar solicitudes adicionales en cola. El ámbito de este ajuste es el servidor lógico. El valor predeterminado es 5.

El tipo debe ser un 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

-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

-DefaultWorkbookCalcMode

Especifica el modo de cálculo de los libros. Todos los ajustes excepto File invalidan los ajustes del libro. 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
Required:False
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
Required:False
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
Required:False
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
Required:True
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. None 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 cualquiera de los siguientes ajustes:

Ninguno

Dcl

DclAndEmbedded

Type:AllowExternalData
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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 del archivo de confianza es https://portal e IncludeChildren es true, https://portal/subSite también es de confianza, al igual que cualquier dirección URL subordinada a la dirección URL especificada en Dirección.

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

-LocationType

Especifica el tipo de ubicación. El tipo de ubicación indica cómo Excel Services Application recupera los archivos de la ubicación especificada en Dirección. El ajuste predeterminado es el tipo SharePoint. El valor predeterminado es SharePoint.

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

Type:LocationType
Position:Named
Default value:None
Required:False
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 emite una solicitud de datos externa manual o iniciada por el usuario. 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. El valor predeterminado es 300.

Los valores válidos son todos los siguientes elementos:

-1: no actualizar nunca después de la primera consulta. 1 a 2073600: almacenar en la memoria caché de 1 segundo a 24 días.

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

-NewWorkbookSessionTimeout

Especifica el tiempo, en segundos, que una sesión de un nuevo libro, sin guardar, permanece activa en Excel Services Aplicación sin 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 permanece activo de 1 segundo a 24 días. El valor predeterminado es 1800.

El tipo debe ser -1, 0 o un número entero entre 1 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

-PeriodicExtDataCacheLifetime

Especifica el tiempo, en segundos, que Excel Services aplicación espera antes de volver a emite 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 de -1 especifica que nunca se actualice después de la primera consulta. El valor predeterminado es 300.

El tipo debe ser -1, 0 o un número entero entre 1 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

-RequestDurationMax

Especifica la duración máxima, en segundos, para una única solicitud en una sesión. Una vez transcurrido este tiempo, se agota el tiempo de espera de la solicitud. El valor predeterminado es 300.

El tipo debe ser -1 (sin límite) o un número entero entre 1 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

-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 ExternalDataAllowed está ajustado en None.

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

-SessionTimeout

Especifica el tiempo, en segundos, que una sesión permanece activa en Excel Services aplicación sin actividad de usuario. Valores válidos:

-1 La sesión nunca expira.

La sesión 0 expira al final de una sola solicitud.

De 1 a 2073600 permanece activo de 1 segundo a 24 días. El valor predeterminado es 300.

El tipo debe ser -1, 0 o un número entero entre 1 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

-ShortSessionTimeout

Especifica el tiempo en segundos que tiene un usuario para hacer la interacción inicial con una hoja de cálculo. Una vez transcurrido ese período, si el usuario no está activo, se cierra la sesión. El valor siempre debe ser menor que el de SessionTimeout. Si el valor de ShortSessionTimeout es mayor o igual que SessionTimeout, se devuelve un error. El valor predeterminado es 75.

El tipo debe ser -1 o un número entero entre 1 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

-UdfsAllowed

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

El valor predeterminado es False.

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

-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
Required:False
Accept pipeline input:False
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013