New-CMTSStepRunCommandLine
Erstellen Sie einen Befehlszeilenschritt ausführen, den Sie einer Tasksequenz hinzufügen können.
Syntax
New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-OutputVariableName <String>]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-OutputVariableName <String>]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Mit diesem Cmdlet wird ein neues Befehlszeilenschrittobjekt "Ausführen" erstellt. Verwenden Sie dann das Cmdlet "Add-CMTaskSequenceStep", um den Schritt einer Tasksequenz hinzuzufügen. Weitere Informationen zu diesem Schritt finden Sie unter Informationen zu den Schritten der Tasksequenz: Ausführen der Befehlszeile.
Hinweis
Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\>
aus. Weitere Informationen finden Sie unter "Erste Schritte".
Beispiele
Beispiel1
In diesem Beispiel wird zunächst ein Objekt für den Schritt "Befehlszeile ausführen" erstellt. Sie gibt die Befehlszeile und ein zu verwendende Paket an.
Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz bei Index 11 hinzu.
$step = New-CMTSStepRunCommandLine -Name "Run Command Line" -CommandLine "cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat" -PackageId "XYZ00821"
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
Parameter
-Bedingung
Geben Sie ein Bedingungsobjekt an, das für diesen Schritt verwendet werden soll. Um dieses Objekt abzurufen, verwenden Sie eines der Cmdlets für die Tasksequenzbedingung. Beispiel: Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandLine
Geben Sie die Befehlszeile an, über die die Tasksequenz ausgeführt wird. Schließen Sie Dateinamenerweiterungen ein, z. .exe
B. . Schließen Sie alle erforderlichen Einstellungsdateien und Befehlszeilenoptionen ein.
Beispiel: cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Fügen Sie diesen Parameter hinzu, um die Schrittoption "Continue on error" zu aktivieren. Wenn Sie diese Option aktivieren, wird die Tasksequenz fortgesetzt, wenn der Schritt fehlschlägt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWow64Redirection
Standardmäßig verwenden 64-Bit-Betriebssysteme den WOW64-Dateisystem-Redirector zum Ausführen von Befehlszeilen. Dieses Verhalten besteht darin, 32-Bit-Versionen von ausführbaren Betriebssystemen und Bibliotheken ordnungsgemäß zu finden. Fügen Sie diesen Parameter hinzu, um die Verwendung des WOW64-Dateisystem-Redirectors zu deaktivieren. Windows führt den Befehl mit nativen 64-Bit-Versionen von ausführbaren Betriebssystemversionen und Bibliotheken aus. Diese Option hat keine Auswirkung, wenn sie auf einem 32-Bit-Betriebssystem ausgeführt wird.
Type: | SwitchParameter |
Aliases: | DisableRedirectionFor64BitFileSystem |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputVariableName
Geben Sie den Namen einer benutzerdefinierten Tasksequenzvariablen an. Wenn Sie diesen Parameter verwenden, speichert der Schritt die letzten 1000 Zeichen der Befehlsausgabe in der Variablen.
Type: | String |
Aliases: | Output, OutputVariable |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageId
Wenn Sie Dateien oder Programme in der Befehlszeile angeben, die noch nicht auf dem Zielcomputer vorhanden sind, verwenden Sie diesen Parameter, um die Paket-ID für ein Paket anzugeben, das über die erforderlichen Dateien verfügt. Für das Paket ist kein Programm erforderlich. Wenn die angegebenen Dateien auf dem Zielcomputer vorhanden sind, ist diese Option nicht erforderlich.
Dieser Wert ist eine Standardpaket-ID, XYZ00821
z. B. .
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsUser
Fügen Sie diesen Parameter hinzu, um die Befehlszeile als Windows Benutzerkonto und nicht als lokales Systemkonto auszuführen. Verwenden Sie dann die Parameter UserName und UserPassword.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessCode
Geben Sie ein Array ganzzahliger Werte als Exitcodes aus dem Befehl an, den der Schritt als erfolgreich auswerten soll.
Type: | Int32[] |
Aliases: | SuccessCodes |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Timeout
Geben Sie einen ganzzahligen Wert an, der angibt, wie lange Configuration Manager die Ausführung der Befehlszeile zulässt. Dieser Wert kann zwischen 1
Minuten und 999
Minuten betragen. Der Standardwert ist 15
Minuten.
Wenn Sie einen Wert eingeben, der nicht genügend Zeit für den erfolgreichen Abschluss des angegebenen Befehls lässt, schlägt dieser Schritt fehl. Die gesamte Tasksequenz kann je nach Schritt- oder Gruppenbedingungen fehlschlagen. Wenn das Timeout abläuft, beendet Configuration Manager den Befehlszeilenprozess.
Type: | Int32 |
Aliases: | TimeoutInMinutes |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
Wenn Sie den Parameter RunAsUser verwenden, verwenden Sie diesen Parameter, um den Namen des Windows Benutzerkontos anzugeben. Verwenden Sie zum Angeben des Kontokennworts den Parameter "UserPassword".
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPassword
Wenn Sie den RunAsUser -Parameter verwenden, verwenden Sie diesen Parameter, um das Kennwort des Kontos anzugeben, das Sie mit UserNameangeben.
Type: | SecureString |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkingDirectory
Geben Sie den Ordner an, in dem der Befehl gestartet wird. Dieser Pfad kann bis zu 127 Zeichen lang sein.
Type: | String |
Aliases: | StartIn |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Keine
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_RunCommandLineAction Server-WMI-Klasse.