New-SPExcelDataConnectionLibrary

Riferimento

Modulo:: SharePointServer

Si applica a:: SharePoint Server 2010, SharePoint Server 2013

Aggiunge una nuova raccolta connessioni dati all'applicazione Excel Services.

Sintassi

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

Descrizione

Il New-SPExcelDataConnectionLibrary cmdlet aggiunge una libreria di connessione dati all'elenco delle librerie di connessione dati attendibili per un'applicazione del servizio Web applicazione Excel Services. Excel Services'applicazione carica solo i file di connessione dati archiviati in una libreria di connessione dati inclusa nell'elenco delle librerie di connessioni dati attendibili. Le librerie di connessione dati contengono file di connessione dati, che contengono tutte le risorse che Excel Services'applicazione e il client Excel richiedono per connettersi a un'origine dati esterna. Le raccolte di connessioni dati consentono di riutilizzare e condividere le connessioni dati. Le connessioni dati possono essere caricate usando le informazioni del file della cartella di lavoro; Tuttavia, l'uso di una libreria di connessioni dati per caricare le connessioni dati consente di gestire le connessioni dati separatamente dalle cartelle di lavoro.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

------------------ESEMPIO------------------

$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

In questo esempio viene aggiunta una nuova libreria di connessione dati (DCL) e quindi viene impostata la relativa descrizione sull'elenco delle librerie di connessione dati attendibili che si trova nell'applicazione del servizio Web applicazione Excel Services denominata MyExcelService.

Le cartelle di lavoro possono usare i file di connessione archiviati in tale libreria per aggiornare i dati nell'applicazione del servizio Web applicazione Excel Services.

Parametri

-Address

Specifica l'indirizzo della raccolta di connessioni dati. L'indirizzo deve essere univoco nell'elenco delle raccolte di connessioni dati attendibili.

Il tipo deve essere un URL valido nel formato 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

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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

Specifica una descrizione per la raccolta di connessioni dati.

Il tipo deve essere una stringa valida. Ad esempio, si tratta di un provider OLEDB personalizzato.

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

Specifica la Excel Services'applicazione del servizio Web Application che contiene l'oggetto elenco SPExcelDataConnectionLibrary.

Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh; un nome valido di un'applicazione del servizio Web applicazione Excel Services nella farm (ad esempio MyExcelService1) o un'istanza di un oggetto SPExcelServiceApplication valido.

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

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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