Get-VPASCMConnectorComponentDetails


Supported Environments:
SelfHosted
SharedServices
PCloudStandard


Synopsis:

GET CONNECTOR MANAGEMENT CONNECTOR COMPONENT DETAILS


Description:

USE THIS FUNCTION TO RETRIEVE CONNECTOR COMPONENT DETAILS FROM CONNECTOR MANAGEMENT


Syntax:

Get-VPASCMConnectorComponentDetails [[-ConnectorID] <String>] [[-ConnectorHost] <String>] [[-ComponentID] <String>] [[-ComponentName] <String>] [[-token] <Hashtable>] [<CommonParameters>]


Parameters:

-ConnectorID <String>
UniqueID of the target connector in ConnectorManagement

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

-ConnectorHost <String>
Unique host of the target connector in ConnectorManagement
Host in this case can either be a hostname, a publicIP, or a PrivateIP

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

-ComponentID <String>
UniqueID of the target component for a connector in ConnectorManagement

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

-ComponentName <String>
Unique name of the target component for a connector in ConnectorManagement
Possible values: psm, cpm, cpm scanner, Management Agent

Required: false
Position: 4
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: 5
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:

$ConnectorComponentDetails = Get-VPASCMConnectorComponentDetails -ConnectorID {CONNECTOR ID VALUE} -ComponentID {COMPONENT ID VALUE}

$ConnectorComponentDetails = Get-VPASCMConnectorComponentDetails -ConnectorHost {CONNECTOR NAME VALUE} -ComponentName {COMPONENT NAME VALUE}


Outputs:

If successful:
{
         "componentId": "lkdfhj834920-zccv-1234-sdfg-slkdjf09458",
         "componentName": "Privileged Session Manager",
         "acronym": "psm",
         "componentStatus": "Active",
         "connectorId": "ManagementAgent_fslkdj34890-1234-1234-asdf-0239kdfj",
         "version": "14.2.0.3",
         "upgradeVersions": [
                 "v14.3.0.8"
         ],
         "usedCpu": 0.304,
         "usedMemory": 0.949,
         "installedAt": 1711987268166,
         "updatedAt": 1723831555919,
         "maintenanceStatus": null
}

$false if failed