# Inspect attached clients

Source: https://libtmux.org/en/powershell/latest/guides/clients/

> Inspect attached clients: LibTmux documentation.

Read the terminal and control clients already attached to a selected native
`$server`. A plain server handle does not attach a client or own its lifetime.

<!-- example: clients.read -->
```powershell
$server | Get-TmuxClient
```

Results are native [`Client`](<https://libtmux.org/en/csharp/latest/reference/libtmux-client/>) objects with [`Name`][client-name],
[`Tty`][client-tty], [`IsControlClient`](<https://libtmux.org/en/csharp/latest/reference/libtmux-client-iscontrolclient/>), [`AttachedSessionId`](<https://libtmux.org/en/csharp/latest/reference/libtmux-client-attachedsessionid/>) and
[`Generation`][client-generation]. `-Name` selects an exact, case-sensitive
name; it does not interpret wildcards. No clients or no match produces no
objects. An unavailable server produces an error.

Captured fields stay unchanged when a client switches sessions. Refresh a
previously selected `$client` to obtain a new observation:

<!-- example: clients.refresh -->
```powershell
$client | Update-TmuxClient
```

This reads current data; it does not redraw the terminal. Refreshing a client
that has detached writes the native missing-object error.

Resolve the client's current session, window and pane together:

<!-- example: clients.attachment -->
```powershell
$client | Get-TmuxClientAttachment
```

The result is a native [`ClientAttachment`](<https://libtmux.org/en/csharp/latest/reference/libtmux-clientattachment/>). A detached client or missing
session produces no output; [`Window`](<https://libtmux.org/en/csharp/latest/reference/libtmux-window/>) or [`Pane`](<https://libtmux.org/en/csharp/latest/reference/libtmux-pane/>) can be null. The operation
performs several tmux reads and does not promise an atomic observation.
Transport failures remain errors, not empty results.

These commands only inspect clients. Detachment, locking and suspension
remain available through explicit raw tmux commands. Closing or removing a
client must not be confused with removing its session or daemon.

[client-name]: https://libtmux.org/en/csharp/latest/reference/libtmux-client-name/
[client-tty]: https://libtmux.org/en/csharp/latest/reference/libtmux-client-tty/
[client-generation]: https://libtmux.org/en/csharp/latest/reference/libtmux-client-generation/