Partager via

Set-SCApplicationHostTemplate

  • Référence
Module:
VirtualMachineManager

Configure les propriétés d’un modèle hôte d’application qui a été ajouté à un modèle de service.

Syntaxe

Set-SCApplicationHostTemplate
   [-DeploymentOrder <Int32>]
   [-ServicingOrder <Int32>]
   [-Port <Int32>]
   [-AllowUntrustedServerCertificate <Boolean>]
   [-RunAsAccount <VMMCredential>]
   [-ApplicationHostTemplate] <ApplicationHostTemplate>
   [-Name <String>]
   [-Description <String>]
   [-Owner <String>]
   [-Tag <String>]
   [-ComputerName <String>]
   [-Site <String>]
   [-AuthenticationType <String>]
   [-ApplicationProfile <ApplicationProfile>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande set-SCApplicationHostTemplate configure les propriétés d’un modèle hôte d’application qui a été ajouté à un modèle de service.

Exemples

Exemple 1 : Modifier la description du modèle hôte d’application

PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $AppHostTemplate = Get-SCApplicationHostTemplate -ServiceTemplate $ServiceTemplate
PS C:\> Set-SCApplicationHostTemplate -ApplicationHostTemplate $AppHostTemplate -Description "This is the updated description"

La première commande obtient l’objet de modèle de service nommé ServiceTemplate01 et stocke l’objet dans la variable $ServiceTemplate.

La deuxième commande obtient l’objet de modèle hôte d’application pour le modèle de service dans $ServiceTemplate et stocke l’objet dans la variable $AppHostTemplate.

La dernière commande modifie la propriété de description du modèle hôte d’application dans $AppHostTemplate.

Exemple 2 : Modifier le nom d’un modèle hôte d’application

PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $AppHostTemplate = Get-SCApplicationHostTemplate -ServiceTemplate $ServiceTemplate
PS C:\> Set-SCApplicationHostTemplate -ApplicationHostTemplate $AppHostTemplate -Name "This is the updated name"

La première commande obtient l’objet de modèle de service nommé ServiceTemplate01 et stocke l’objet dans la variable $ServiceTemplate.

La deuxième commande obtient l’objet de modèle hôte d’application pour le modèle de service stocké dans $ServiceTemplate et stocke l’objet dans la variable $AppHostTemplate.

La dernière commande modifie la propriété de nom du modèle hôte d’application stocké dans $AppHostTemplate. Étant donné que le modèle hôte d’application est cloné dans le modèle de service, le changement de nom du modèle hôte d’application n’affecte pas d’autres modèles de service dans le système.

Paramètres

-AllowUntrustedServerCertificate

Indique si le déploiement peut continuer lorsque le serveur de déploiement cible présente un certificat de serveur non approuvé. Ce paramètre est utilisé conjointement avec un modèle hôte d’application web.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ApplicationHostTemplate

Spécifie un objet de modèle hôte d’application.

Type:ApplicationHostTemplate
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ApplicationProfile

Spécifie un objet de profil d’application.

Type:ApplicationProfile
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AuthenticationType

Spécifie le mécanisme d’authentification utilisé pour faciliter le déploiement d’applications web associées au modèle. Ce paramètre est utilisé conjointement avec un modèle hôte d’application web. Les valeurs valides sont : NTLM et Basic.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ComputerName

Spécifie le nom d’un ordinateur que Virtual Machine Manager (VMM) peut identifier de manière unique sur votre réseau. Les formats valides sont les suivants :

  • FQDN
  • Adresse IPv4 ou IPv6
  • Nom NetBIOS
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DeploymentOrder

Spécifie l’ordre dans lequel une couche ordinateur, un hôte d’application ou une application est déployé.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifie une description du modèle hôte d’application.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un objet VMM.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Owner

Spécifie le propriétaire d’un objet VMM sous la forme d’un compte d’utilisateur de domaine valide.

  • Exemple de format : -Owner "Contoso\PattiFuller"
  • Exemple de format : -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Port

Spécifie le port réseau à utiliser lors de l’ajout d’un objet ou de la création d’une connexion. Les valeurs valides sont les suivantes : 1 à 4095.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsAccount

Spécifie un compte d’identification qui contient des informations d’identification avec l’autorisation d’effectuer cette action.

Type:VMMCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServicingOrder

Spécifie l’ordre dans lequel un hôte d’ordinateur ou d’application est mis en service.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Site

Spécifie le site web sur lequel tous les packages de déploiement web associés sont déployés. Ce paramètre est utilisé conjointement avec un modèle hôte d’application web.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tag

Spécifie un mot ou une expression à associer à un objet afin que vous puissiez rechercher tous les objets avec l’ensemble spécifié de balises. Vous pouvez rechercher un sous-ensemble de balises ou rechercher l’ensemble complet des balises.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

ApplicationHostTemplate

Cette applet de commande retourne un objet ApplicationHostTemplate.