Get-DSPamScanResult

    2024-10-28

    Get-DSPamScanResult

    SYNOPSIS

    Retrieve the outcome of the most recent scan job associated with a specific scan configuration

    SYNTAX

    __AllParameterSets

    Get-DSPamScanResult [-InputObject] <ScanConfigurationDto> [[-Filter] <string>] [-ExcludeManaged]
 [<CommonParameters>]

    ALIASES

    This cmdlet has the following aliases,

    DESCRIPTION

    Retrieve the outcome of the most recent scan job associated with a specific scan configuration.

    EXAMPLES

    EXAMPLE 1

    PS C:> Get-DSPamScanConfiguration -LiteralName 'ScanA' | Get-DSPamScanResult

    Get the scan result for the configuration named 'ScanA'

    EXAMPLE 2

    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 users who have '@domain.net' in their username, hostname, fullname, or description in the PAM folder specified by $folderID.

    PARAMETERS

    -ExcludeManaged

    Exclude the managed users

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

    -Filter

    The global filter, identical to the web UI filter, is designed to be applied to the username, hostname, fullname, and description fields.

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

    -InputObject

    PAM scan configuration object obtained from Get-DSPamScanConfiguration

    Type: Devolutions.Server.NetworkDiscovery.Dto.ScanConfigurationDto
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: true
  ValueFromPipeline: true
  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

    Devolutions.Server.NetworkDiscovery.Dto.ScanConfigurationDto

    PAM scan configuration object obtained from Get-DSPamScanConfiguration

    OUTPUTS

    RemoteDesktopManager.PowerShellModule.PSOutputObject.PSScanResult.PSScanResult

    NOTES

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