Étendue des cmdlets
Plusieurs cmdlets de gestion de Windows Server AppFabric nécessitent la spécification d'une étendue pour identifier l'emplacement d'exécution de l'action dans la hiérarchie IIS (serveur, site, application ou service).
Spécification d'une étendue
Les paramètres Windows PowerShell suivants peuvent être utilisés avec les cmdlets AppFabric pour spécifier l'étendue sur laquelle les cmdlets sont exécutées :
| Paramètre | Fonction |
|---|---|
-uri <string> |
URI d'un site, d'une application, d'un répertoire virtuel ou d'un service IIS, qui spécifie que la cmdlet opère sur cette étendue. Si vous utilisez le paramètre Uri, n'utilisez pas le paramètre SiteName ni le jeu de paramètres SiteName et VirtualPath. |
-SiteName <string> [-VirtualPath <string>] |
Le paramètre SiteName définit le nom d'un site Web, tel que défini dans le volet Connexions des services Internet, qui spécifie que la cmdlet opère sur l'étendue de ce site ou celle d'une application, d'un répertoire virtuel ou d'un service inclus dans ce site. Vous devez ajouter au paramètre SiteName le paramètre VirtualPath identifiant une application, un répertoire ou un service inclus dans le site. Pour une application ou un répertoire virtuel, le chemin d'accès virtuel inclut le nom de l'application, tel que défini dans les services Internet. Pour un service, le chemin d'accès virtuel inclut le nom de l'application, une barre oblique et le nom du fichier .svc ou du fichier .xamlx pour le service. Le paramètre VirtualPath n'est pas nécessaire pour l'étendue du site. Le caractère initial « / » du chemin d'accès virtuel est facultatif. Si vous utilisez le paramètre SiteName, n'utilisez pas le paramètre Uri. |
-Root |
Nom de l'application racine spécifiant que la cmdlet opère sur cette étendue. Si vous utilisez le paramètre Root, n'utilisez pas le paramètre SiteName, VirtualPath ou Uri. |
-ServiceObject <ServiceInfo> |
Nom du paramètre ServiceObject spécifiant que la cmdlet opère sur ce service. Ce paramètre permet de canaliser la sortie de la cmdlet Get-ASAppService vers une cmdlet contenant le paramètre ServiceObject. |
-ApplicationObject <ApplicationInfo> |
Nom du paramètre ApplicationObject spécifiant que la cmdlet opère sur cette application. Ce paramètre permet de canaliser la sortie de la cmdlet Get-ASApplication vers une cmdlet contenant le paramètre ApplicationObject. |
-ServiceInstanceObject <ServiceInstanceInfo> |
Nom du paramètre ServiceInstanceObject spécifiant que la cmdlet opère sur ce service. |
Les règles suivantes s'appliquent aux étendues spécifiques :
Pour l'étendue racine du service, utilisez le paramètre d'indicateur –root.
Pour l'étendue du site, utilisez le paramètre –SiteName.
Pour l'étendue de l'application, utilisez le jeu de paramètres –SiteName et –VirtualPath, ou le paramètre –Uri.
Pour l'étendue du service, utilisez le jeu de paramètres –SiteName et –VirtualPath, ou le paramètre –Uri.
2011-12-05