Install-SPSolution

Riferimento

Modulo:: sharepoint-server

Si applica a:: SharePoint Server Subscription Edition

Distribuisce nella farm una soluzione SharePoint installata.

Sintassi

Install-SPSolution
       [-Identity] <SPSolutionPipeBind>
       [-AllWebApplications]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-CASPolicies]
       [-CompatibilityLevel <String>]
       [-Confirm]
       [-Force]
       [-FullTrustBinDeployment]
       [-GACDeployment]
       [-Language <UInt32>]
       [-Local]
       [-Time <String>]
       [-WebApplication <SPWebApplicationPipeBind>]
       [-WhatIf]
       [<CommonParameters>]

Install-SPSolution
       [[-Identity] <SPSolutionPipeBind>]
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Language <UInt32>]
       [-Synchronize]
       [-WhatIf]
       [<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 di cmdlet (https://learn.microsoft.com/powershell/scripting/developer/cmdlet/cmdlet-parameter-sets?view=powershell-5.1).

Il cmdlet Install-SPSolution distribuisce nella farm una soluzione SharePoint installata. Utilizzare il cmdlet Add-SPSolution per installare un pacchetto della soluzione SharePoint nella farm.

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

Install-SPSolution -Identity contoso_solution.wsp -GACDeployment

In questo esempio la soluzione SharePoint installata denominata contoso_solution.wsp viene distribuita nella farm e viene specificato che per la nuova soluzione SharePoint può essere distribuita la Global Assembly Cache.

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

Install-SPSolution -Identity contoso_solution.wsp -GACDeployment -CompatibilityLevel {14,15}

In questo esempio viene distribuita la soluzione SharePoint installata e viene installata una soluzione aggiunta in precedenza in modo che possa essere utilizzata correttamente nelle raccolte siti sia in modalità 14 sia in modalità 15.

Parametri

-AllWebApplications

Specifica che la nuova soluzione SharePoint deve essere distribuita per tutte le applicazioni Web di SharePoint della farm.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

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

-CASPolicies

Specifica che i criteri di sicurezza dall'accesso di codice possono essere distribuiti per la nuova soluzione SharePoint.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-CompatibilityLevel

Specifica se effettuare l'installazione nella soluzione, in una directory della versione specifica in base al valore di CompatibilityLevel. Se il parametro non viene specificato, il comportamento predefinito prevede che l'installazione della soluzione venga effettuata solo nella directory della versione in base alla versione registrata nel manifesto del file cab della soluzione.

I valori validi sono:

--14

--15

--14,15

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

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

-Force

Impone la distribuzione della nuova soluzione SharePoint.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-FullTrustBinDeployment

Specifica che è autorizzata la distribuzione bin con attendibilità totale. Questo parametro deve essere utilizzato se la soluzione è completamente attendibile.

L'assembly bin è un assembly installato nella directory bin del server virtuale. L'assembly nel pacchetto avrà il set di attributi DeploymentTarget=WebApplication. Per altre informazioni sull'assembly bin, vedere Elemento assembly

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-GACDeployment

Specifica che la Global Assembly Cache può essere distribuita per la nuova soluzione SharePoint.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Identity

Specifica la soluzione SharePoint da distribuire.

Il valore deve essere un GUID autentico, nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome autentico di una soluzione SharePoint, ad esempio SoluzioneSP1, o un'istanza di un oggetto SPSolution autentico.

Type:	SPSolutionPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Language

Specifica una lingua per la soluzione quando viene distribuito un Language Pack. Se il parametro non viene specificato, verrà utilizzato il valore zero ("0"). Utilizzare zero per le soluzioni valide per tutte le lingue.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Local

Distribuisce la soluzione nel server attivo.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Synchronize

Sincronizza tutte le soluzioni oppure quella specificata nella farm locale.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Time

Specifica quando la soluzione verrà distribuita. Il valore predefinito corrisponde alla distribuzione immediata.

Il tipo deve essere un valore DateTime valido nel formato 2010, 5, 1.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WebApplication

Distribuisce la soluzione SharePoint per l'applicazione Web di SharePoint specificata.

Il valore deve essere espresso in uno dei formati seguenti:

--GUID autentico, nel formato 12345678-90ab-cdef-1234-567890bcdefgh

--Nome autentico di un'applicazione Web di SharePoint (ad esempio, MyOfficeApp1)

--Istanza di un oggetto SPWebApplication autenticato.

Type:	SPWebApplicationPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

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