Partager via


Set-SCApplicationPackage

Modifie les propriétés d’un package d’application.

Syntaxe

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

L’applet de commande set-SCApplicationPackage modifie les propriétés d’un package d’application stocké dans la bibliothèque Virtual Machine Manager (VMM).

Exemples

Exemple 1 : Mettre à jour la description d’un package d’application

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

La première commande obtient l’objet de package d’application nommé WebApp01.zip et stocke l’objet dans la variable $AppPackage.

La deuxième commande met à jour la description de WebApp01.zip.

Paramètres

-ApplicationPackage

Spécifie un tableau d’objets de package d’application.

Type:ApplicationPackage[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Description

Indique une description de l’objet spécifié.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Enabled

Active un objet lorsqu’il est défini sur $True ou désactive un objet lorsqu’il est défini sur $False. Par exemple, si vous souhaitez mettre à niveau des logiciels sur un modèle de machine virtuelle, vous pouvez désactiver l’objet de modèle dans la bibliothèque VMM pour empêcher temporairement les utilisateurs d’utiliser cet objet.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EncryptionKey

Spécifie les informations d’identification à utiliser comme clé de chiffrement lorsque vous ajoutez un hôte Hyper-V situé dans un réseau de périmètre à VMM.

Exemple de format : -SecurityFile "C:\SecurityFile.txt" -EncryptionKey $Key

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-FamilyName

Spécifie un nom de famille pour une ressource physique dans la bibliothèque VMM. Cette valeur est utilisée conjointement avec Release, Namespace et Type pour établir l’équivalence entre les ressources de bibliothèque.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un objet VMM.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Owner

Spécifie le propriétaire d’un objet VMM sous la forme d’un compte d’utilisateur de domaine valide.

  • Exemple de format : -Owner "Contoso\PattiFuller"
  • Exemple de format : -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Release

Spécifie une chaîne qui décrit la mise en production d’une ressource de bibliothèque. VMM crée automatiquement une valeur de mise en production pour chaque ressource importée dans la bibliothèque. Une fois la ressource importée, la chaîne peut être personnalisée.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SetAsEquivalent

Indique que l’applet de commande marque plusieurs packages d’application comme équivalents.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SharePath

Spécifie un chemin d’accès à un partage de bibliothèque valide sur un serveur de bibliothèque existant qui utilise un chemin UNC (Universal Naming Convention).

Exemple de format : -SharePath "\\LibServer01\LibShare"

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserRole

Spécifie un objet de rôle d’utilisateur.

Type:UserRole
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Sorties

ApplicationPackage

Cette applet de commande retourne un objet ApplicationPackage.