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.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
2 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
true(ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-ConfigCollection<ConfigurationElementCollection>
Specifies the ConfigurationCollection from which the matching ConfigurationElements will be removed.
Alias |
none |
¿Necesario? |
true |
¿Posición? |
1 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
true(ByValue,ByPropertyName) |
¿Aceptar caracteres comodín? |
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
Alias |
infa |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-InformationVariable<String>
Specifies a variable in which to store an information event message.
Alias |
iv |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el cmdlet.
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
false |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-WhatIf
Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
false |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<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