New-DSPamVault

    2024-10-28

    New-DSPamVault

    SYNOPSIS

    Create a new PAM vault

    SYNTAX

    __AllParameterSets

    New-DSPamVault -Name <string> [-Description <string>] [-Visibility <VaultAllowAccessRequestRole>]
     [-Owner <string[]>] [-User <string[]>] [-Role <string[]>] [<CommonParameters>]
    

    ALIASES

    This cmdlet has the following aliases,

    DESCRIPTION

    Create a new PAM vault. To set permissions for the vault, you must apply them at the root level. The root connection has the same id as the vault. Either use 'Get-DSPamFolder' combined with Update-DSPamFolder or 'Set-DSEntityPermission' to update the permissions.

    EXAMPLES

    EXAMPLE

    PS C:> $entities = @('Bob', 'UserGroupA', '12345678-1234-1234-1234-123456781234') PS C:> New-DSPamVault -Name 'MyNewVault' -Description 'A description' -Owner $entities

    Create a PAM vault named 'MyNewVault' owned by the users 'Bob' and '12345678-1234-1234-1234-123456781234', and the user group 'UserGroupA'

    PARAMETERS

    -Description

    Description of the PAM vault

    Type: System.String
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: (All)
      Position: Named
      IsRequired: false
      ValueFromPipeline: false
      ValueFromPipelineByPropertyName: false
      ValueFromRemainingArguments: false
    DontShow: false
    AcceptedValues: []
    HelpMessage: ''
    

    -Name

    Name of the PAM vault

    Type: System.String
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: (All)
      Position: Named
      IsRequired: true
      ValueFromPipeline: false
      ValueFromPipelineByPropertyName: false
      ValueFromRemainingArguments: false
    DontShow: false
    AcceptedValues: []
    HelpMessage: ''
    

    -Owner

    Assign owners to the vault with their ID or name

    Type: System.String[]
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: (All)
      Position: Named
      IsRequired: false
      ValueFromPipeline: false
      ValueFromPipelineByPropertyName: false
      ValueFromRemainingArguments: false
    DontShow: false
    AcceptedValues: []
    HelpMessage: ''
    

    -Role

    Give the user groups access to the vault

    Type: System.String[]
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: (All)
      Position: Named
      IsRequired: false
      ValueFromPipeline: false
      ValueFromPipelineByPropertyName: false
      ValueFromRemainingArguments: false
    DontShow: false
    AcceptedValues: []
    HelpMessage: ''
    

    -User

    Give the users access to the vault

    Type: System.String[]
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: (All)
      Position: Named
      IsRequired: false
      ValueFromPipeline: false
      ValueFromPipelineByPropertyName: false
      ValueFromRemainingArguments: false
    DontShow: false
    AcceptedValues: []
    HelpMessage: ''
    

    -Visibility

    Visibility of the vault

    Type: Devolutions.RemoteDesktopManager.VaultAllowAccessRequestRole
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: (All)
      Position: Named
      IsRequired: false
      ValueFromPipeline: false
      ValueFromPipelineByPropertyName: false
      ValueFromRemainingArguments: false
    DontShow: false
    AcceptedValues: []
    HelpMessage: ''
    

    CommonParameters

    This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

    INPUTS

    OUTPUTS

    RemoteDesktopManager.PowerShellModule.PSOutputObject.PSRepositoryInfo

    NOTES

    For more information, type "Get-Help New-DSPamVault -detailed". For technical information, type "Get-Help New-DSPamVault -full".