Switch-Process

Module:

Microsoft.PowerShell.Core Module

On Linux and macOS, the cmdlet calls the execv() function to provide similar behavior as POSIX shells.

Syntaxe

Default (Par défaut)

Switch-Process
    [[-WithCommand] <String[]>]
    [<CommonParameters>]

Description

Some native Unix commands shell out to run something (like ssh) and use the bash built-in command exec to spawn a new process that replaces the current one. By default, exec isn't a valid command in PowerShell. This is affecting some known scripts like copy-ssh-id and some subcommands of AzCLI.

The Switch-Process cmdlet calls the native execv() function to provide similar behavior as POSIX shells. This cmdlet and its alias, exec, were added in PowerShell 7.3.0.

PowerShell 7.3.1 changed the exec alias to a function that wraps Switch-Process. The function allows you to pass parameters to the native command that might have erroneously bound to the WithCommand parameter.

This cmdlet is only available for non-Windows systems.

Exemples

Example 1 - Execute a command that depends on `exec`

This example assumes that PowerShell is the default shell on a non-Windows system. ssh-copy-id is a popular bash script to deploy public keys on target machines for key-based authentication. The script depends on the bash command, exec.

ssh-copy-id user@host

With the PSExec feature enabled, the ssh-copy-id script succeeds.

Paramètres

-WithCommand

Specifies the native executable (and any parameters) to be run. All additional values passed as arguments are passed as an array of strings to be executed with the first command.

The target command must be a native executable, not a PowerShell command.

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:	0
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Entrées

String

Sorties

Object

Notes

The Switch-Process cmdlet was created to provide exec compatibility is other POSIX shells. Under normal conditions, the cmdlet isn't intended to be used in PowerShell scripts. Switch-Process doesn't have feature parity with the built-in exec function in POSIX shells, such as like how file descriptors are handled, but should cover most cases.