Auf Englisch lesen

Freigeben über


HttpRedirectSection-Klasse

Konfiguriert die HTTP-Umleitung.

Syntax

class HttpRedirectSection : ConfigurationSectionWithCollection  

Methoden

In der folgenden Tabelle werden die Methoden aufgelistet, die von der HttpRedirectSection Klasse verfügbar gemacht werden.

Name Beschreibung
Add (Hinzufügen) (Geerbt von ConfigurationSectionWithCollection.)
Clear (Geerbt von ConfigurationSectionWithCollection.)
Get (Geerbt von ConfigurationSectionWithCollection.)
GetAllowDefinition (Geerbt von ConfigurationSection.)
GetAllowLocation (Geerbt von ConfigurationSection.)
Remove (Geerbt von ConfigurationSectionWithCollection.)
RevertToParent (Geerbt von ConfigurationSection.)
SetAllowDefinition (Geerbt von ConfigurationSection.)
SetAllowLocation (Geerbt von ConfigurationSection.)

Eigenschaften

In der folgenden Tabelle werden die Eigenschaften aufgeführt, die von der HttpRedirectSection Klasse verfügbar gemacht werden.

Name Beschreibung
ChildOnly Ein Lese-/Schreibboolean-Wert. true wenn sich das Umleitungsziel in einem Unterverzeichnis der ursprünglichen URL befindet; andernfalls, false. Der Standardwert ist false. Diese Einstellung benachrichtigt IIS, dass die Umleitung nur einmal erfolgen soll und verhindert endlose Schleifen im Ersetzungsmodul.
Destination Ein Lese-/Schreibstring-Wert, der den Dateinamen, den Verzeichnispfad oder die URL enthält, zu der der Benutzer umgeleitet wird. Die Zeichenfolge kann Umleitungsvariablen enthalten, um Teile der ursprünglichen URL mit der Ziel-URL zu übergeben. Sie können mehrere Variablen in der Zeichenfolge verwenden.
Enabled Ein Lese-/Schreibboolean-Wert. true wenn die HTTP-Umleitung aktiviert ist; andernfalls, false. Der Standardwert ist false.
ExactDestination Ein Lese-/Schreibboolean-Wert. true wenn die URL als absoluter Speicherort betrachtet werden soll; andernfalls, false. Durch eine Einstellung wird true verhindert, dass das Ersetzungsmodul die ursprüngliche angeforderte Ressource an die Umleitungs-URL anfügen kann.
HttpRedirect Ein Array von Wild Karte RedirectElement-Werten, die mithilfe übereinstimmender Kriterien den Dateinamen, den Verzeichnispfad oder die URL-Anforderungen an angegebene Ziele umleiten.
HttpResponseStatus Eine Lese-/Schreibsint32-Enumeration, die den HTTP-Antwortstatus enthält. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
Location (Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft.
Path (Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft.
SectionInformation (Geerbt von ConfigurationSection.)

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die HttpResponseStatus Eigenschaft angezeigt. Der Standardwert ist 302 (Found).

Wert Schlüsselwort Beschreibung
301 Permanent IIS teilt dem Webclient mit, dass sich der Speicherort für die angeforderte Ressource dauerhaft geändert hat. Der neue Speicherort wird im Location HTTP-Header angegeben. Diese Einstellung ermöglicht Webclients, die Aufzeichnung von HTTP-URL-Links beibehalten, um die gespeicherte URL mit dem neuen Speicherort zu aktualisieren.
302 Found IIS weist den Webclient an, eine neue Anforderung an den Speicherort ausstellen, der Location im HTTP-Header angegeben ist.
307 Temporary IIS weist den Webbrowser an, eine POST-Anforderung mit ursprünglichen Daten an einem neuen Speicherort erneut anzufordern. Wenn ein Webbrowser eine POST-Anforderung ausgibt und eine 302-Umleitungsnachricht vom Webserver empfängt, gibt der Browser eine GET-Anforderung für den neuen Speicherort aus. Dies bewirkt, dass die Daten in der ursprünglichen POST-Anforderung verloren gehen. Wenn der Browser eine 307-Umleitung empfängt, kann er die POST mit den originalen Daten intakt erneut aufführen.

Beispiel

Im ersten Beispiel werden alle Eigenschaften der HttpRedirectSection Klasse angezeigt, einschließlich eingebetteter SectionInformation und HttpRedirect Eigenschaften.

Im zweiten Beispiel werden vier Platzhalterumleitungselemente erstellt und versucht, sie dem Standardwebsite<httpRedirect>-Abschnitt hinzuzufügen. Wenn doppelte Einträge vorhanden sind, meldet der Code dies; andernfalls fügt er die neuen Einträge hinzu. Schließlich wird die neue Anzahl aller Einträge sowie der Wildcard und des Ziels für jedes Element angezeigt.

' 1) First example: Display the httpRedirect properties  
' for the default Web site.  
' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = _  
    GetObject("winmgmts:root\WebAdministration")  
  
' Get the httpRedirect section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HttpRedirectSection", oSection  
  
' Display the nonembedded properties.  
WScript.Echo "=============================="  
WScript.Echo "HttpRedirectSection Properties"  
WScript.Echo "=============================="  
For Each vProp In oSection.Properties_  
    If (vProp.Name <> "HttpRedirect") And _  
    (vProp.Name <> "SectionInformation") Then  
        WScript.Echo vProp.Name & ": " & vProp.Value  
    End If  
Next  
  
' Display the contents of the SectionInformation property.  
WScript.Echo   
WScript.Echo "--------------------------------------"  
WScript.Echo "HttpRedirectSection.SectionInformation"  
WScript.Echo "--------------------------------------"  
For Each vProp In oSection.SectionInformation.Properties_  
    WScript.Echo vProp.Name & ": " & vProp.Value  
Next  
WScript.Echo   
  
' Display the WildcardRedirectElement instances in the  
' HttpRedirect array property.  
WScript.Echo "--------------------------------"  
WScript.Echo "HttpRedirectSection.HttpRedirect"  
WScript.Echo "--------------------------------"  
For Each oWildcardRedirectElement In oSection.HttpRedirect  
    For Each vProp In oWildcardRedirectElement.Properties_  
        WScript.Echo vProp.Name & ": " & vProp.Value  
    Next  
    WScript.Echo  
Next  
  
' 2) Second example: Add four WildcardRedirectElement  
' instances to the default Web site and display the result.  
' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = _  
    GetObject("winmgmts:root\WebAdministration")  
  
' Get the httpRedirect section for the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HttpRedirectSection", oSection  
  
' Set up a loop to add four new redirects.  
For Counter = 1 To 4  
    ' Create a new instance of WildcardRedirectElement.  
    ' Note that you do not need to use SpawnInstance_.  
    Set oWildcardRedirect = _  
        oWebAdmin.Get("WildcardRedirectElement")  
  
    ' Specify the page to be redirected.  
    oWildcardRedirect.Wildcard = _  
        "Adatum.com/Page" & Counter & ".htm"  
  
    ' Specify the destination for the redirected page.  
    oWildcardRedirect.Destination = _  
        "Contoso.com/Page" & Counter & ".htm"  
  
    ' Prepare to catch duplicate entries.  
    On Error Resume Next  
  
    ' Attempt to add the wildcard entry to the collection.   
    ' (You do not need to use Put_ to save the change.)  
    oSection.Add "HttpRedirect", oWildcardRedirect  
  
    ' Catch duplicate entries.  
    If Err.Number = -2147024713 Then  
        WScript.Echo "Redirect entry for """ & _  
        oWildcardRedirect.Wildcard & """ already exists."  
        WScript.Echo  
    End If  
Next  
  
' Update the contents of the oSection variable.  
oSection.Refresh_  
  
' Display a header and the new number of entries.  
WScript.Echo "--------------------------------"  
WScript.Echo "HttpRedirectSection.HttpRedirect"  
WScript.Echo "--------------------------------"  
WScript.Echo "The number of redirect entries is now " & _  
    UBound(oSection.HttpRedirect) + 1 & "."  
WScript.Echo   
  
' Display the new set of wildcard redirect elements.  
For Each oWildcardRedirectElement In oSection.HttpRedirect  
    WScript.Echo "Wildcard: " & _  
        oWildcardRedirectElement.Wildcard & vbTab & _  
        "Destination: " & _  
        oWildcardRedirectElement.Destination  
    WScript.Echo  
Next  
  

Vererbungshierarchie

ConfigurationSection

ConfigurationSectionWithCollection

HttpRedirectSection

Anforderungen

type Beschreibung
Client IIS 7.0 unter Windows Vista.
IIS 7.5 unter Windows 7
IIS 8.0 unter Windows 8
IIS 10.0 unter Windows 10
Server IIS 7.0 unter Windows Server 2008
- IIS 7.5 unter Windows Server 2008 R2
IIS 8.0 auf Windows Server 2012.
- IIS 8.5 unter Windows Server 2012 R2
IIS 10.0 auf Windows Server 2016.
Produkt - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei WebAdministration.mof

Weitere Informationen

ConfigurationSectionWithCollection-Klasse
SectionInformation-Klasse
WildcardRedirectElement-Klasse