Remove-IISConfigCollectionElement

Remove-IISConfigCollectionElement

Removes a configuration element object from an IIS configuration collection.

Sintaxis

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

Descripción detallada

The Remove-IISConfigCollectionElement cmdlet removes a ConfigurationElement from a given Internet Information Services (IIS) ConfigurationCollection.

Parámetros

-ConfigAttribute<Hashtable>

Specifies a hashtable of the attributes to match while searching for the configuration elements to delete in the collection. For the configuration attributes that are not specified, no filtering will be done. If you omit this parameter, all the elements in the collection are deleted.

-ConfigCollection<ConfigurationElementCollection>

Specifies the ConfigurationCollection from which the matching ConfigurationElements will be removed.

-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.

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

-WhatIf

Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.

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

Salidas

El tipo de resultado es el tipo de los objetos que el cmdlet emite.

Ejemplos

Example 1: Remove a file name from the list of default documents

This command removes a configuration entry from the list of default documents.

PS C:\> $ConfigSection = Get-IISConfigSection -SectionPath "system.webServer/defaultDocument"
PS C:\> Get-IISConfigCollection $ConfigSection "Files" | Remove-IISConfigCollectionElement  -ConfigAttribute @{"Value" = "MyDefDoc.htm"}

Temas relacionados

Get-IISConfigCollectionElement

New-IISConfigCollectionElement

IIS Administration Cmdlets