Create: Get-TssSecretState

[wsmelton]

Endpoint: /secrets/:id/state
Class name: TssSecretState

This endpoint was added in 10.9.32 and offers the ability to validate permissions against a given secret. The main property of interest is the secretState that is a special object type in the REST API:

SecretAccessRequired: string , x ∈ { None , RequiresApproval , RequiresCheckout , RequiresComment , RequiresDoubleLockPassword , CreateDoubleLockPassword , 
DoubleLockNoAccess , CannotView , RequiresUndelete , RequiresCheckoutPendingRPC , RequiresCheckoutAndComment }

Sample output of the endpoint:

{
    "id": 37,
    "secretName": "Secret Require Checkout",
    "folderId": 32,
    "folderName": "Demo",
    "secretState": "RequiresCheckout",
    "isCheckedOut": null,
    "checkedOutUserId": null,
    "checkOutMinutesRemaining": null,
    "checkedOutUserDisplayName": null,
    "isCheckedOutByCurrentUser": null,
    "checkOutIntervalMinutes": 5,
    "role": null,
    "actions": [
        "ViewAudit",
        "ViewGeneralDetails",
        "EditShare",
        "Edit",
        "ViewLaunchers",
        "Checkout",
        "ViewShare",
        "ViewSettings",
        "ViewSecurity",
        "ViewExpiration",
        "Delete",
        "EditSecurity",
        "EditExpiration",
        "Copy",
        "ConvertTemplate",
        "ViewDependencies",
        "EditDependencies",
        "ViewRpc",
        "EditRpc",
        "ViewHooks",
        "EditHooks",
        "Expire"
    ],
    "passwordChangePending": null,
    "isActive": null
}