Import-DSPamScanResult

    2024-12-11

    Import-DSPamScanResult

    SYNOPSIS

    Import the accounts of a PAM scan result

    SYNTAX

    Reset

    Import-DSPamScanResult [-ScanResult] <PSScanResult[]> [-Provider] <PamProvider> [-FolderID] <guid>
     [-ResetPasswordOnImport] [-ResetPasswordOnCheckIn] [<CommonParameters>]
    

    Unmanaged

    Import-DSPamScanResult [-ScanResult] <PSScanResult[]> [-Provider] <PamProvider> [-FolderID] <guid>
     -Unmanaged [-UnmanagedAction <UnmanagedImportAction>] [<CommonParameters>]
    

    ALIASES

    This cmdlet has the following aliases,

    DESCRIPTION

    Import the accounts of a PAM scan result

    EXAMPLES

    EXAMPLE

    PS C:> $providerID = 'the-desired-pam-provider-ID' $folderID = 'the-desired-pam-vault-or-folder-ID' $configuration = Get-DSPamScanConfiguration -LiteralName 'ScanA'; $toImport = Get-DSPamScanResult -InputObject $configuration -Filter '@domain.net' -ExcludedManaged; $providerResult = Get-DSPamProvider $provider = $providerResult.Data | Where -Property ID -eq $providerID $importResult = Import-DSPamScanResult -ScanResult $toImport -Provider $provider -FolderID $folderID

    From the 'ScanA' PAM scan's result, import all accounts who have '@domain.net' in their username, hostname, fullname, or description in the PAM folder specified by $folderID.

    PARAMETERS

    -FolderID

    Pam Folder

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

    -Provider

    Provider obtained from Get-DSPamProvider

    Type: Devolutions.Server.Pam.Dto.PamProvider
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: (All)
      Position: 2
      IsRequired: true
      ValueFromPipeline: false
      ValueFromPipelineByPropertyName: false
      ValueFromRemainingArguments: false
    DontShow: false
    AcceptedValues: []
    HelpMessage: ''
    

    -ResetPasswordOnCheckIn

    Reset password on check in

    Type: System.Management.Automation.SwitchParameter
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: Reset
      Position: Named
      IsRequired: false
      ValueFromPipeline: false
      ValueFromPipelineByPropertyName: false
      ValueFromRemainingArguments: false
    DontShow: false
    AcceptedValues: []
    HelpMessage: ''
    

    -ResetPasswordOnImport

    Reset password on import

    Type: System.Management.Automation.SwitchParameter
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: Reset
      Position: Named
      IsRequired: false
      ValueFromPipeline: false
      ValueFromPipelineByPropertyName: false
      ValueFromRemainingArguments: false
    DontShow: false
    AcceptedValues: []
    HelpMessage: ''
    

    -ScanResult

    Pam accounts revealed by a PAM scan. Must be of the same type.

    Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSScanResult.PSScanResult[]
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: (All)
      Position: 1
      IsRequired: true
      ValueFromPipeline: false
      ValueFromPipelineByPropertyName: false
      ValueFromRemainingArguments: false
    DontShow: false
    AcceptedValues: []
    HelpMessage: ''
    

    -Unmanaged

    Set accounts to unmanaged

    Type: System.Management.Automation.SwitchParameter
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: Unmanaged
      Position: Named
      IsRequired: true
      ValueFromPipeline: false
      ValueFromPipelineByPropertyName: false
      ValueFromRemainingArguments: false
    DontShow: false
    AcceptedValues: []
    HelpMessage: ''
    

    -UnmanagedAction

    Set accounts to unmanaged. To manually set the password, you must modify directly the scan results. The default action is to set the password manually.

    Type: Devolutions.Server.Managers.Pam.Enums.UnmanagedImportAction
    DefaultValue: ''
    SupportsWildcards: false
    ParameterValue: []
    Aliases: []
    ParameterSets:
    - Name: Unmanaged
      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

    Devolutions.Server.Pam.Dto.Import.PamMultipleOperationResult`1[[Devolutions.RemoteDesktopManager.Business.Connection, RemoteDesktopManager.Business, Version=2024.3.7.0, Culture=neutral, PublicKeyToken=null]]

    NOTES

    For more information, type "Get-Help Import-DSPamScanResult -detailed". For technical information, type "Get-Help Import-DSPamScanResult -full".