< Back

Find-ePoSystem

Sat Jan 18, 2020 7:47 pm

NAME Find-ePoSystem



SYNOPSIS

Finds a system using the ePo API.





SYNTAX

Find-ePoSystem [[-Filter] <String>] [-WhatIf] [-Confirm] [<CommonParameters>]





DESCRIPTION

Sends the command specified to the McAfee EPO server. Connect-ePoServer has to be run first,

as this function uses the epoServer global variable created by that functions connection to the server. Uses the

Invoke-ePoCommand





PARAMETERS

-Filter <String>

The search string to use for finding a system. Defaults to a space, which returns all systems.



Required? false

Position? 1

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Confirm [<SwitchParameter>]



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





Added logic to determine the Percent of disk space left on each system.

Added support for Whatif

Changed to using ArrayList



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



PS C:\\>$CurrentPC = Find-ePoSystem -Filter $env:computername



$CurrentPC



Retruns the output of the system.find API command with a search paramter for the current computer.









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



PS C:\\>$FoundSystems = Find-ePoSystem -Filter "lt"



Returns an object of the results of the system.find search for systems with lt in their names.









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



PS C:\\>$AllSystems = Find-ePoSystem -Verbose



Returns an object of the results of the system.find search for all systems.











RELATED LINKS