SC26AI agents lab + dinner on the river · Nov 17
Parallel Works
View as Markdown
Share:

pw users ssh-key rotate

pw users ssh-key rotate

Replace a user's workspace SSH key with a new one

Synopsis

The pw users ssh-key rotate command replaces a user's workspace SSH key. Their running workspace receives the new key within seconds; a stopped one at its next start. Requires the org:users role in the target organization.

The old key stops working at once unless --grace-period-hours keeps it for up to 24 hours. By default it uses the organization from your current context. Use --org to target a different organization.

pw users ssh-key rotate [flags] <username>

Examples

  pw users ssh-key rotate alice
  
  # Keep the old key working for 4 more hours
  pw users ssh-key rotate --grace-period-hours 4 alice
  
  # Rotate in another organization without the confirmation prompt
  pw users ssh-key rotate --org my-org -f alice

Options

  -f, --force                    Skip confirmation prompt
      --grace-period-hours int   Hours the old key keeps working, 0 to 24 (0 stops it at once)
  -h, --help                     help for rotate
      --org string               Target organization (defaults to current context)
  -o, --output string            Output format (table, json) (default "table")

Options inherited from parent commands

      --context string         The context to use. Overrides PW_CONTEXT environment variable and current context from config.
      --platform-host string   The Parallel Works ACTIVATE platform host to use. Overrides PW_PLATFORM_HOST environment variable and the current context's server.
  -v, --verbose                Enable verbose logging

SEE ALSO