Get-IISConfigCollection

아티클
11/16/2015

업데이트 날짜: 2015년 7월

Get-IISConfigCollection

Gets a configuration collection object from an IIS configuration section or a configuration element.

구문

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

자세한 설명

The Get-IISConfigCollection cmdlet gets a ConfigurationCollection object from either a ConfigurationSection or a ConfigurationElement.

It is advisable to not to assign this value to a parameter and pass it in the pipeline to the next cmdlet since Windows PowerShell cannot interpret this object. This is due to the fact that ConfigurationCollection implements IEnumarable and the pipeline processor enumrates each single element when used this way. Instead either pass the whole Get-IISConfigCollection cmdlet in the pipeline or pass it as a parameter.

매개 변수

-CollectionName<String>

Specifies the name of the collection to be returned. If the name of the collection is not used, the Default Collection is returned. Alternatively, the named collection can be retrieved by Get-IISConfigElement then the default collection inside this element can be retrieved.

별칭	none
필수 여부	false
위치	2
기본값	none
파이프라인 입력 허용 여부	true(ByPropertyName)
와일드카드 문자 허용 여부	false

-ConfigElement<ConfigurationElement>

Specifies the IIS ConfigurationSection or ConfigurationElement for which the ConfigurationCollection is returned.

별칭	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

별칭	infa
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

-InformationVariable<String>

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

별칭	iv
필수 여부	false
위치	named
기본값	none
파이프라인 입력 허용 여부	false
와일드카드 문자 허용 여부	false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216)

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

Microsoft.Web.Administration.ConfigurationElement,System.String

출력

출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.

예

Example 1: Get a configuration collection from an IIS configuration section

This command gets the Files Collection for the system.webServer/defaultDocument section.

PS C:\> Get-IISConfigSection -SectionPath "system.webServer/defaultDocument" | Get-IISConfigCollection -CollectionName "files"

Example 2: Get a configuration element from an IIS configuration section

This command gets the Files Element configuration object from the system.webServer/defaultDocument section then gets its default collection. The output of the two formats are the same.

PS C:\> Get-IISConfigSection -SectionPath "system.webServer/defaultDocument" | Get-IISConfigElement -ChildElementName "files" | Get-IISConfigCollection

Get-IISConfigCollection