New-SPExcelDataConnectionLibrary

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

Agrega una nueva biblioteca de conexiones de datos a la aplicación de Servicios de Excel.

Syntax

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

Description

El New-SPExcelDataConnectionLibrary cmdlet agrega una biblioteca de conexiones de datos a la lista de bibliotecas de conexión de datos de confianza para una aplicación de servicio web de aplicación Excel Services. Excel Services Application solo carga los archivos de conexión de datos almacenados en una biblioteca de conexiones de datos que se encuentra en la lista de bibliotecas de conexión de datos de confianza. Las bibliotecas de conexiones de datos contienen archivos de conexión de datos, que contienen todos los recursos que Excel Services Application y el cliente de Excel requieren 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, usar una biblioteca de conexiones de datos para cargar conexiones de datos permite administrarlas 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------------------

$sa = Get-SPExcelServiceApplication
New-SPExcelDataConnectionLibrary -Address "https://portal/site/salesDCL" -Description "This is the DCL where all the connections to the sales data are stored." -ExcelServiceApplication $sa

En este ejemplo se agrega una nueva biblioteca de conexiones de datos (DCL) y, a continuación, se establece su descripción 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.

Los libros pueden usar archivos de conexión almacenados en esa biblioteca para actualizar datos en la aplicación de servicio web de aplicación Excel Services.

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

-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, “Éste es un proveedor OLEDB personalizado”.

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

-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