Set-SPDataConnectionFile

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

Imposta le proprietà di un file di connessione dati.

Sintassi

Set-SPDataConnectionFile
   [-Identity] <SPDataConnectionFilePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Category <String>]
   [-Confirm]
   [-Description <String>]
   [-DisplayName <String>]
   [-WebAccessible <String>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Il Set-SPDataConnectionFile cmdlet imposta le proprietà del file di connessione dati specificato nel parametro Identity.

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

Set-SPDataConnectionFile -Identity "sample.udcx" -Category "Temp"

Questo esempio consente di aggiornare il campo Category del file .udcx specificato.

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

Set-SPDataConnectionFile -Identity "sample.udcx" -DisplayName "NewDisplayName"

Questo esempio consente di aggiornare il campo DisplayName del file .udcx specificato.

--------------ESEMPIO 3-----------------

Sample.udcx" | Set-SPDataConnectionFile -Category "Temp"

Questo esempio consente di aggiornare il campo Category del file .udcx specificato.

--------------ESEMPIO 4-----------------

Get-SPDataConnectionFile | where {$_.Category -eq "Category1"}  | Set-SPDataConnectionFile -Category "Category2"

In questo esempio viene aggiornato il campo Category per la raccolta di file con estensione udcx restituiti da una query usata dal Get-SPDataConnectionFile cmdlet .

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, SharePoint Server 2016, SharePoint Server 2019

-Category

Imposta una categoria arbitraria per il file, che può essere utilizzata per raggruppare i file. Il nome della categoria può essere composto da un massimo di 255 caratteri.

Il tipo deve essere un valore stringa valido, ad esempio Categoria1.

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, SharePoint Server 2016, SharePoint Server 2019

-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, SharePoint Server 2016, SharePoint Server 2019

-Description

Imposta la descrizione del file di connessione dati. Il nome può essere composto da un massimo di 4096 caratteri alfanumerici.

Il tipo deve essere una stringa valida, ad esempio Descrizione del file di connessione dati universale 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, SharePoint Server 2016, SharePoint Server 2019

-DisplayName

Specifica il nome visualizzato che descrive il file di connessione dati. Il nome può essere composto da un massimo di 255 caratteri.

Il tipo deve essere una stringa valida, ad esempio InfoPathUDC1.

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, SharePoint Server 2016, SharePoint Server 2019

-Identity

Specifica il file di connessione dati da aggiornare.

Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh; un nome valido di un file di connessione dati (ad esempio, DataConnectionFileName1.udcx); o un'istanza di un oggetto SPDataConnectionFile valido.

Type:SPDataConnectionFilePipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WebAccessible

Specifica che è possibile accedere al file di connessione dati universale tramite il servizio Web. Se il valore è false, i file di connessione dati universali potranno essere recuperati internamente solo da Forms Server. Il valore predefinito è False.

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, SharePoint Server 2016, SharePoint Server 2019

-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, SharePoint Server 2016, SharePoint Server 2019