< Back

Get-ItGlueDeviceConfig

Wed Jan 15, 2020 9:23 am

NAME Get-ItGlueDeviceConfig



SYNOPSIS





SYNTAX

Get-ItGlueDeviceConfig [-ComputerName <String>] [-CustomerId <Int64>] -ApiKey <SecureString> [-UriBase <String>]

[-PageSize <Int64>] [-EventLogSource <String>] [-LogPath <String>] [<CommonParameters>]



Get-ItGlueDeviceConfig [-ComputerName <String>] [-CustomerId <Int64>] -UserCred <PSCredential> [-UriBase <String>]

[-PageSize <Int64>] [-EventLogSource <String>] [-LogPath <String>] [<CommonParameters>]





DESCRIPTION

Connects to the ITGlue API and returns one or more device configs.





PARAMETERS

-ComputerName <String>

Enter the hostname of the desired device config, or "All" to retrieve all device configs.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-CustomerId <Int64>

Desired customer's ITGlue organization ID.



Required? false

Position? named

Default value 0

Accept pipeline input? false

Accept wildcard characters? false



-ApiKey <SecureString>

ITGlue API key used to send data to ITGlue.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-UserCred <PSCredential>

ITGlue credential object for the desired local account.



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-UriBase <String>

Base URL for the ITGlue API.



Required? false

Position? named

Default value https://api.itglue.com

Accept pipeline input? false

Accept wildcard characters? false



-PageSize <Int64>

Page size when requesting ITGlue resources via the API.



Required? false

Position? named

Default value 1000

Accept pipeline input? false

Accept wildcard characters? false



-EventLogSource <String>

When included, (and when LogPath is null), represents the event log source for the Application log. If no

event log source or path are provided, output is sent only to the host.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-LogPath <String>

When included (when EventLogSource is null), represents the file, to which the cmdlet will output will be

logged. If no path or event log source are provided, output is sent only to the host.



Required? false

Position? named

Default value

Accept pipeline input? false

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).



INPUTS



OUTPUTS



NOTES





V1.0.0.4 date: 2 July 2019

V1.0.0.5 date: 11 July 2019

V1.0.0.6 date: 12 July 2019

V1.0.0.7 date: 18 July 2019

V1.0.0.8 date: 25 July 2019

V1.0.0.9 date: 25 July 2019

V1.0.0.10 date: 30 July 2019

V1.0.0.11 date: 1 August 2019

V1.0.0.12 date: 6 August 2019

V1.0.0.13 date: 9 August 2019

V1.0.0.14 date: 13 August 2019

V1.0.0.15 date: 11 December 2019



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Get-ItGlueDeviceConfig -ApiKey ITG.XXXXXXXXXXXXX -ComputerName All



In this example, the cmdlet will get all ITGlue device configurations, using the provided ITGlue API key.









-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Get-ItGlueDeviceConfig -UserCred (Get-Credential) -ComputerName server1 -Verbose



In this example, the cmdlet will get all device configurations for "server1", using the provided ITGlue user

credentials. Verbose output is sent to the host.









-------------------------- EXAMPLE 3 --------------------------



PS C:\\>Get-ItGlueDeviceConfig -UserCred (Get-Credential) -ItGlueCustomerId 123456



In this example, the cmdlet will get all device configurations for customer with ID 123456, using the provided

ITGlue user credentials.











RELATED LINKS

https://github.com/wetling23/Public.ItG ... hellModule