Set-IISConfigAttributeValue
Set-IISConfigAttributeValue
Sets a configuration attribute value for an IIS configuration section or configuration element attribute.
Sintaxis
Parameter Set: Default
Set-IISConfigAttributeValue [-ConfigElement] <ConfigurationElement> [-AttributeName] <String> [-AttributeValue] <Object> [-InformationAction <ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <String> ] [ <CommonParameters>]
Descripción detallada
The Set-IISConfigAttributeValue cmdlet sets a configuration attribute value from an Internet Information Services (IIS) configuration section attribute or a configuration element attribute. The value set is for the given ConfigurationElement and not necessarily the effective value for a given site / virtual directory / folder etc. To set the effective attribute values, always retrieve the configuration element by specifying the commit path as the deepest level possible.
Parámetros
-AttributeName<String>
Specifies the name of the attribute for which the value will be set.
Alias |
none |
¿Necesario? |
true |
¿Posición? |
2 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
true(ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-AttributeValue<Object>
Specifies the new value of the attribute.
Alias |
none |
¿Necesario? |
true |
¿Posición? |
3 |
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, System.Object
Salidas
El tipo de resultado es el tipo de los objetos que el cmdlet emite.
Ejemplos
Example 1: Set the value of a configuration attribute
This command sets the value of the configuration attribute MaxUrlSegments for the IIS website named Default Web Site to 16.
PS C:\> $ConfigSection = Get-IISConfigSection -SectionPath "system.applicationHost/sites"
PS C:\> $SitesCollection = Get-IISConfigCollection -ConfigElement $ConfigSection
PS C:\> $Site = Get-IISConfigCollectionElement -ConfigCollection $SitesCollection -ConfigAttribute @{Name = "Default Web Site"}
PS C:\> $Elem = Get-IISConfigElement -ConfigElement $Site -ChildElementName "limits"
PS C:\> Set-IISConfigAttributeValue -ConfigElement $Elem -AttributeName "MaxUrlSegments" -AttributeValue 16