New-IISConfigCollectionElement
New-IISConfigCollectionElement
Creates a new configuration element object in an IIS configuration collection.
Sintaxis
Parameter Set: Default
New-IISConfigCollectionElement [-ConfigCollection] <ConfigurationElementCollection> [-ConfigAttribute] <Hashtable> [-InformationAction <ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <String> ] [-Passthru] [ <CommonParameters>]
Descripción detallada
The New-IISConfigCollectionElement cmdlet creates a new ConfigurationElement in a given Internet Information Services (IIS) ConfigurationCollection.
Parámetros
-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.
Alias |
none |
¿Necesario? |
true |
¿Posición? |
3 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
true(ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-ConfigCollection<ConfigurationElementCollection>
Specifies the ConfigurationCollection object to which the new collection element will be added. If a ConfigurationCollection is previously obtained and assigned to a variable, you cannot pass it to this cmdlet through the pipeline because the pipeline engine will try to enumerate it, passing ConfigurationElement objects instead. Try either passing the whole Get-IISConfigCollection cmdlet into the pipeline or use it as a parameter for correct results.
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 |
-Passthru
Devuelve un objeto que representa el elemento con el que está trabajando. De manera predeterminada, este cmdlet no genera ningún resultado.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿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.
- Microsoft.Web.Administration.Configuration
Ejemplos
Example 1: Add a new file name to list of default documents
This command creates an entry in the list of default documents.
PS C:\> $ConfigSection = Get-IISConfigSection -SectionPath "system.webServer/defaultDocument"
PS C:\> $DefaultDocumentCollection = Get-IISConfigCollection -ConfigElement $ConfigSection -CollectionName "files"
PS C:\> New-IISConfigCollectionElement
-ConfigCollection $DefaultDocumentCollection -ConfigAttribute @{"Value" = "MyDefDoc.htm"}