thycotic-ps / thycotic.secretserver

PowerShell module for automating with Thycotic Secret Server REST API
https://thycotic-ps.github.io/thycotic.secretserver
MIT License
68 stars 22 forks source link

Documentation for Output objects #254

Closed miked1313 closed 2 years ago

miked1313 commented 2 years ago

Summarize Functionality

In the documentation the name of the object under Output is a link that goes nowhere.

https://thycotic-ps.github.io/thycotic.secretserver/commands/secrets/Get-TssSecret.html#outputs

For the Get-TssSecret page, the output Thycotic.PowerShell.Secrets.Secret has a link next to it which looks like a page heading anchor https://thycotic-ps.github.io/thycotic.secretserver/commands/secrets/Get-TssSecret.html#thycoticpowershellsecretssecret

Can examples be added of what the Thycotic.PowerShell.Secrets.Secret object contains? This would also be useful for any other cmdlet outputs as well.

Is there a command that is similiar or close to what you are looking for?

No

Technical Details

No response

wsmelton commented 2 years ago

We previously attempted to maintain the output help files via about_* files that could be read using Get-Help, but it was to much to maintain along with the codebase. The output types on the commands mirror the endpoint's model object that can be viewed in the REST API Guide. (e.g. Thycotic.PowerShell.Secrets.Secret is mirror of the output from GET /v1/secrets/{id} endpoint).

PowerShell offers two methods that can be utilized to discover the output object properties: