Function run_powershell_command

utilities/util_powershell_handler.py:124–216

(
    command: Union[str, Sequence[str]],
    *,
    monitor_output: bool = False,
    termination_str: Optional[str] = None,
    cancel_event: Optional[threading.Event] = None,
    allow_continue_on_fail: bool = False,
)

def run_powershell_command(
    command: Union[str, Sequence[str]],
    *,
    monitor_output: bool = False,
    termination_str: Optional[str] = None,
    cancel_event: Optional[threading.Event] = None,
    allow_continue_on_fail: bool = False,
) -> int:
    if not isinstance(command, str):
        command = "".join(command)
    cmd = [
        "powershell.exe",
        "-NoProfile",
        "-ExecutionPolicy",
        "Bypass",
        "-Command",
        command,
    ]
    logger.info(f"Launching PowerShell command: {command}")
    creationflags = 0
    try:
        proc = subprocess.Popen(
            cmd,
            stdout=subprocess.PIPE,
            stderr=subprocess.PIPE,
            text=True,
            encoding="utf-8",
            errors="replace",
            bufsize=1,
            creationflags=creationflags,
        )
    except Exception as e:
        logger.exception(f"Failed to start PowerShell command: {e}")
        show_error_popup(
            t("errors.powershell_launch_failed", {"error": e}),
            allow_continue=allow_continue_on_fail,
        )
        raise
    termination_detected = False



    def _stream(pipe, log_fn, label):
        nonlocal termination_detected
        for line in iter(pipe.readline, ""):
            text = line.rstrip()
            log_fn(f"PCOMMAND {label}: {text}")
            if monitor_output and termination_str and termination_str in text:
                logger.info(f"Termination string '{termination_str}' detected.")
                termination_detected = True
                try:
                    proc.terminate()
                except Exception:
                    pass
                break
        pipe.close()
    threads = []
    for pipe, fn, lbl in (