Freigeben über


Set-SCApplicationProfile

Ändert die Eigenschaften eines Anwendungsprofils.

Syntax

Set-SCApplicationProfile
   [-VMMServer <ServerConnection>]
   [-ApplicationProfile] <ApplicationProfile>
   [-Name <String>]
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-Tag <String>]
   [-CompatibilityType <String>]
   [-EnforceCompatibilityType]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Set-SCApplicationProfile ändert die Eigenschaften eines Anwendungsprofils.

Beispiele

Beispiel 1: Ändern des Namens eines Anwendungsprofils

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> Set-SCApplicationProfile -ApplicationProfile $AppProfile -Name "StockWebApp"

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

Der zweite Befehl ändert den Namen des in $AppProfile gespeicherten Anwendungsprofilobjekts in StockWebApp.

Beispiel 2: Ändern der Beschreibung eines Anwendungsprofils

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "StockWebApp"
PS C:\> Set-SCApplicationProfile -ApplicationProfile $AppProfile -Description "Application profile to use when deploying the stock application web servers."

Der erste Befehl ruft das Anwendungsprofilobjekt mit dem Namen StockWebApp ab und speichert das Objekt in der variablen $AppProfile.

Der zweite Befehl ändert die Beschreibung des anwendungsprofilobjekts, das in $AppProfile gespeichert ist, in "Anwendungsprofil, das beim Bereitstellen der Webserver der Bestandsanwendung verwendet werden soll".

Parameter

-ApplicationProfile

Gibt ein Anwendungsprofilobjekt an.

Typ:ApplicationProfile
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-CompatibilityType

Gibt die Bereitstellungstypen an, mit denen ein Anwendungsprofil kompatibel ist. Die zulässigen Werte für diesen Parameter sind:

  • Allgemein
  • SQLApplicationHost
  • WebApplicationHost
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für das angegebene Objekt an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnforceCompatibilityType

Gibt an, dass Artefakte aus einem Anwendungsprofil, das nicht mit dem für den CompatibilityType Parameter bereitgestellten Wert kompatibel ist, entfernt werden.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines VMM-Objekts (Virtual Machine Manager) an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Owner

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

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Tag

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserRole

Gibt ein Benutzerrollenobjekt an.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False