Set-IISConfigAttributeValue

[アーティクル]
11/16/2015

Set-IISConfigAttributeValue

Sets a configuration attribute value for an IIS configuration section or configuration element attribute.

構文

Parameter Set: Default
Set-IISConfigAttributeValue [-ConfigElement] <ConfigurationElement> [-AttributeName] <String> [-AttributeValue] <Object> [-InformationAction <ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <String> ] [ <CommonParameters>]

詳細説明

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.

パラメーター

-AttributeName<String>

Specifies the name of the attribute for which the value will be set.

Aliases	none
必須/オプション	true
位置	2
既定値	none
パイプライン入力の受け入れ	true(ByPropertyName)
ワイルドカード文字の受け入れ	false

-AttributeValue<Object>

Specifies the new value of the attribute.

Aliases	none
必須/オプション	true
位置	3
既定値	none
パイプライン入力の受け入れ	true(ByPropertyName)
ワイルドカード文字の受け入れ	false

-ConfigElement<ConfigurationElement>

Specifies the IIS ConfigurationSection or ConfigurationElement for which the attribute value will be looked up.

Aliases	none
必須/オプション	true
位置	1
既定値	none
パイプライン入力の受け入れ	true(ByValue,ByPropertyName)
ワイルドカード文字の受け入れ	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

Aliases	infa
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

-InformationVariable<String>

Specifies a variable in which to store an information event message.

Aliases	iv
必須/オプション	false
位置	named
既定値	none
パイプライン入力の受け入れ	false
ワイルドカード文字の受け入れ	false

<CommonParameters>

このコマンドレットは共通のパラメーターをサポートしています(-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、および -OutVariable)。詳細については、TechNet の「「about_CommonParameters」 (https://go.microsoft.com/fwlink/p/?LinkID=113216) を参照してください。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

Microsoft.Web.Administration.ConfigurationElement, System.String, System.Object

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

使用例

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

Set-IISConfigAttributeValue