New-SPExcelDataProvider

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2010, SharePoint Server 2013

Aggiunge un nuovo provider di dati sicuro all'applicazione Excel Services.

Sintassi

New-SPExcelDataProvider
   -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
   -ProviderId <String>
   -ProviderType <DataProviderType>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Description <String>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Il New-SPExcelDataProvider cmdlet aggiunge un provider di dati all'elenco di provider di dati sicuri in un'applicazione del servizio Web applicazione Excel Services. Excel Services'applicazione aggiorna le connessioni dati esterne solo se il provider di dati per una connessione è presente nell'elenco dei provider di dati sicuri. Excel Services'applicazione include un set di provider di dati comuni in questo elenco. Pertanto, l'uso di cmdlet per modificare i provider di dati sicuri si verifica in genere solo in scenari di connessione dati personalizzati.

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" | New-SPExcelDataProvider -providerID "CustomOLEDB" -ProviderType OleDb -description "This is a custom OLEDB provider"

In questo esempio viene aggiunto un nuovo provider di dati OLEDB personalizzato all'elenco di provider di dati sicuri per l'applicazione del servizio Web applicazione Excel Services denominata MyExcelService.

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

Get-SPExcelServiceApplication | New-SPExcelDataProvider -providerID "CustomOLEDB" -ProviderType OleDb -description "This is a custom OLEDB provider"

In questo esempio viene aggiunto un nuovo provider di dati OLEDB personalizzato all'elenco di provider di dati sicuri per tutte le Excel Services'applicazione del servizio Web applicazione nella farm.

Parametri

-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 del nuovo provider di dati.

Il tipo deve essere una stringa valida, ad esempio “Questo è 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 l'Excel Services'applicazione del servizio Web Applicazione che contiene l'oggetto elenco SPExcelDataProvider.

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

-ProviderId

Specifica il nome del provider. Questo ID deve essere presente nelle stringhe di connessione generate dal provider e deve essere univoco per il tipo di provider.

Il tipo deve essere un nome valido di provider, ad esempio OLEDBPersonalizzato.

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

-ProviderType

Specifica il tipo supportato di provider di dati da aggiungere all'elenco dei provider attendibili.

Il tipo deve essere uno dei seguenti valori: OleDb, Odbc o OdbcDsn.

Type:DataProviderType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
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