New-IISSite

Article
11/16/2015

Mis à jour: août 2015

New-IISSite

Creates an IIS Web site.

Syntaxe

Parameter Set: Default
New-IISSite -BindingInformation <String> -Name <String> -PhysicalPath <String> [-Force] [-InformationAction <ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <String> ] [-Passthru] [ <CommonParameters>]

Description détaillée

The New-IISSite cmdlet is used to create an Internet Information Services (IIS) website with the given physical site as the root and binding information to listen on a specific IP:Port:Hostname binding.

Paramètres

-BindingInformation<String>

Specifies the binding information string to use for the new site. The binding information of the form IP:Port:hostname such as 192.168.0.1:80:www.contoso.com and one or more of the fields can be left blank, which is equivalent to using a wildcard character such as *:443:. In this representation * indicates all IP addresses and all hostnames is indicated by leaving the corresponding field blank.

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

-Force

Force l'exécution de la commande sans demander une confirmation de l'utilisateur.

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

-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

-Name<String>

Specifies the name of the IIS website.

Alias	none
Requis ?	true
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
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

-PhysicalPath<String>

Specifies the physical path to the new IIS website.

Alias	none
Requis ?	true
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
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.

String

Sorties

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

Microsoft.Web.Administration.Site

Exemples

Example 1: Add a new IIS web site

This command creates a new website named TestSite.

PS C:\> New-IISSite -Name "TestSite" -BindingInformation "*:8080:" –PhysicalPath "$env:systemdrive\inetpub\testsite"

Example 2: Add a new website and set application pool of the site default application to a custom name

This command creates a website named TestSite with default application assigned to the TestSiteAppPool application pool.

PS C:\> Start-IISCommitDelay
PS C:\> $TestSite = New-IISSite -Name TestSite -BindingInformation "*:8080:" –PhysicalPath "$env:systemdrive\inetpub\testsite" -Passthru
PS C:\> $TestSite.Applications[“/”].ApplicationPoolName = “TestSiteAppPool”
PS C:\> Stop-IISCommitDelay