Delen via


Set-SCApplicationPackage

Hiermee wijzigt u de eigenschappen van een toepassingspakket.

Syntax

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 $AppPackage variabele.

Met de tweede opdracht wordt de beschrijving voor WebApp01.zip bijgewerkt.

Parameters

-ApplicationPackage

Hiermee geeft u een matrix van toepassingspakketobjecten.

Type:ApplicationPackage[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Description

Geeft een beschrijving weer voor het opgegeven object.

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

-Enabled

Hiermee schakelt u een object in wanneer deze is ingesteld op $True of schakelt u een object uit wanneer dit is ingesteld op $False. Als u bijvoorbeeld software wilt upgraden op een virtuele-machinesjabloon, 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionKey

Hiermee geeft u referenties moet worden gebruikt als een versleutelingssleutel wanneer u een Hyper-V-host in een perimeternetwerk toevoegt aan VMM.

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van een VMM-object.

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

-Owner

Geeft de eigenaar van een VMM-object aan in de vorm van een geldig domeingebruikersaccount.

  • Voorbeeldindeling: -Owner "Contoso\PattiFuller"
  • Voorbeeldindeling: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SetAsEquivalent

Geeft aan dat de cmdlet meerdere toepassingspakketten markeert als gelijkwaardig.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

Hiermee geeft u een gebruikersrolobject.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

ApplicationPackage

Deze cmdlet retourneert een ApplicationPackage-object .