Get-IISConfigCollectionElement

Mis à jour: juillet 2015

Get-IISConfigCollectionElement

Gets a configuration element object from an IIS configuration collection.

Syntaxe

Parameter Set: Default
Get-IISConfigCollectionElement [-ConfigCollection] <ConfigurationElementCollection> [[-ConfigAttribute] <Hashtable> ] [-InformationAction <ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <String> ] [ <CommonParameters>]

Description détaillée

The Get-IISConfigCollectionElement cmdlet gets a ConfigurationElement object that is part of a given ConfigurationCollection. The returned element then can be used in further cmdlets that expect a ConfigurationElement.

Paramètres

-ConfigAttribute<Hashtable>

Specifies a hashtable of the attributes for the configuration element to be inserted. The cmdlet will fail if any required attributes are omitted from this table.

-ConfigCollection<ConfigurationElementCollection>

Specifies the ConfigurationCollection object for which the collection elements will be returned. If a ConfigurationCollection is previously obtained and assigned to a varible, you cannot pass it to this cmdlet through the pipeline because the pipeline engine will try to enumerate, passing ConfigurationElement objects instead. Try either passing the whole Get-IISConfigCollection cmdlet into the pipeline or use it as a parameter for correct results.

-InformationAction<ActionPreference>

Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend

-InformationVariable<String>

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

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez  . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.

• Microsoft.Web.Administration.ConfigurationElementCollection, System.Collections.Hashtable

Sorties

Le type de sortie correspond au type des objets que l'applet de commande émet.

• Microsoft.Web.Administration.ConfigurationElement

Exemples

Example 1: Get a configuration element for the default web site by passing the collection through a pipeline

This command gets a configuration element for the default web site by passing the collection through a pipeline.

PS C:\> Get-IISConfigSection -SectionPath "system.applicationHost/sites" | Get-IISConfigCollection | Get-IISConfigCollectionElement -ConfigAttribute @{"name"="Default Web Site"}

Example 2: Get a configuration element using a configuration collection as a parameter

This command gets a configuration element for the default web site and then stores the element into variable $SiteCollection.

PS C:\> $SiteCollection = Get-IISConfigSection -SectionPath "system.applicationHost/sites" | Get-IISConfigCollection
Get-IISConfigCollectionElement -ConfigCollection $SiteCollection -ConfigAttribute @{"name"="Default Web Site"}

Rubriques connexes

New-IISConfigCollectionElement

Remove-IISConfigCollectionElement

IIS Administration Cmdlets