Command profile

Palo Alto Networks SSH Manager · vSSH CLI

vssh profile

Manage configuration profiles. A profile stores connection settings (service URL, username, templates, and more) so you do not repeat them on every command. See Working with configuration profiles for the concept and file layout.

Aliases: p, profiles

Subcommands: configure, list, show, set, delete.

Profiles are stored one file per profile under ~/.vssh/profiles/ on Linux and macOS, or %USERPROFILE%\.vssh\profiles\ on Windows. The directory is created with 0700 permissions.

---

vssh profile configure

Create or update a profile interactively. This is the fastest way to set up vSSH.

Aliases: c, conf, create, init

vssh profile configure [flags]

Flag	Description
--profile	Profile name to create or edit. Defaults to default.
--url	Service URL.
--user	Username for authentication.
--template-login	Template used by vssh login.
--template-enroll	Template used by vssh certificate enroll.

The command also accepts certificate flags (--principal, --extension, --source-address, --validity, --force-command, --key-id, --object-name, --folder, --destination-address, -o/--out-file) to pre-set enrollment defaults.

Note: profile configure ignores environment variables. It writes exactly what you enter.

vssh profile configure --profile env_dev --url https://tpp.example.com --user alice

---

vssh profile list

List the available profiles.

Aliases: l, ls

$ vssh profile list
Available profiles:
    default
    env_dev

---

vssh profile show

Show the settings stored in a profile. Without --profile, it shows the default profile.

Aliases: s

vssh profile show
vssh profile show --profile env_dev

---

vssh profile set

Set one or more settings in a profile without the interactive prompts. Pass key=value pairs. Without --profile, it edits the default profile.

vssh profile set [key=value ...] [flags]

vssh profile set --profile env_dev url=https://tpp.example.com user=alice

This is useful in setup scripts. To store an access token in a profile, prefer service token obtain --store-to-profile, which fetches and saves a token in one step.

---

vssh profile delete

Delete a profile.

Aliases: d, del, remove, r, rm

$ vssh profile delete --profile env_dev
? Do you want to delete profile with name 'env_dev'? Yes
Configuration profile 'env_dev' was deleted.

Related pages

• Working with configuration profiles
• Authentication methods