PowerShell-Snap-In: Verwenden des PowerShell-Hilfesystems
von Thomas Deml
In dieser exemplarischen Vorgehensweise erfahren Sie, wie Sie Hilfe zur Verwendung des IIS PowerShell-Snap-Ins erhalten.
Einführung
Das IIS PowerShell-Snap-In verwendet zwei Typen von Cmdlets.
- Integrierte Cmdlets wie „New-Item“, „Get-ChildItems“ oder „Set-ItemProperty“ werden in jedem Namespace (z. B. dem Dateisystem) implementiert und funktionieren auch mit dem IIS PowerShell-Snap-In. Diese integrierten Cmdlets gelten für Container, die in der IIS-Hierarchie verfügbar gemacht werden: Sites, Anwendungspools, Webanwendungen und virtuelle Verzeichnisse.
- Spezifische Cmdlets des IIS PowerShell-Snap-Ins wie „Get-WebConfiguration“, „Set-WebConfigurationProperty“ oder „Get-WebItemState“ gelten nur für IIS. Diese Cmdlets müssen zum Verwalten der Featurekonfiguration oder des Runtimestatus verwendet werden. Beispiele für die Featurekonfiguration sind defaultDocument-Konfiguration, Komprimierungseinstellungen, Module und Handlerkonfiguration usw. Beispiele für Runtimestatus sind der Status von Anwendungspools und Sites.
Hilfe zu integrierten Cmdlets
Das Abrufen von Hilfe zu diesen beiden Typen von Cmdlets ist unterschiedlich. Um Hilfe zur Verwendung der integrierten Cmdlets im Namespace „IIS:\“ zu erhalten, müssen Sie den folgenden Befehl verwenden:
get-help WebAdministration | more
Die Ausgabe dieses Befehls enthält eine detaillierte Übersicht darüber, wie integrierte Cmdlets im IIS-Namespace verwendet werden können. Sie zeigt die Syntax und welche zusätzlichen Parameter angegeben werden müssen. Und schließlich wird eine große Anzahl von Beispielen angezeigt, die Ihnen helfen, sich mit diesen Cmdlets vertraut zu machen.
Hilfe zu IIS-spezifischen Cmdlets
Wenn Sie Hilfe zu IIS-spezifischen Cmdlets erhalten möchten, müssen Sie den folgenden Befehl verwenden:
Get-Help <cmdlet name>
Beispiele:
Get-Help Get-WebConfiguration
Get-Help Get-WebItemState
Get-Help Add-WebConfiguration
Sie können den folgenden Befehl ausführen, um eine Liste der von IIS bereitgestellten Cmdlets abzurufen:
PS IIS:\> Get-Command -pssnapin IISProviderSnapIn
CommandType Name Definition
----------- ---- ----------
Cmdlet Add-WebConfiguration Add-WebConfiguration [-Filter] <String...
Cmdlet Add-WebConfigurationProperty Add-WebConfigurationProperty [-Filter]...
Cmdlet Begin-Transaction Begin-Transaction [[-PSPath] <String[]...
Cmdlet Clear-WebConfiguration Clear-WebConfiguration [-Filter] <Stri...
Cmdlet End-Transaction End-Transaction [[-PSPath] <String[]>]...
Cmdlet Get-section Get-section [-Section] <String> [-PSPa...
Cmdlet Get-URL Get-URL [-Url <String>] [-PSPath <Stri...
Cmdlet Get-WebConfiguration Get-WebConfiguration [-Filter] <String...
Cmdlet Get-WebConfigurationProperty Get-WebConfigurationProperty [-Filter]...
Cmdlet Get-WebItemState Get-WebItemState [[-PSPath] <String[]>...
Cmdlet Remove-WebConfigurationProperty Remove-WebConfigurationProperty [-Filt...
Cmdlet Restart-WebItem Restart-WebItem [[-PSPath] <String[]>]...
Cmdlet Set-WebConfiguration Set-WebConfiguration [-Filter] <String...
Cmdlet Set-WebConfigurationProperty Set-WebConfigurationProperty [-Filter]...
Cmdlet Start-WebItem Start-WebItem [[-PSPath] <String[]>] [...
Cmdlet Stop-WebItem Stop-WebItem [[-PSPath] <String[]>] [-...
Zusammenfassung
In dieser exemplarischen Vorgehensweise haben Sie erfahren, wie Sie das PowerShell-Hilfesystem verwenden, um weitere Informationen zur Verwendung integrierter Cmdlets im IIS-Namespace zu erhalten, aber auch zum Verwenden von IIS-spezifischen Cmdlets.