Cmdlet-Geltungsbereich
Für viele der Windows Server AppFabric-Verwaltungs-Cmdlets muss ein Bereich angegeben werden, um anzugeben, wo innerhalb der IIS-Hierarchie (Server, Site, Anwendung oder Dienst) eine Aktion ausgeführt werden soll.
Angeben des Bereichs
Die folgenden Windows PowerShell-Parameter können mit AppFabric-Cmdlets verwendet werden, um den Bereich anzugeben, auf dem die Cmdlets ausgeführt werden:
| Parameter | Verwenden Sie: |
|---|---|
-uri <Zeichenfolge> |
Ein URI für eine IIS-Website, eine Anwendung, ein virtuelles Verzeichnis oder einen Dienst, der angibt, dass das Cmdlet in diesem Bereich ausgeführt wird. Wenn Sie den „Uri“-Parameter verwenden, verwenden Sie nicht den „SiteName“-Parameter oder den Parametersatz „SiteName“ und „VirtualPath“. |
-SiteName <Zeichenfolge> [VirtualPath <Zeichenfolge>] |
Der SiteName-Parameter gibt den Namen einer Website an, wie er im Bereich „Verbindungen“ von IIS-Manager definiert ist, der angibt, dass das Cmdlet im Bereich der Website oder im Bereich einer Anwendung, eines virtuellen Verzeichnisses oder eines Diensts innerhalb dieser Website ausgeführt wird. Dem Parameter SiteName kann der Parameter VirtualPath hinzugefügt werden, der eine Anwendung, ein Verzeichnis oder einen Dienst auf dieser Website identifiziert. Im Fall einer Anwendung oder eines virtuellen Verzeichnisses schließt der virtuelle Pfad den Namen der Anwendung ein, wie er in IIS definiert ist. Bei Diensten enthält der virtuelle Pfad den Namen der Anwendung, einen Schrägstrich und den Namen der SVC- oder XAMLX-Datei des Diensts. Der Parameter „VirtualPath“ ist für den Geltungsbereich der Site nicht erforderlich. Das führende Zeichen / im virtuellen Pfad ist optional. Wenn Sie den Parameter „SiteName“ verwenden, verwenden Sie nicht den „Uri“-Parameter. |
-Root |
Der Name der Stammanwendung, der angibt, dass das Cmdlet in diesem Bereich ausgeführt wird. Wenn Sie den Parameter „Root“ verwenden, verwenden Sie nicht den Parameter „SiteName“, „VirtualPath“ oder „Uri“. |
-ServiceObject <DienstInfo> |
Der Name des Elements ServiceObject, das angibt, dass das Cmdlet für diesen Dienst ausgeführt wird. Dieser Parameter wird normalerweise verwendet, um die Ausgabe des „Get-ASAppService“-Cmdlets mittels einer Pipe an ein Cmdlet umzuleiten, das den „ServiceObject“-Parameter enthält. |
-ApplicationObject <AnwendungsInfo> |
Der Name des Elements ApplicationObject, das angibt, dass das Cmdlet für diese Anwendung ausgeführt wird. Dieser Parameter wird verwendet, um die Ausgabe des „Get-ASApplication“-Cmdlets mittels einer Pipe an ein Cmdlet umzuleiten, das den „ApplicationObject“-Parameter enthält. |
-ServiceInstanceObject <DienstinstanzInfo> |
Der Name des ServiceInstanceObject, das angibt, dass das Cmdlet für diesen Dienst ausgeführt wird. |
Die folgenden Regeln gelten für bestimmte Bereiche:
Für den Stammbereich des Diensts verwenden Sie das Parameterflag –root.
Verwenden Sie für den Websitebereich den Parameter –SiteName.
Verwenden Sie für den Anwendungsbereich den Parametersatz –SiteName –VirtualPath oder den –Uri-Parameter.
Verwenden Sie für den Dienstbereich den Parametersatz –SiteName –VirtualPath oder den –Uri-Parameter.
2011-12-05