Delen via

Set-SCApplicationPackage

  • Referentie
Module:
VirtualMachineManager

Hiermee wijzigt u de eigenschappen van een toepassingspakket.

Syntaxis

Set-SCApplicationPackage
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-ApplicationPackage] <ApplicationPackage[]>
   [-EncryptionKey <PSCredential>]
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCApplicationPackage
   [-VMMServer <ServerConnection>]
   [-ApplicationPackage] <ApplicationPackage[]>
   [-SetAsEquivalent]
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

De cmdlet Set-SCApplicationPackage wijzigt de eigenschappen van een toepassingspakket dat is opgeslagen in de VMM-bibliotheek (Virtual Machine Manager).

Voorbeelden

Voorbeeld 1: De beschrijving voor een toepassingspakket bijwerken

PS C:\> $AppPackage = Get-SCApplicationPackage -Name "WebApp01.zip"
PS C:\> Set-SCApplicationPackage -ApplicationPackage $AppPackage -Description "Web application to install on a service."

Met de eerste opdracht wordt het toepassingspakketobject met de naam WebApp01.zip opgehaald en wordt het object opgeslagen in de variabele $AppPackage.

Met de tweede opdracht wordt de beschrijving voor WebApp01.zipbijgewerkt.

Parameters

-ApplicationPackage

Hiermee geeft u een matrix van toepassingspakketobjecten.

Type:ApplicationPackage[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Description

Geeft een beschrijving voor het opgegeven object.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Enabled

Hiermee schakelt u een object in wanneer dit is ingesteld op $True of schakelt u een object uit wanneer dit is ingesteld op $False. Als u bijvoorbeeld software wilt upgraden op een sjabloon voor virtuele machines, kunt u het sjabloonobject in de VMM-bibliotheek uitschakelen om tijdelijk te voorkomen dat gebruikers dat object gebruiken.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EncryptionKey

Hiermee geeft u referenties op die moeten worden gebruikt als een versleutelingssleutel wanneer u een Hyper-V host toevoegt die zich in een perimeternetwerk bevindt aan VMM.

Voorbeeldindeling: -SecurityFile "C:\SecurityFile.txt" -EncryptionKey $Key

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FamilyName

Hiermee geeft u een familienaam op voor een fysieke resource in de VMM-bibliotheek. Deze waarde wordt gebruikt in combinatie met Release, Naamruimte en Type om gelijkwaardigheid tussen bibliotheekbronnen tot stand te brengen.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Owner

Hiermee geeft u de eigenaar van een VMM-object in de vorm van een geldig domeingebruikersaccount.

  • Voorbeeldindeling: -Owner "Contoso\PattiFuller"
  • Voorbeeldindeling: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Release

Hiermee geeft u een tekenreeks op die de release van een bibliotheekresource beschrijft. VMM maakt automatisch een releasewaarde voor elke resource die in de bibliotheek is geïmporteerd. Nadat de resource is geïmporteerd, kan de tekenreeks worden aangepast.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SetAsEquivalent

Geeft aan dat de cmdlet meerdere toepassingspakketten als gelijkwaardig markeert.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SharePath

Hiermee geeft u een pad naar een geldige bibliotheekshare op een bestaande bibliotheekserver die gebruikmaakt van een UNC-pad (Universal Naming Convention).

Voorbeeldindeling: -SharePath "\\LibServer01\LibShare"

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UserRole

Hiermee geeft u een gebruikersrolobject.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

ApplicationPackage

Met deze cmdlet wordt een ApplicationPackage--object geretourneerd.