Delen via

Add-SCScriptCommand

Module:
VirtualMachineManager Module

Voegt een scriptopdracht toe aan een toepassingsprofiel, toepassingsimplementatie of hostprofiel.

Syntaxis

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

De cmdlet Add-SCScriptCommand voegt een scriptopdracht toe aan een toepassingsprofiel, toepassingsimplementatie of hostprofiel. Met een scriptopdracht kan een beheerder code uitvoeren tijdens implementatie- en onderhoudsbewerkingen.

Voorbeelden

Voorbeeld 1: Een scriptopdracht toevoegen aan een toepassingsprofiel

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

Met de eerste opdracht wordt het toepassingsprofielobject met de naam SvcWebAppProfile01 opgehaald en wordt het object opgeslagen in de variabele $AppProfile.

Met de tweede opdracht wordt een object gemaakt voor het instellen van de scriptopdracht waarmee de werkmap wordt ingesteld op Nettolading en wordt het object vervolgens opgeslagen in de variabele $ScriptSetting.

Met de laatste opdracht wordt een scriptopdracht vooraf toegevoegd aan het toepassingsprofiel dat is opgeslagen in $AppProfile.

Parameters

-ApplicationDeployment

Hiermee geeft u een implementatieobject voor de toepassing op.

Parametereigenschappen

Type:ApplicationDeployment
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ApplicationDeployment
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ApplicationProfile

Hiermee geeft u een toepassingsprofielobject op.

Parametereigenschappen

Type:ApplicationProfile
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ApplicationProfile
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-CommandParameters

Hiermee geeft u de parameters voor een script of uitvoerbaar programma op.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DeploymentOrder

Hiermee geeft u de volgorde op waarin een computerlaag, toepassingshost of toepassing wordt geïmplementeerd.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Executable

Hiermee geeft u de naam van een uitvoerbaar programma op.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

Parametereigenschappen

Type:Guid
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

PhysicalComputerProfile
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
JobGroup
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-LibraryResource

Hiermee geeft u een resource op die is opgeslagen in de VMM-bibliotheek (Virtual Machine Manager).

Parametereigenschappen

Type:CustomResource
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PhysicalComputerProfile

Hiermee geeft u een profiel op dat wordt gebruikt om een besturingssysteem op een computer te implementeren.

Parametereigenschappen

Type:PhysicalComputerProfile
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:VMHostProfiel

Parametersets

PhysicalComputerProfile
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:Guid
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RunAsAccount

Hiermee geeft u een Uitvoeren als-account op dat referenties bevat met toestemming om deze actie uit te voeren.

Parametereigenschappen

Type:VMMCredential
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-RunAsynchronously

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ScriptCommandSetting

Hiermee geeft u een object op voor het instellen van een scriptopdracht.

Parametereigenschappen

Type:SCScriptCommandSetting
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ScriptType

Hiermee geeft u een scripttype op. De acceptabele waarden voor deze parameter zijn:

  • Vooraf
  • Na installatie
  • Opslaan
  • Staat herstellen
  • Vooraf onderhoud
  • Postdienst
  • Vooraf verwijderen
  • BerichtVerwijderen
  • Besteld commando
  • BareMetalPostWinPERegistration
  • OnProvisionFirst
  • OnProvisionRest
  • OnDeleteLaatste
  • OnDeleteRest
  • Installeren
  • BareMetalPost-implementatie

Parametereigenschappen

Type:ScriptCommandType
Default value:None
Geaccepteerde waarden:PreService, PostService, SaveState, RestoreState, PreInstall, PostInstall, PreUninstall, PostUninstall, OrderedCommand, BareMetalPostWinPERegistration, OnProvisionFirst, OnProvisionRest, OnDeleteLast, OnDeleteRest, Install, BareMetalPostConfiguration, BareMetalPostUnattend
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-StandardInput

Hiermee geeft u een pad op naar een bestand dat standaardinvoergegevens bevat die moeten worden gebruikt met de scriptopdracht.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-TimeoutSeconds

Hiermee geeft u de hoeveelheid tijd (in seconden) op die een proces wacht voordat er een time-out optreedt.

Parametereigenschappen

Type:Int32
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-VMMServer

Hiermee geeft u een VMM-serverobject (Virtual Machine Manager) op.

Parametereigenschappen

Type:ServerConnection
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Uitvoerwaarden

ScriptCommand

Deze cmdlet retourneert een ScriptCommand-object .