# LibTmux\Remove-TmuxEnvironment - **Package:** LibTmux - **Language:** PowerShell - **Kind:** function - **Source:** https://github.com/libtmux/libtmux-powershell/blob/b06c64f844f3173de66b187eaeaf3915814318c6/src/LibTmux.PowerShell/RemoveTmuxEnvironmentCommand.cs#L7 - **Page:** https://libtmux.org/en/powershell/latest/reference/libtmux-remove-tmuxenvironment/ ``` Server (default): Remove-TmuxEnvironment [-Server] -Name [-MarkRemoved] [-WhatIf] [-Confirm] [] Session: Remove-TmuxEnvironment [-Session] -Name [-MarkRemoved] [-WhatIf] [-Confirm] [] ``` [`Unset`](/en/csharp/latest/reference/libtmux-sethookrequest-unset/) an environment entry or keep an explicit removal marker. By default, forget the entry using tmux set-environment -u. Unsetting a session entry allows a global value to apply to future panes again. MarkRemoved instead uses -r: tmux retains a removal marker to suppress the variable in future pane processes. Neither operation is equivalent to setting an empty string. [`WhatIf`](/en/powershell/latest/reference/libtmux-remove-tmuxenvironment/#LibTmux%5CRemove-TmuxEnvironment.parameter.WhatIf) performs no tmux I/O. ### Notes A [`Server`](/en/csharp/latest/reference/libtmux-server/) selects the global environment; a [`Session`](/en/csharp/latest/reference/libtmux-session/) selects its local environment. Reads do not merge those tables. Changes affect newly created processes and do not rewrite the environment of an existing pane process. Empty owner pipelines do no I/O. Errors retain the original exception and owner; Continue permits later owners and Stop terminates. Cancellation cannot undo a dispatched mutation. ## Command details - **Command type:** [`cmdlet`](/en/powershell/latest/reference/glossary/#cmdlet) - **Default parameter set:** Server - **Confirmation:** Supports `-WhatIf` and `-Confirm`; confirm impact: Medium. - **Positional binding:** Enabled. - **Pipeline inputs:** `LibTmux.Server`: A native server owner.; `LibTmux.Session`: A native session owner. - **Outputs:** `System.Void` Related APIs: - [Environment](https://github.com/libtmux/libtmux-powershell/blob/b06c64f844f3173de66b187eaeaf3915814318c6/docs/environment.md) ## Examples Example 1 Prevent future processes in a native $session from inheriting APP_MODE. [Source example](https://github.com/libtmux/libtmux-powershell/blob/b06c64f844f3173de66b187eaeaf3915814318c6/docs/reference/LibTmux/Remove-TmuxEnvironment.md). ```powershell $session | LibTmux\Remove-TmuxEnvironment -Name 'APP_MODE' -MarkRemoved ``` ## Parameters - `Server` (`LibTmux.Server`): The native server whose table is used. (for `Server`) Required. Position 0. Accepts pipeline input by value. [`ValidateNotNull()`](https://learn.microsoft.com/dotnet/api/system.management.automation.validatenotnullattribute?view=powershellsdk-7.4.0). - `Name` (`System.String`): The environment variable name. Omit Name on Get to list this table. Whitespace-only names and NUL are rejected. Required. Named parameter. Does not accept pipeline input. [`ValidateNotNullOrEmpty()`](https://learn.microsoft.com/dotnet/api/system.management.automation.validatenotnulloremptyattribute?view=powershellsdk-7.4.0). [`ValidatePattern("\\A[^\\x00]*[^\\s\\x00][^\\x00]*\\z")`](https://learn.microsoft.com/dotnet/api/system.management.automation.validatepatternattribute?view=powershellsdk-7.4.0). - `MarkRemoved` (`System.Management.Automation.SwitchParameter`): Keep a removal marker to suppress inherited values in new child processes instead of forgetting the entry. Optional. Named parameter. Switch parameter. Does not accept pipeline input. - `Verbose` (`System.Management.Automation.SwitchParameter`): Display verbose messages produced by this command. Optional. Named parameter. Switch parameter. Common parameter. Does not accept pipeline input. Aliases: `vb`. - `Debug` (`System.Management.Automation.SwitchParameter`): Display debug messages produced by this command. Optional. Named parameter. Switch parameter. Common parameter. Does not accept pipeline input. Aliases: `db`. - `ErrorAction` (`System.Management.Automation.ActionPreference`): Choose how this command responds to non-terminating errors. Optional. Named parameter. Common parameter. Does not accept pipeline input. Aliases: `ea`. - `WarningAction` (`System.Management.Automation.ActionPreference`): Choose how this command responds to warning messages. Optional. Named parameter. Common parameter. Does not accept pipeline input. Aliases: `wa`. - `InformationAction` (`System.Management.Automation.ActionPreference`): Choose how this command handles information messages. Optional. Named parameter. Common parameter. Does not accept pipeline input. Aliases: `infa`. - `ProgressAction` (`System.Management.Automation.ActionPreference`): Choose how this command handles progress updates. Optional. Named parameter. Common parameter. Does not accept pipeline input. Aliases: `proga`. - `ErrorVariable` (`System.String`): Store the command's error records in the named variable. Optional. Named parameter. Common parameter. Does not accept pipeline input. Aliases: `ev`. - `WarningVariable` (`System.String`): Store the command's warning records in the named variable. Optional. Named parameter. Common parameter. Does not accept pipeline input. Aliases: `wv`. - `InformationVariable` (`System.String`): Store the command's information records in the named variable. Optional. Named parameter. Common parameter. Does not accept pipeline input. Aliases: `iv`. - `OutVariable` (`System.String`): Save output in the named variable while passing it down the pipeline. Optional. Named parameter. Common parameter. Does not accept pipeline input. Aliases: `ov`. - `OutBuffer` (`System.Int32`): Buffer output before passing it to the next pipeline command. Optional. Named parameter. Common parameter. Does not accept pipeline input. Aliases: `ob`. - `PipelineVariable` (`System.String`): Make the most recent output object available through a named variable within the pipeline. Optional. Named parameter. Common parameter. Does not accept pipeline input. Aliases: `pv`. - `WhatIf` (`System.Management.Automation.SwitchParameter`): Show the selected owner, scope and operation without contacting tmux. Optional. Named parameter. Switch parameter. Does not accept pipeline input. Aliases: `wi`. - `Confirm` (`System.Management.Automation.SwitchParameter`): Ask for confirmation before changing the selected table. Optional. Named parameter. Switch parameter. Does not accept pipeline input. Aliases: `cf`. - `Session` (`LibTmux.Session`): The native session whose table is used. (for `Session`) Required. Position 0. Accepts pipeline input by value. [`ValidateNotNull()`](https://learn.microsoft.com/dotnet/api/system.management.automation.validatenotnullattribute?view=powershellsdk-7.4.0). ## Returns `None`: No success output.