Set-SPExcelDataConnectionLibrary

Referencia

Módulo:: SharePointServer

Se aplica a:: SharePoint Server 2010, SharePoint Server 2013

Establece las propiedades de una biblioteca de conexiones de datos para la aplicación de Servicios de Excel.

Syntax

Set-SPExcelDataConnectionLibrary
   [-Identity] <SPExcelDCLPipeBind>
   -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
   [-Address <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Description <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

El Set-SPExcelDataConnectionLibrary cmdlet establece las propiedades de una biblioteca desde la que Excel Services Application carga los archivos de conexión de datos. Excel Services Aplicación carga los archivos de conexión de datos solo si se almacenan en una biblioteca de conexiones de datos que se encuentra en la lista de bibliotecas de conexión de datos de confianza. DLas bibliotecas de conexiones de datos constituyen un tipo de lista que contiene archivos de conexión de datos. Estos archivos contienen todo lo que Excel Services Application y el cliente de Excel necesitan para conectarse a un origen de datos externo. Las bibliotecas de conexiones de datos permiten volver a usar y compartir conexiones de datos. Las conexiones de datos se pueden cargar usando información del archivo del libro. Sin embargo, al usar una biblioteca de conexiones de datos para cargar conexiones de datos se genera una capa adicional para las mismas de modo que se puedan administrar independientemente de los libros.

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" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "https://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Description "This is the DCL where all the connections to the sales data are stored

En este ejemplo se establece una descripción para mostrar para la entrada https://portal/site/salesDCL de la lista de bibliotecas de conexión de datos de confianza (DCL) que se encuentra en la aplicación de servicio web de aplicación Excel Services denominada MyExcelService.

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

Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "https://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Address "https://portal/site/salesDCL

En este ejemplo se actualiza la dirección de la biblioteca de conexiones de datos para la entrada https://portal/test/site/salesDCL a https://portal/site/salesDCL en la lista de bibliotecas de conexión de datos de confianza, que se encuentra en la aplicación de servicio web de aplicación Excel Services denominada MyExcelService.

Parámetros

-Address

Especifica la dirección de la biblioteca de conexiones de datos. La dirección debe ser única en la lista de biblioteca de conexiones de datos de confianza.

El tipo debe ser una dirección URL válida, en el formulario https://server_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

-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

-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

-Description

Especifica una descripción simplificada de la biblioteca de conexiones de datos.

El tipo debe ser una cadena válida; por ejemplo, “Ésta es la biblioteca de conexiones de datos donde se almacenan todas las conexiones a los datos de ventas”.

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

-ExcelServiceApplication

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

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

-Identity

Especifica el objeto DataConnectionLibrary para actualizar.

El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh; un nombre válido de una biblioteca de conexiones de datos (por ejemplo, DataConnectionLib1); una dirección URL válida, con el formato https://server_name; o una instancia de un objeto SPExcelDCL válido.

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