< Back
Find-ePoSystem
Post
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
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