Invoke-VPASMetricsProviders


Supported Environments:
SelfHosted
SharedServices
PCloudStandard


Synopsis:

RUN VARIOUS PROVIDER METRICS FROM CYBERARK


Description:

USE THIS FUNCTION TO GENERATE VARIOUS PROVIDER RELATED METRICS FROM CYBERARK


Syntax:

Invoke-VPASMetricsProviders [-TargetMetric] <String> [-MetricFormat] <String> [[-OutputDirectory] <String>] [[-HTMLChart] <String>] [[-HideRawData]] [[-IgnoreSafes] <String[]>] [[-IgnorePlatforms] <String[]>] [[-IgnoreUsernames] <String[]>] [[-SafeSearchQuery] <String[]>] [[-PlatformSearchQuery] <String[]>] [[-UsernameSearchQuery] <String[]>] [[-token] <Hashtable>] [<CommonParameters>]


Parameters:

-TargetMetric <String>
Specify which report will be run
Possible values: ApplicationIDsOnSafes, AccountsPulledViaApplicationID

Required: true
Position: 1
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-MetricFormat <String>
Specify the report output format
NONE will return the generated hashtable of data that can be assigned to a variable
Possible values: JSON, HTML, ALL, NONE

Required: true
Position: 2
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-OutputDirectory <String>
Specify where the location for report output to be saved

Required: false
Position: 3
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-HTMLChart <String>
Specify the HTML report type
Possible values: BarGraph, LineGraph, PieChart, ALL

Required: false
Position: 4
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-HideRawData [<SwitchParameter>]
Removes the RawData visual from the exported output
Helpful when exporting to a PDF or document to remove extra not needed information

Required: false
Position: 5
Default value: False
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-IgnoreSafes <String[]>
Wildcard value that will cause a record to be ignored from the metrics if the target record SafeName matches

Required: false
Position: 6
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-IgnorePlatforms <String[]>
Wildcard value that will cause a record to be ignored from the metrics if the target record PlatformID matches

Required: false
Position: 7
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-IgnoreUsernames <String[]>
Wildcard value that will cause a record to be ignored from the metrics if the target record Username matches

Required: false
Position: 8
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-SafeSearchQuery <String[]>
Wildcard value that will limit the metrics to only target records that match the searchquery via safe name

Required: false
Position: 9
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-PlatformSearchQuery <String[]>
Wildcard value that will limit the metrics to only target records that match the searchquery via platformID

Required: false
Position: 10
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-UsernameSearchQuery <String[]>
Wildcard value that will limit the metrics to only target records that match the searchquery via account username

Required: false
Position: 11
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-token <Hashtable>
HashTable of data containing various pieces of login information (PVWA, LoginToken, HeaderType, etc).
If -token is not passed, function will use last known hashtable generated by New-VPASToken

Required: false
Position: 12
Default value:
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug
ErrorAction, ErrorVariable, WarningAction, WarningVariable
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216)


Examples:

$GenerateReport = Invoke-VPASMetricsProviders -TargetMetric AccountsPulledViaApplicationID -MetricFormat ALL -OutputDirectory C:\Temp\Metrics\ProviderMetrics -HTMLChart ALL

$GenerateReport = Invoke-VPASMetricsProviders -TargetMetric ApplicationIDsOnSafes -MetricFormat ALL -OutputDirectory C:\Temp\Metrics\ProviderMetrics -HTMLChart ALL


Outputs:

HashTable object if successful

$false if failed