Help voor de opdrachtregel PowerShell.exePowerShell.exe Command-Line Help

een Windows PowerShell-sessie.a Windows PowerShell session. U kunt PowerShell.exe gebruiken een PowerShell-sessie starten vanaf de opdrachtregel van een ander hulpprogramma, zoals Cmd.exe of op de PowerShell-opdrachtregel gebruiken om een nieuwe sessie te starten.You can use PowerShell.exe to start a PowerShell session from the command line of another tool, such as Cmd.exe, or use it at the PowerShell command line to start a new session. Gebruik de parameters voor het aanpassen van de sessie.Use the parameters to customize the session.

SyntaxisSyntax

PowerShell[.exe]
       [-Command { - | <script-block> [-args <arg-array>]
                     | <string> [<CommandParameters>] } ]
       [-EncodedCommand <Base64EncodedCommand>]
       [-ExecutionPolicy <ExecutionPolicy>]
       [-File <FilePath> [<Args>]]
       [-InputFormat {Text | XML}] 
       [-Mta]
       [-NoExit]
       [-NoLogo]
       [-NonInteractive] 
       [-NoProfile] 
       [-OutputFormat {Text | XML}] 
       [-PSConsoleFile <FilePath> | -Version <PowerShell version>]
       [-Sta]
       [-WindowStyle <style>]


PowerShell[.exe] -Help | -? | /?

ParametersParameters

-EncodedCommand-EncodedCommand

Een base 64 gecodeerde tekenreeksversie van een opdracht accepteert.Accepts a base-64-encoded string version of a command. Gebruik deze parameter om opdrachten naar PowerShell waarvoor complexe aanhalingstekens of accolades verzenden.Use this parameter to submit commands to PowerShell that require complex quotation marks or curly braces.

-ExecutionPolicy-ExecutionPolicy

