Partager via

Add-SCScriptCommand

Module:
VirtualMachineManager Module

Ajoute une commande de script à un profil d’application, à un déploiement d’application ou à un profil d’hôte.

Syntaxe

ApplicationProfile 

Add-SCScriptCommand
    -ApplicationProfile <ApplicationProfile>
    -ScriptType <ScriptCommandType>
    [-Executable <String>]
    [-CommandParameters <String>]
    [-ScriptCommandSetting <SCScriptCommandSetting>]
    [-TimeoutSeconds <Int32>]
    [-StandardInput <String>]
    [-LibraryResource <CustomResource>]
    [-RunAsAccount <VMMCredential>]
    [-VMMServer <ServerConnection>]
    [-DeploymentOrder <Int32>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

ApplicationDeployment 

Add-SCScriptCommand
    -ApplicationDeployment <ApplicationDeployment>
    -ScriptType <ScriptCommandType>
    [-Executable <String>]
    [-CommandParameters <String>]
    [-ScriptCommandSetting <SCScriptCommandSetting>]
    [-TimeoutSeconds <Int32>]
    [-StandardInput <String>]
    [-LibraryResource <CustomResource>]
    [-RunAsAccount <VMMCredential>]
    [-VMMServer <ServerConnection>]
    [-DeploymentOrder <Int32>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

PhysicalComputerProfile 

Add-SCScriptCommand
    -PhysicalComputerProfile <PhysicalComputerProfile>
    -ScriptType <ScriptCommandType>
    [-Executable <String>]
    [-CommandParameters <String>]
    [-ScriptCommandSetting <SCScriptCommandSetting>]
    [-TimeoutSeconds <Int32>]
    [-StandardInput <String>]
    [-LibraryResource <CustomResource>]
    [-RunAsAccount <VMMCredential>]
    [-VMMServer <ServerConnection>]
    [-JobGroup <Guid>]
    [-DeploymentOrder <Int32>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

JobGroup 

Add-SCScriptCommand
    -ScriptType <ScriptCommandType>
    [-Executable <String>]
    [-CommandParameters <String>]
    [-ScriptCommandSetting <SCScriptCommandSetting>]
    [-TimeoutSeconds <Int32>]
    [-StandardInput <String>]
    [-LibraryResource <CustomResource>]
    [-RunAsAccount <VMMCredential>]
    [-VMMServer <ServerConnection>]
    [-JobGroup <Guid>]
    [-DeploymentOrder <Int32>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

L’applet de commande Add-SCScriptCommand ajoute une commande de script à un profil d’application, à un déploiement d’application ou à un profil d’hôte. Une commande de script permet à un administrateur d’exécuter du code pendant les opérations de déploiement et de maintenance.

Exemples

Exemple 1 : Ajouter une commande de script à un profil d’application

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ScriptSetting = New-SCScriptCommandSetting -WorkingDirectory "Working_Folder_01"
PS C:\> Add-SCScriptCommand -ApplicationProfile $AppProfile -Executable "Startup.ps1" -ScriptType "PreInstall" -ScriptCommandSetting $ScriptSetting -TimeoutSeconds 120

La première commande récupère l’objet de profil d’application nommé SvcWebAppProfile01 et stocke l’objet dans la variable $AppProfile.

La deuxième commande crée un objet de définition de commande de script qui définit le répertoire de travail sur Payload, puis stocke l’objet dans la variable $ScriptSetting.

La dernière commande ajoute une commande de script de préinstallation au profil d’application stocké dans $AppProfile.

Paramètres

-ApplicationDeployment

Spécifie un objet de déploiement d’application.

Propriétés du paramètre

Type:ApplicationDeployment
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ApplicationDeployment
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ApplicationProfile

Spécifie un objet de profil d’application.

Propriétés du paramètre

Type:ApplicationProfile
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ApplicationProfile
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-CommandParameters

Spécifie les paramètres d’un script ou d’un programme exécutable.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DeploymentOrder

Spécifie l’ordre dans lequel une couche ordinateur, un hôte d’application ou une application est déployé.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Executable

Spécifie le nom d’un programme exécutable.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-JobGroup

Spécifie un identificateur pour une série de commandes qui s’exécute en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.

Propriétés du paramètre

Type:Guid
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

PhysicalComputerProfile
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
JobGroup
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-JobVariable

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LibraryResource

Spécifie une ressource stockée dans la bibliothèque Virtual Machine Manager (VMM).

Propriétés du paramètre

Type:CustomResource
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PhysicalComputerProfile

Spécifie un profil utilisé pour déployer un système d’exploitation sur un ordinateur.

Propriétés du paramètre

Type:PhysicalComputerProfile
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:VMHostProfile

Jeux de paramètres

PhysicalComputerProfile
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Guid
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RunAsAccount

Spécifie un compte d’identification qui contient des informations d’identification avec l’autorisation d’effectuer cette action.

Propriétés du paramètre

Type:VMMCredential
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ScriptCommandSetting

Spécifie un objet de définition de commande de script.

Propriétés du paramètre

Type:SCScriptCommandSetting
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ScriptType

Spécifie un type de script. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Préinstaller
  • Post-installation
  • SaveState
  • RestaurerÉtat
  • Avant le service
  • Service postal
  • Pré-désinstallation
  • PostDésinstaller
  • Commandecommandée
  • BareMetalPostWinPERégistration
  • OnProvisionFirst
  • OnProvisionRest
  • OnDeleteLast
  • OnDeleteRest
  • Installez
  • BareMetalPostDeployment

Propriétés du paramètre

Type:ScriptCommandType
Valeur par défaut:None
Valeurs acceptées:PreService, PostService, SaveState, RestoreState, PreInstall, PostInstall, PreUninstall, PostUninstall, OrderedCommand, BareMetalPostWinPERegistration, OnProvisionFirst, OnProvisionRest, OnDeleteLast, OnDeleteRest, Install, BareMetalPostConfiguration, BareMetalPostUnattend
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StandardInput

Spécifie le chemin d’accès à un fichier contenant des informations d’entrée standard à utiliser avec la commande script.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-TimeoutSeconds

Spécifie la durée, en secondes, pendant laquelle un processus attend avant d’expirer.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VMMServer

Spécifie un objet serveur Virtual Machine Manager (VMM).

Propriétés du paramètre

Type:ServerConnection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Sorties

ScriptCommand

Cette applet de commande retourne un objet ScriptCommand .