.png)
.png)
Disable-SPFeature
Betrifft:
Deaktiviert ein installiertes SharePoint-Feature in einem gegebenen Bereich.
Disable-SPFeature [-Identity] <SPFeatureDefinitionPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Url <String>] [-WhatIf [<SwitchParameter>]]
Parameter
| Parameter | Erforderlich | Typ | Beschreibung | ||
|---|---|---|---|---|---|
| Identity | Erforderlich | Microsoft.SharePoint.PowerShell.SPFeatureDefinitionPipeBind | Gibt den Namen oder die GUID des Features an, das deaktiviert werden soll. Der Typ muss der Name des Featureordners sein, der sich im Ordner 14\Template\Features befindet, oder die GUID im Format 21d186e1-7036-4092-a825-0eb6709e9281. | ||
| AssignmentCollection | Optional | Microsoft.SharePoint.PowerShell.SPAssignmentCollection | Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.
| ||
| Confirm | Optional | System.Management.Automation.SwitchParameter | Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird. Geben Sie den folgenden Befehl ein, um weitere Informationen zu erhalten: get-help about_commonparameters | ||
| Force | Optional | System.Management.Automation.SwitchParameter | Erzwingt die Deaktivierung eines Features. | ||
| Url | Optional | System.String | Gibt die URL der Webanwendung, Websitesammlung oder Website, in der das Feature deaktiviert wird. Der Typ muss eine gültige URL im Format http://Servername sein. | ||
| WhatIf | Optional | System.Management.Automation.SwitchParameter | Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen. Geben Sie den folgenden Befehl ein, um weitere Informationen zu erhalten: get-help about_commonparameters |
Hinweis: Detaillierte Beschreibung
Das Cmdlet Disable-SPFeature deaktiviert ein SharePoint-Feature im angegebenen Bereich. Wenn der Bereich des Features eine Farm ist, wird die URL nicht benötigt. Andernfalls müssen Sie die URL angeben, an der dieses Feature deaktiviert werden soll (die explizite Angabe des Bereichs ist nicht erforderlich).
Eingabetypen
Rückgabetypen
Keine
--------------BEISPIEL 1-----------------
Disable-SPFeature –identity "MyCustom" -URL http://somesite
In diesem Beispiel wird das Feature im Bereich der Website "MyCustom" an http://somesite deaktiviert.
--------------BEISPIEL 2-----------------
$w = Get-SPWeb http://somesite/myweb | ForEach{ $_.URL }
Get-SPFeature –Web $w |%{ Disable-SPFeature –Identity $_ -URL $w}
In diesem Beispiel werden alle Features auf der Unterwebsite an http://somesite/myweb deaktiviert.
Die Cmdlets SPAssignment müssen in diesem Fall nicht verwendet werden, da das Webobjekt nicht gespeichert ist, sondern nur der Zeichenfolgenwert für die URL.
