Freigeben über

Set-SCApplicationHostTemplate

Modul:
VirtualMachineManager Module

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

Syntax

Default (Standardwert) 

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

Mit dem Cmdlet Set-SCApplicationHostTemplate werden die Eigenschaften einer Anwendungshostvorlage konfiguriert, 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 mit dem Namen ServiceTemplate01 ab und speichert das Objekt in der Variablen $ServiceTemplate.

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

Mit dem letzten Befehl wird die description-Eigenschaft der Anwendungshostvorlage in $AppHostTemplate geändert.

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 mit dem Namen ServiceTemplate01 ab und speichert das Objekt in der Variablen $ServiceTemplate.

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

Mit dem letzten Befehl wird die name-Eigenschaft der in $AppHostTemplate gespeicherten Anwendungshostvorlage geändert. 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 Hostvorlage für Webanwendungen verwendet.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ApplicationHostTemplate

Gibt ein Vorlagenobjekt für den Anwendungshost an.

Parametereigenschaften

Typ:ApplicationHostTemplate
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ApplicationProfile

Gibt ein Anwendungsprofilobjekt an.

Parametereigenschaften

Typ:ApplicationProfile
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 Hostvorlage für Webanwendungen verwendet. Gültige Werte sind: NTLM und Basic.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ComputerName

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

  • FQDN (vollqualifizierter Domainname)
  • IPv4- oder IPv6-Adresse
  • NetBIOS-Name

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DeploymentOrder

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Description

Gibt eine Beschreibung für die Anwendungshostvorlage an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen eines VMM-Objekts an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Owner

Gibt die besitzende Person eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an.

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsAccount

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

Parametereigenschaften

Typ:VMMCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServicingOrder

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Site

Gibt die Website an, auf der alle zugeordneten Web Deploy-Pakete bereitgestellt werden. Dieser Parameter wird in Verbindung mit einer Hostvorlage für Webanwendungen verwendet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Tag

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

ApplicationHostTemplate

Dieses Cmdlet gibt ein ApplicationHostTemplate-Objekt zurück.