Freigeben über


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.

  1. 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.
  2. 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.