HttpRedirectSection-Klasse

Artikel
03/25/2024

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-/Schreib`boolean`-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-/Schreib`string`-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-/Schreib`boolean`-Wert. `true` wenn die HTTP-Umleitung aktiviert ist; andernfalls, `false`. Der Standardwert ist `false`.
`ExactDestination`	Ein Lese-/Schreib`boolean`-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-/Schreib`sint32`-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

Freigeben über