Get-IISConfigAttributeValue

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

Get-IISConfigAttributeValue

Gets a configuration attribute value from an IIS configuration section or configuration element attribute.

構文

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

詳細説明

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.

パラメーター

-AttributeName<String>

Specifies the name of the attribute that will be retrieved.

Aliases	none
必須/オプション	true
位置	2
既定値	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

出力

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

object

使用例

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"

Get-IISConfigAttributeValue