public/asset/Get-Asset.ps1
|
Function Get-Asset { <# .DESCRIPTION Returns information about an SMA asset. .PARAMETER Server The fully qualified name (FQDN) of the SMA Appliance. Example: https://kace.example.com .PARAMETER Org The SMA Organization you want to retrieve information from. If not provided, 'Default' is used. .PARAMETER Credential A credential for the kace appliance that has permissions to interact with the API. To run interactively, use -Credential (Get-Credential) .PARAMETER AssetID (Optional) Use if you want to return a specific asset from the SMA. ID can be found in SMA Admin > Asset Management, then hover over an asset and look at the ID= in the url. This parameter is required if using the -AsBarcodes switch. .PARAMETER AsBarcodes (Optional) A switch where, if included, will return all barcodes associated with a specified asset (-AssetID parameter). .PARAMETER QueryParameters (Optional) Any additional query parameters to be included. String must begin with a <?> character. .INPUTS .OUTPUTS PSCustomObject .EXAMPLE Get-SmaAsset -Server https://kace.example.com -Org Default -Credential (Get-Credential) -AssetID 1234 Retrieves information about an asset with ID 1234. .EXAMPLE Get-SmaAsset -Server https://kace.example.com -Org Default -Credential (Get-Credential) -AssetID 5678 -AsBarcodes Retrieves barcode information about an asset with ID 5678. .NOTES #> [cmdletBinding( SupportsShouldProcess = $true, ConfirmImpact = 'low' )] param( [Parameter(Mandatory = $true)] [string] $Server, [Parameter()] [string] $Org = 'Default', [Parameter(Mandatory = $true)] [PSCredential] $Credential, [Parameter()] [int] $AssetID, [Parameter()] [switch] $AsBarcodes, [Parameter()] [ValidatePattern("^\?")] [string] $QueryParameters ) Begin { $Endpoint = '/api/asset/assets' If ($AssetID) { $Endpoint = "/api/asset/assets/$AssetID" If ($AsBarcodes) { $Endpoint = "/api/asset/assets/$AssetID/barcodes" } } } Process { If ($PSCmdlet.ShouldProcess($Server,"GET $Endpoint")) { New-ApiGETRequest -Server $Server -Endpoint $Endpoint -Org $Org -QueryParameters $QueryParameters -Credential $Credential } } End {} } |