Add-SCApplicationHostTemplate

  • Referenz
Modul:
VirtualMachineManager

Fügt einer Dienstvorlage eine Anwendungshostvorlage hinzu.

Syntax

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

Beschreibung

Das Cmdlet "Add-SCApplicationHostTemplate " fügt einer Dienstvorlage eine Anwendungshostvorlage hinzu. Eine Anwendungshostvorlage wird verwendet, um eine SQL-Datenebenenanwendung (DAC) auf einem bereitgestellten SQL-Server oder einem Web Deploy-Paket auf einem unterstützten Webanwendungshost bereitzustellen.

Beispiele

Beispiel 1: Hinzufügen einer SQL-Anwendungshostvorlage zu einer Dienstvorlage

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> Add-SCApplicationHostTemplate -Name "SQL Application Host" -ComputerName "SQLServer01.Contoso.com" -ApplicationProfile $AppProfile -ServiceTemplate $ServiceTemplate

Der erste Befehl ruft das Aplizierungsprofilobjekt namens SvcWebAppProfile01 ab und speichert das Objekt in der $AppProfile Variablen.

Der zweite Befehl ruft das Dienst-temnplate-Objekt namens ServiceTemplate01 ab und speichert das Objekt in der $ServiceTemplate Variablen.

Der dritte Befehl fügt der in $ServiceTemplate gespeicherten Dienstvorlage eine Anwendungshostvorlage hinzu.

Beispiel 2: Hinzufügen einer Webanwendungshostvorlage zu einer Dienstvorlage

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "WebAppProfile01"
PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> $WebRAA = Get-SCRunAsAccount -Name "IIS Site Admin"
PS C:\> $WebAppHostTemplate = Add-SCApplicationHostTemplate -Name "Web Farm" -ServiceTemplate $ServiceTemplate -ApplicationProfile -$AppProfile -ComputerName "@Web Server@" -DeploymentOrder 2 -WebAppHost -Port 8172 -Site "Default Web Site" -AuthenticationType "NTLM" -AllowUntrustedServerCertificate -RunAsAccount $WebRAA

Der erste Befehl ruft das aplizierungsprofilobjekt mit dem Namen WebAppProfile01 ab und speichert das Objekt in der $AppProfile Variablen.

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

Der dritte Befehl ruft das Run As Account -Objekt namens IIS Site Admin ab und speichert das Objekt in der $WebRAA Variablen.

Der letzte Befehl fügt der in $ServiceTemplate gespeicherten Dienstvorlage eine Webanwendungshostvorlage hinzu (in diesem Fall ServiceTemplate01).

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

-ApplicationProfile

Gibt ein Anwendungsprofilobjekt an.

Type:ApplicationProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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:True
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:0
Default value:None
Required:True
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:True
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

-ServiceTemplate

Gibt ein Dienstvorlagenobjekt an.

Type:ServiceTemplate
Position:Named
Default value:None
Required:True
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:True
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

-WebApplicationHost

Gibt an, dass die Anwendungshostvorlage für einen Webanwendungshost verwendet wird.

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

Ausgaben

ApplicationHostTemplate

Dieses Cmdlet gibt ein ApplicationHostTemplate -Objekt zurück.