ConfigurationSection.SetAllowLocation-Methode

Artikel
03/28/2024

Legt das allowLocation-Attribut für einen Konfigurationsabschnitt fest.

Syntax

ConfigurationSection.SetAllowLocation(AllowLocation)

ConfigurationSection.SetAllowLocation(AllowLocation);

Parameter

Name	Definition
`AllowLocation`	Eine Variable mit Groß-/Kleinschreibung `string`, die das `allowLocation`-Attribut für den Konfigurationsabschnitt festlegt. Die möglichen Attributwerte sind „true“ oder „false“. Der Standardwert ist "true". Hinweis: Dieser Parameter ist `string`, nicht `boolean`.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Hinweise

Das allowLocation-Attribut gibt an, ob ein Konfigurationsabschnitt innerhalb eines Standorttags angezeigt werden kann.

Da SetAllowLocation eine statische Methode ist, sollten Sie sie aufrufen, indem Sie wie im folgenden Beispiel ein Klassenobjekt abrufen.

' Correct syntax:  
Set oAnonAuth = oWebAdmin.Get("AnonymousAuthenticationSection")  
oAnonAuth.SetAllowLocation "false"

Die folgende Syntax schlägt fehl, da versucht wird, SetAllowLocation auf eine konkrete Instanz der Site-Klasse aufzurufen. Der Aufruf der Methode führt zu einem Fehler „SWbemObjectEx: Nicht gefunden“.

  
' Incorrect syntax:  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "AnonymousAuthenticationSection", oAnonAuth  
oAnonAuth.SetAllowLocation "false"

Beispiel

Im folgenden Beispiel wird das allowLocation-Attribut für den Konfigurationsabschnitt der anonymen Authentifizierung festgelegt.

' Get the WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the AnonymousAuthenticationSection.  
Set oAnonAuth = oWebAdmin.Get( _  
    "AnonymousAuthenticationSection")  
  
' Set the allowLocation attribute.  
oAnonAuth.GetAllowLocation "false"

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

AnonymousAuthenticationSection-Klasse
ConfigurationSection-Klasse
ConfigurationSection.GetAllowLocation-Methode

Freigeben über