Set-SPExcelDataConnectionLibrary

Riferimento

Modulo:: SharePointServer

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

Imposta le proprietà di una raccolta connessioni dati per l'applicazione Excel Services.

Sintassi

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

Descrizione

Il Set-SPExcelDataConnectionLibrary cmdlet imposta le proprietà di una libreria da cui Excel Services'applicazione carica i file di connessione dati. Excel Services'applicazione carica i file di connessione dati solo se vengono archiviati in una libreria di connessione dati inclusa nell'elenco delle librerie di connessioni dati attendibili. Le raccolte di connessioni dati costituiscono un tipo di elenco contenente i file di connessione dati. Questi file contengono tutto ciò 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 utilizzando le informazioni contenute nei file delle cartelle di lavoro. Tuttavia, se si utilizza una raccolta di connessioni dati per caricare le connessioni dati, si dispone di un ulteriore livello per le connessioni dati, che in questo modo potranno essere gestite separatamente rispetto alle 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 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

In questo esempio viene impostata una descrizione visualizzata per la voce https://portal/site/salesDCL nell'elenco delle librerie di connessione dati attendibili (DCL) nell'applicazione del servizio Web applicazione Excel Services denominata MyExcelService.

---------------ESEMPIO 2 --------------

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

In questo esempio viene aggiornato l'indirizzo della libreria di connessione dati per la voce https://portal/test/site/salesDCL nell'elenco https://portal/site/salesDCL delle librerie di connessione dati attendibili, che si trova nell'applicazione del servizio Web applicazione Excel Services denominata MyExcelService.

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:	False
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 "Questa è la raccolta connessioni dati in cui sono archiviate tutte le connessioni ai dati sulle vendite".

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

-Identity

Specifica l'oggetto DataConnectionLibrary da aggiornare.

Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh; un nome valido di una libreria di connessione dati ,ad esempio DataConnectionLib1; UN URL valido, nel formato https://server_name, o un'istanza di un oggetto SPExcelDCL valido.

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

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

Condividi tramite