Disable-SPFeature
Disattiva una caratteristica di SharePoint installata nell'ambito specificato.
Sintassi
Disable-SPFeature
[-Identity] <SPFeatureDefinitionPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Force]
[-Url <String>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Il cmdlet Disable-SPFeature disattiva una caratteristica di SharePoint nell'ambito specificato. Se l'ambito della caratteristica è la farm, l'URL non è necessario. In caso contrario, specificare l'URL della posizione in cui deve essere disattivata la caratteristica (non è necessario un ambito esplicito).
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-----------------
Disable-SPFeature -identity "MyCustom" -URL https://somesite
In questo esempio viene disabilitata la funzionalità con ambito del sito Web "MyCustom" all'indirizzo https://somesite.
--------------ESEMPIO 2-----------------
$w = Get-SPWeb https://somesite/myweb | ForEach{ $_.URL }
Get-SPFeature -Web $w | ForEach-Object { Disable-SPFeature -Identity $_ -URL $w}
Questo esempio disabilita tutte le funzionalità nel sito secondario all'indirizzo https://somesite/myweb.
In questo caso non è necessario usare i cmdlet SPAssignment perché l'oggetto Web non è archiviato, ma solo il valore stringa per l'URL.
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 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
Forza la disattivazione di una caratteristica.
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 il nome o il GUID della caratteristica da disattivare.
Il tipo deve essere il nome della cartella Feature che si trova nella cartella "$env:ProgramFiles\Common Files\Microsoft Shared\Web Server Extensions[14|15|16]\Template\Features" o guid nel formato 21d186e1-7036-4092-a825-0eb6709e9281.
Type: | SPFeatureDefinitionPipeBind |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Url
Specifica l'URL dell'applicazione Web, della raccolta siti o del sito Web per cui viene disattivata la caratteristica.
Il tipo deve essere un URL valido, ad esempio https://server_name.
Type: | String |
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 |