Get ePOComputer

external help file: ePOwerShell-help.xml Module Name: ePOwerShell online version: schema: 2.0.0

Get-ePOComputer

SYNOPSIS

Finds available computer systems on the ePO server

SYNTAX

All (Default)

Get-ePOComputer [-All] [<CommonParameters>]

AgentGuid

Get-ePOComputer [-AgentGuid <Object>] [<CommonParameters>]

ComputerName

Get-ePOComputer [[-Computer] <Object>] [-ForceWildcardHandling] [<CommonParameters>]

MACAddress

Get-ePOComputer [-MACAddress <Object>] [<CommonParameters>]

IPAddress

Get-ePOComputer [-IPAddress <Object>] [<CommonParameters>]

Tag

Get-ePOComputer [-Tag <Object>] [<CommonParameters>]

Username

Get-ePOComputer [-Username <Object>] [<CommonParameters>]

DESCRIPTION

Finds all available computer systems from the ePO server. If a computer system name is specifed, it searches for only the one computer system from the server. If a computer system is not specified, then it will return a list of all available computer systems on the ePO server. You can search for a computer using the Agent Guid, Computer Name, MAC Address, IP Address, Tags, and Usernames.

EXAMPLES

EXAMPLE 1

$Computer = Get-ePOComputer -All

Returns all computers in the ePO system

EXAMPLE 2

$Computer = Get-ePOComputer -ComputerName 'Computer1'

Returns ePO computer object searching by hostname

EXAMPLE 3

$Computer = Get-ePOComputer -ComputerName 'Computer*' -ForceWildcardHandling

Returns ePO computer object searching by hostname with wildcard

EXAMPLE 4

$Computer = Get-ePOComputer -AgentGuid 5b273b72-977b-4566-9cb4-9af816ac222b

Returns ePO computer object searching by Agent Guid

EXAMPLE 5

$Computer = Get-ePOComputer -MacAddress 00-05-9A-3C-7A-00

Returns ePO computer object searching by MAC Address

EXAMPLE 6

$Computer = Get-ePOComputer -IPAddress 192.168.32.46

Returns ePO computer object searching by IP Address

EXAMPLE 7

$Computer = Get-ePOComputer -Username MyUsername

Returns ePO computer object searching by Username

EXAMPLE 8

$Computer = Get-ePOComputer -Tag ePOTag1

Returns ePO computer objects searching by Tag

PARAMETERS

-AgentGuid

Specifies the computers Agent Guid to be found on the ePO server

Type: Object
Parameter Sets: AgentGuid
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Computer

Specifies a computer system to be found on the ePO server

Type: Object
Parameter Sets: ComputerName
Aliases: hostname, name, computername

Required: False
Position: 2
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-ForceWildcardHandling

Allows for wildcards to be used when searching by computer name

Type: SwitchParameter
Parameter Sets: ComputerName
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-MACAddress

Specifies the computers MAC Address to be found on the ePO server

Type: Object
Parameter Sets: MACAddress
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IPAddress

Specifies the computers IPAddress to be found on the ePO server

Type: Object
Parameter Sets: IPAddress
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Tag

Specifies the tag a computer might have applied to be found on the ePO server

Type: Object
Parameter Sets: Tag
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Username

Specifies the computers Username to be found on the ePO server

Type: Object
Parameter Sets: Username
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-All

Returns all computers in the ePO server

Type: SwitchParameter
Parameter Sets: All
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.