Find-ePoDetectedSystem

NAME Find-ePoDetectedSystem



SYNOPSIS

Finds a system using the ePo API.





SYNTAX

Find-ePoDetectedSystem [[-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 the detected system. This can be the DNS Name, Domain, NetBIOS

information, User or IPv4 or IPv6 address.

Defaults to a space which returns all of the detected 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 support for Whatif



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



PS C:\\>$CurrentPC = Find-ePoDetectedSystem -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-ePoDetectedSystem -Filter "Mark"



Returns an object of the results of the system.find search for systems with Mark as their user.









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



PS C:\\>$DomainFoundDetectedSystems = Find-ePoDetectedSystem -Filter "contonoso.com"



$DomainFoundDetectedSystems



Finds all of the detectedsystems with contonoso.com as their domain.









-------------------------- EXAMPLE 4 --------------------------



PS C:\\>Find-ePoDetectedSystem -Verbose



Finds all of the detecedsystems.











RELATED LINKS