New-SPExcelDataConnectionLibrary
Aggiunge una nuova raccolta connessioni dati all'applicazione Excel Services.
Sintassi
Default (Impostazione predefinita)
New-SPExcelDataConnectionLibrary
-Address <String>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Il New-SPExcelDataConnectionLibrary cmdlet aggiunge una raccolta connessioni dati all'elenco delle raccolte connessioni dati attendibili per un'applicazione del servizio Web di un'applicazione del servizio Web di un'applicazione di Excel Services.
Applicazione Excel Services carica solo i file di connessione dati archiviati in una raccolta connessioni dati presente nell'elenco delle raccolte connessioni dati attendibili.
Le raccolte connessioni dati contengono file di connessione dati, che contengono tutte le risorse necessarie all'applicazione Excel Services e al client Excel 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 raccolta 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 raccolta connessioni dati (DCL) e quindi la relativa descrizione viene impostata sull'elenco di raccolte connessioni dati attendibili nell'applicazione del servizio Web dell'applicazione di Excel Services denominata MyExcelService.
Le cartelle di lavoro possono utilizzare i file di connessione archiviati in tale raccolta per aggiornare i dati nell'applicazione del servizio Web dell'applicazione Excel Services Application.
Parametri
-Address
Applicabile: SharePoint Server 2010, SharePoint Server 2013
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AssignmentCollection
Applicabile: SharePoint Server 2010, SharePoint Server 2013
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.
Proprietà dei parametri
| Tipo: | SPAssignmentCollection |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Applicabile: SharePoint Server 2010, SharePoint Server 2013
Richiede la conferma prima di eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Description
Applicabile: SharePoint Server 2010, SharePoint Server 2013
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ExcelServiceApplication
Applicabile: SharePoint Server 2010, SharePoint Server 2013
Specifica l'applicazione del servizio Web dell'applicazione di Excel Services 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 di Excel Services nella farm, ad esempio MyExcelService1 oppure un'istanza di un oggetto SPExcelServiceApplication valido.
Proprietà dei parametri
| Tipo: | SPExcelServiceApplicationPipeBind |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: SharePoint Server 2010, SharePoint Server 2013
Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.