Condividi tramite


Install-SPWebPartPack

Installa il pacchetto web part specificato nella posizione specificata.

Sintassi

UseFileName

Install-SPWebPartPack
    [-LiteralPath] <String>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Force]
    [-GlobalInstall]
    [-Language <UInt32>]
    [-WebApplication <SPWebApplicationPipeBind>]
    [-WhatIf]
    [-CompatibilityLevel <String>]
    [<CommonParameters>]

UseName

Install-SPWebPartPack
    [-Name] <String>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Force]
    [-GlobalInstall]
    [-Language <UInt32>]
    [-WebApplication <SPWebApplicationPipeBind>]
    [-WhatIf]
    [-CompatibilityLevel <String>]
    [<CommonParameters>]

Descrizione

Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.

Il cmdlet Install-SPWebPartPack installa nella farm locale il pacchetto web part disponibile nel percorso specificato dal parametro LiteralPath. È possibile installare il pacchetto web part in un'applicazione Web specifica utilizzando il parametro WebApplication. Se non si specifica un'applicazione Web, il pacchetto web part verrà installato in tutte le applicazioni Web.

Utilizzare il parametro Language per specificare una lingua per il pacchetto.

Utilizzare il parametro GlobalInstall per installare il pacchetto nella Global Assembly Cache (GAC). Agli assembly nella Global Assembly Cache viene concessa l'autorizzazione FullTrust, in modo da consentire al pacchetto l'accesso completo alle risorse di tutto il sistema.

Utilizzare il parametro Force per installare il pacchetto e sovrascrivere qualsiasi pacchetto web part eventualmente esistente con lo stesso nome o installato nello stesso percorso.

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

Install-SPWebPartPack "MyCustomWebPartPack" -LiteralPath "C:\mywebpart.wpp" -GlobalInstall

Questo esempio consente di installare il pacchetto web part MyCustomWebPartPack globalmente nella farm dal percorso c:/mywebpart.wpp.

Parametri

-AssignmentCollection

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

-CompatibilityLevel

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica la versione dei modelli da utilizzare durante la creazione di un nuovo oggetto SPSite. Questo valore consente di impostare il valore CompatibilityLevel iniziale per la raccolta siti. Se questo parametro non viene specificato, come CompatibilityLevel verrà utilizzata per impostazione predefinita la versione più alta possibile per l'applicazione Web in base all'impostazione SiteCreationMode.

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

-Confirm

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

-Force

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Sovrascrive qualsiasi pacchetto web part eventualmente esistente con lo stesso nome o installato nello stesso percorso.

Proprietà dei parametri

Tipo:SwitchParameter
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

-GlobalInstall

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Installa il pacchetto web part nella Global Assembly Cache (GAC) anziché nella directory /bin di ogni applicazione Web. Questo tipo di installazione rende il pacchetto web part accessibile globalmente nei server.

Proprietà dei parametri

Tipo:SwitchParameter
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

-Language

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica l'ID di lingua per il pacchetto web part.

Proprietà dei parametri

Tipo:UInt32
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

-LiteralPath

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il percorso esatto del pacchetto web part.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UseFileName
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il nome del pacchetto web part da installare.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UseName
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WebApplication

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica l'applicazione Web in cui installare il pacchetto web part. Se non viene specificata alcuna applicazione Web, il pacchetto web part verrà installato in tutte le applicazioni Web.

Proprietà dei parametri

Tipo:SPWebApplicationPipeBind
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

-WhatIf

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.