New-IISConfigCollectionElement

Article
11/16/2015

Mis à jour: août 2015

New-IISConfigCollectionElement

Creates a new configuration element object in an IIS configuration collection.

Syntaxe

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

Description détaillée

The New-IISConfigCollectionElement cmdlet creates a new ConfigurationElement in a given Internet Information Services (IIS) ConfigurationCollection.

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.

Alias	none
Requis ?	true
Position ?	3
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	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
Requis ?	true
Position ?	1
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByValue,ByPropertyName)
Accepter les caractères génériques ?	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
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-InformationVariable<String>

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

Alias	iv
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Passthru

Renvoie un objet qui représente l'élément sur lequel vous travaillez. Par défaut, cette applet de commande ne génère pas de sortie.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

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

Exemples

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"}

Rubriques connexes

Get-IISConfigCollectionElement

IIS Administration Cmdlets

New-IISConfigCollectionElement