Set-SCApplicationHostTemplate

Konfiguriert die Eigenschaften einer Anwendungshostvorlage, die einer Dienstvorlage hinzugefügt wurde.

Syntax

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>]

Beschreibung

Das Cmdlet Set-SCApplicationHostTemplate konfiguriert die Eigenschaften einer Anwendungshostvorlage, die einer Dienstvorlage hinzugefügt wurde.

Beispiele

Beispiel 1: Ändern der Beschreibung der Anwendungshostvorlage

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"

Der erste Befehl ruft das Dienstvorlagenobjekt namens ServiceTemplate01 ab und speichert das Objekt in der $ServiceTemplate Variablen.

Der zweite Befehl ruft das Anwendungshostvorlagenobjekt für die Dienstvorlage in $ServiceTemplate ab und speichert das Objekt in der $AppHostTemplate Variablen.

Der letzte Befehl ändert die Beschreibungseigenschaft der Anwendungshostvorlage in $AppHostTemplate.

Beispiel 2: Ändern des Namens einer Anwendungshostvorlage

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"

Der erste Befehl ruft das Dienstvorlagenobjekt namens ServiceTemplate01 ab und speichert das Objekt in der $ServiceTemplate Variablen.

Der zweite Befehl ruft das Anwendungshostvorlagenobjekt für die in $ServiceTemplate gespeicherte Dienstvorlage ab und speichert das Objekt in der $AppHostTemplate Variablen.

Der letzte Befehl ändert die Nameeigenschaft der in $AppHostTemplate gespeicherten Anwendungshostvorlage. Da die Anwendungshostvorlage in die Dienstvorlage geklont wird, wirkt sich das Umbenennen der Anwendungshostvorlage nicht auf andere Dienstvorlagen im System aus.

Parameter

-AllowUntrustedServerCertificate

Gibt an, ob die Bereitstellung fortgesetzt werden kann, wenn der Zielbereitstellungsserver ein nicht vertrauenswürdiges Serverzertifikat anzeigt. Dieser Parameter wird in Verbindung mit einer Webanwendungshostvorlage verwendet.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationHostTemplate

Gibt ein Anwendungshostvorlagenobjekt an.

Type:ApplicationHostTemplate
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationProfile

Gibt ein Anwendungsprofilobjekt an.

Type:ApplicationProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticationType

Gibt den Authentifizierungsmechanismus an, der verwendet wird, um die Bereitstellung von Webanwendungen zu erleichtern, die der Vorlage zugeordnet sind. Dieser Parameter wird in Verbindung mit einer Webanwendungshostvorlage verwendet. Gültige Werte sind: NTLM und Basic.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Gibt den Namen eines Computers an, auf dem der Virtual Machine Manager (VMM) in Ihrem Netzwerk eindeutig identifiziert werden kann. Gültige Formate sind:

  • FQDN
  • IPv4- oder IPv6-Adresse
  • NetBIOS-Name
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentOrder

Gibt die Reihenfolge an, in der eine Computerebene, ein Anwendungshost oder eine Anwendung bereitgestellt wird.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Gibt eine Beschreibung für die Anwendungshostvorlage an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt den Namen eines VMM-Objekts an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Owner

Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Port

Gibt den Netzwerkport an, der beim Hinzufügen eines Objekts oder beim Erstellen einer Verbindung verwendet werden soll. Gültige Werte sind: 1 bis 4095.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsAccount

Gibt ein Run As-Konto an, das Anmeldeinformationen mit der Berechtigung zum Ausführen dieser Aktion enthält.

Type:VMMCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicingOrder

Gibt die Reihenfolge an, in der ein Computerebenen- oder Anwendungshost dienstiert wird.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Site

Gibt die Website an, für die alle zugeordneten Webbereitstellungspakete bereitgestellt werden. Dieser Parameter wird in Verbindung mit einer Webanwendungshostvorlage verwendet.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Gibt ein Wort oder einen Ausdruck an, der einem Objekt zugeordnet werden soll, damit Sie nach allen Objekten mit dem angegebenen Satz von Tags suchen können. Sie können nach einer Teilmenge von Tags suchen oder nach der vollständigen Gruppe von Tags suchen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

ApplicationHostTemplate

Dieses Cmdlet gibt ein ApplicationHostTemplate -Objekt zurück.