Add-WebConfiguration

아티클
11/16/2015

Add-WebConfiguration

Adds a collection element to an IIS configuration collection.

구문

Parameter Set: Default
Add-WebConfiguration [-Filter] <String[]> [[-PSPath] <String[]> ] [-AtElement <Hashtable> ] [-AtIndex <Int32> ] [-AtName <String> ] [-Clr <String> ] [-Force] [-Location <String[]> ] [-Value <PSObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

자세한 설명

The Add-WebConfiguration cmdlet adds a collection element to an existing Internet Information Services (IIS) configuration collection.

매개 변수

-AtElement<Hashtable>

Specifies the element in the collection location at which this cmdlet inserts the value.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	true (ByValue, ByPropertyName)
와일드카드 문자 허용 여부	false

-AtIndex<Int32>

Specifies the index at which this cmdlet inserts the value.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	true (ByValue, ByPropertyName)
와일드카드 문자 허용 여부	false

-AtName<String>

Specifies the name at which this cmdlet inserts the value.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	true (ByValue, ByPropertyName)
와일드카드 문자 허용 여부	false

-Clr<String>

Specifies the version of the .NET Framework in the form vn.n, such as v4.0 or v2.0. The default is v4.0. Specify this parameter only when the PSPath parameter is set to either Machine or Machine/Webroot. If PSPath is not set to one of these values and the Clr parameter is set, Windows PowerShell® ignores the value of Clr and returns a warning.

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

-Filter<String[]>

Specifies the IIS configuration section or an XPath query that returns either a configuration section or a configuration element that contains a collection.

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

-Force

Forces the creation of a configuration, and overrides existing element settings.

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

-Location<String[]>

Specifies the location to which this cmdlet writes the configuration.

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

-PSPath<String[]>

Specifies the configuration path. This path can be either an IIS configuration path in the format computer name/webroot/apphost, or the IIS module path in the format IIS:\sites\Default Web Site.

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

-Value<PSObject>

Specifies the value to add to the configuration collection. You can specify a single value or a value/key combination in a hash table.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

PSObject

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

PSObject

예제

Example-------------- EXAMPLEExample 1: Add a new Default default Ddocument --------------default d

This command adds a new default document to the default document collection of the default website. By specifying a value of 0 for the atIndex parameter, the new default document is inserted at the top of the list.

IIS:\>Add-WebConfiguration -Filter "//defaultDocument/files" -PSPath "IIS:\sites\Default Web Site" -AtIndex 0 -Value @{value="new-index.html"}

Add-WebConfiguration