Get-IISConfigAttributeValue
Get-IISConfigAttributeValue
Gets a configuration attribute value from an IIS configuration section or configuration element attribute.
Sintaxis
Parameter Set: Default
Get-IISConfigAttributeValue [-ConfigElement] <ConfigurationElement> [-AttributeName] <String> [-InformationAction <ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <String> ] [ <CommonParameters>]
Descripción detallada
The Get-IISConfigAttributeValue cmdlet gets a configuration attribute value from an Internet Information Services (IIS) configuration section attribute or a configuration element attribute. The value returned is the value that can be extracted from the given ConfigurationElement and not necessarily the effective value for a given site / virtual directory / folder etc. To obtain the effective attribute values, always retrieve the configuration element by specifying the commit path as the deepest level possible. Even the configuration attribute is not defined at that level, the parent attributes are scanned and the effective configuration element is returned. You can then work on this ConfigurationElement to get/set/remove configuration attribute values.
Parámetros
-AttributeName<String>
Specifies the name of the attribute that will be retrieved.
Alias |
none |
¿Necesario? |
true |
¿Posición? |
2 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
true(ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-ConfigElement<ConfigurationElement>
Specifies the IIS ConfigurationSection or ConfigurationElement for which the attribute value will be looked up.
Alias |
none |
¿Necesario? |
true |
¿Posición? |
1 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
true(ByValue,ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-InformationAction<ActionPreference>
Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
Alias |
infa |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-InformationVariable<String>
Specifies a variable in which to store an information event message.
Alias |
iv |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entradas
El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.
- Microsoft.Web.Administration.ConfigurationElement, System.String
Salidas
El tipo de resultado es el tipo de los objetos que el cmdlet emite.
- object
Ejemplos
Example 1: Get a configuration attribute from an IIS website
This command gets the configuration attribute MaxUrlSegments for the Default Web Site.
PS C:\> Get-IISSite "Default Web Site" | Get-IISConfigElement -ChildElementName "limits" | Get-IISConfigAttributeValue -AttributeName "MaxUrlSegments"
Example 2: Get configuration attribute values from different parts of the configuration store
This command gets the global attribute value for ScriptErrorMessage
PS C:\> Get-IISConfigSection "system.webServer/asp" | Get-IISConfigAttributeValue -AttributeName "ScriptErrorMessage"