Hiermee stelt u het standaarduitvoeringsbeleid voor de huidige sessie en opgeslagen in de $env: PSExecutionPolicyPreference-omgevingsvariabele.Sets the default execution policy for the current session and saves it in the $env:PSExecutionPolicyPreference environment variable. Deze parameter wordt de PowerShell-uitvoeringsbeleid dat is ingesteld in het register niet gewijzigd.This parameter does not change the PowerShell execution policy that is set in the registry. Zie voor meer informatie over de uitvoeringsbeleidsregels PowerShell, waaronder een lijst met geldige waarden about_Execution_Policies (http://go.microsoft.com/fwlink/?LinkID=135170).For information about PowerShell execution policies, including a list of valid values, see about_Execution_Policies (http://go.microsoft.com/fwlink/?LinkID=135170).

-Bestand [ ]-File []

Voert het opgegeven script in het lokale bereik ('dot-afkomstig'), zodat de functies en variabelen die het script maakt beschikbaar in de huidige sessie zijn.Runs the specified script in the local scope ("dot-sourced"), so that the functions and variables that the script creates are available in the current session. Geef het pad naar het script en parameters.Enter the script file path and any parameters. Bestand moet de laatste parameter in de opdracht, omdat alle tekens worden ingevoerd na de bestand parameternaam worden geïnterpreteerd als het script bestandspad gevolgd door de scriptparameters en hun waarden.File must be the last parameter in the command, because all characters typed after the File parameter name are interpreted as the script file path followed by the script parameters and their values.

U kunt de parameters van een script en parameterwaarden, opnemen in de waarde van de bestand parameter.You can include the parameters of a script, and parameter values, in the value of the File parameter. Bijvoorbeeld: -File .\Get-Script.ps1 -Domain Central opmerking die parameters doorgegeven aan het script worden doorgegeven als letterlijke tekenreeksen (na interpretatie door de huidige shell).For example: -File .\Get-Script.ps1 -Domain Central Note that parameters passed to the script are passed as literal strings (after interpretation by the current shell). Bijvoorbeeld, als u in cmd.exe en wilt doorgeven van een omgevingsvariabele, gebruikt u de syntaxis van de cmd.exe: powershell -File .\test.ps1 -Sample %windir% als u zou gebruiken van PowerShell-syntaxis, wordt in dit voorbeeld uw script de letterlijke waarde ontvangt ' $env: windir ' en niet de waarde van die omgevingsvariabele:powershell -File .\test.ps1 -Sample $env:windirFor example, if you are in cmd.exe and want to pass an environment variable value, you would use the cmd.exe syntax: powershell -File .\test.ps1 -Sample %windir% If you were to use PowerShell syntax, then in this example your script would receive the literal "$env:windir" and not the value of that environmental variable: powershell -File .\test.ps1 -Sample $env:windir

Normaal gesproken worden de switch-parameters van een script opgenomen of weggelaten.Typically, the switch parameters of a script are either included or omitted. Bijvoorbeeld de volgende opdracht maakt gebruik van de alle parameter van het scriptbestand Get-Script.ps1:-File .\Get-Script.ps1 -AllFor example, the following command uses the All parameter of the Get-Script.ps1 script file: -File .\Get-Script.ps1 -All

-InputFormat {tekst | XML}-InputFormat {Text | XML}

Beschrijft de indeling van gegevens die worden verzonden naar PowerShell.Describes the format of data sent to PowerShell. Geldige waarden zijn 'Text' (tekenreeksen) of 'XML' (geserialiseerde CLIXML-indeling).Valid values are "Text" (text strings) or "XML" (serialized CLIXML format).

-Mta-Mta

Start PowerShell met een apartment met meerdere threads.Starts PowerShell using a multi-threaded apartment. Deze parameter is geïntroduceerd in PowerShell 3.0.This parameter is introduced in PowerShell 3.0. PowerShell 3.0 is single thread apartment (STA) de standaardinstelling.In PowerShell 3.0, single-threaded apartment (STA) is the default. In PowerShell 2.0 is met meerdere threads MTA (apartment) de standaardinstelling.In PowerShell 2.0, multi-threaded apartment (MTA) is the default.

-NoExit-NoExit

Bestaat niet na het starten van de opdrachten uit te voeren.Does not exit after running startup commands.

Hiermee verbergt het vaandel met copyright bij het opstarten.Hides the copyright banner at startup.

-Niet-interactieve-NonInteractive

Biedt een interactieve prompt niet aanwezig voor de gebruiker.Does not present an interactive prompt to the user.

-NoProfile-NoProfile

Het PowerShell-profiel niet geladen.Does not load the PowerShell profile.

-OutputFormat {tekst | XML}-OutputFormat {Text | XML}

Hiermee wordt bepaald hoe de uitvoer van PowerShell is geformatteerd.Determines how output from PowerShell is formatted. Geldige waarden zijn 'Text' (tekenreeksen) of 'XML' (geserialiseerde CLIXML-indeling).Valid values are "Text" (text strings) or "XML" (serialized CLIXML format).

-PSConsoleFile-PSConsoleFile

Laadt het opgegeven bestand van de PowerShell-console.Loads the specified PowerShell console file. Geef het pad en de naam van het consolebestand.Enter the path and name of the console file. Gebruik voor het maken van een consolebestand de Export Console cmdlet in PowerShell.To create a console file, use the Export-Console cmdlet in PowerShell.

-Sta-Sta

Start PowerShell met een apartment met één thread bevindt.Starts PowerShell using a single-threaded apartment. PowerShell 3.0 is single thread apartment (STA) de standaardinstelling.In PowerShell 3.0, single-threaded apartment (STA) is the default. In PowerShell 2.0 is met meerdere threads MTA (apartment) de standaardinstelling.In PowerShell 2.0, multi-threaded apartment (MTA) is the default.

-Versie-Version

Hiermee start u de opgegeven versie van PowerShell.Starts the specified version of PowerShell. De versie die u opgeeft moet worden geïnstalleerd op het systeem.The version that you specify must be installed on the system. Als PowerShell 3.0 is geïnstalleerd op de computer, wordt de geldige waarden zijn '2.0' en '3.0'.If PowerShell 3.0 is installed on the computer, valid values are "2.0" and "3.0". De standaardwaarde is '3.0'.The default value is "3.0".

Als PowerShell 3.0 niet is geïnstalleerd, is de enige geldige waarde '2.0'.If PowerShell 3.0 is not installed, the only valid value is "2.0". Andere waarden worden genegeerd.Other values are ignored.

Zie voor meer informatie "PowerShell installeren" in de aan de slag met PowerShell [oude MSDN].For more information, see "Installing PowerShell" in the Getting Started with PowerShell [OLD MSDN].

-Vensterstijl-WindowStyle

Hiermee stelt de vensterstijl voor de sessie.Sets the window style for the session. Geldige waarden zijn standaard, geminimaliseerd, gemaximaliseerd en verborgen.Valid values are Normal, Minimized, Maximized and Hidden.

-Opdracht-Command

Voert de opgegeven opdrachten (en eventuele parameters) alsof ze zijn getypt achter de PowerShell-opdrachtprompt en vervolgens wordt afgesloten, tenzij de parameter NoExit is opgegeven.Executes the specified commands (and any parameters) as though they were typed at the PowerShell command prompt, and then exits, unless the NoExit parameter is specified. In wezen elke tekst na -Command wordt verzonden als een enkele opdrachtregel naar PowerShell (dit verschilt van het -File omgaat met parameters die worden verzonden naar een script).Essentially, any text after -Command is sent as a single command line to PowerShell (this is different from how -File handles parameters sent to a script).

De waarde van de opdracht kan niet '-', een tekenreeks.The value of Command can be "-", a string. of een scriptblok is opgegeven.or a script block. Als de waarde van de opdracht '-', de opdrachttekst is gelezen uit standaard invoer.If the value of Command is "-", the command text is read from standard input.

Scriptblokken moeten tussen accolades ({}) worden geplaatst.Script blocks must be enclosed in braces ({}). U kunt een scriptblok opgeven, alleen wanneer PowerShell.exe uitgevoerd in PowerShell.You can specify a script block only when running PowerShell.exe in PowerShell. De resultaten van het script worden geretourneerd aan de bovenliggende shell als gedeserialiseerde XML-objecten die niet live objecten.The results of the script are returned to the parent shell as deserialized XML objects, not live objects.

Als de waarde van de opdracht een tekenreeks is, opdracht moet de laatste parameter in de opdracht, omdat alle tekens worden ingevoerd nadat de opdracht als de opdrachtargumenten worden geïnterpreteerd.If the value of Command is a string, Command must be the last parameter in the command, because any characters typed after the command are interpreted as the command arguments.

Gebruik de notatie voor het schrijven van een tekenreeks die wordt uitgevoerd een PowerShell-opdracht:To write a string that runs a PowerShell command, use the format:

"& {<command>}"

waar de aanhalingstekens geven een tekenreeks en de operator invoke (&) zorgt ervoor dat de opdracht om te worden uitgevoerd.where the quotation marks indicate a string and the invoke operator (&) causes the command to be executed.

-Help-,?, /?-Help, -?, /?

Dit bericht bevat.Shows this message. Als u een opdracht PowerShell.exe in PowerShell typt, voeg de opdrachtparameters met een afbreekstreepje (-), niet een slash (/).If you are typing a PowerShell.exe command in PowerShell, prepend the command parameters with a hyphen (-), not a forward slash (/). U kunt een koppelteken of een slash in Cmd.exe.You can use either a hyphen or forward slash in Cmd.exe.

Notitie

Opmerking voor probleemoplossing: In PowerShell 2.0 beginnen enkele programma's in de Windows PowerShell console is mislukt met een LastExitCode van 0xc0000142.Troubleshooting Note: In PowerShell 2.0, starting some programs in the Windows PowerShell console fails with a LastExitCode of 0xc0000142.

VOORBEELDENEXAMPLES

# Create a new PowerShell session and load a saved console file
PowerShell -PSConsoleFile sqlsnapin.psc1

# Create a new PowerShell V2 session with text input, XML output, and no logo
PowerShell -Version 2.0 -NoLogo -InputFormat text -OutputFormat XML

# Execute a Powerhell Command in a session
PowerShell -Command "Get-EventLog -LogName security"

# Run a script block in a session
PowerShell -Command {Get-EventLog -LogName security}

# An alternate wayh to run a command in a new session
PowerShell -Command "& {Get-EventLog -LogName security}"

# To use the -EncodedCommand parameter:
$command = "dir 'c:\program files' "
$bytes = [System.Text.Encoding]::Unicode.GetBytes($command)
$encodedCommand = [Convert]::ToBase64String($bytes)
powershell.exe -encodedCommand $encodedCommand