# Get-RASHALBDevice.md

## NAME

Get-RASHALBDevice

## SYNOPSIS

Retrieves a map, or a specific device used by the HALB Virtual Server.

## SYNTAX

**Get-RASHALBDevice** \[\[-[HALBId](#halbid-string)] *(uint)*] \[\[-[DeviceID](#deviceid-string)] *(uint)*] \[*(*[*CommonParameters*](#CommonParameters)*)*]

**Get-RASHALBDevice** \[[HALBName](#halbname-string)] *(string)* \[\[-[SiteId](#siteid-string)] *(uint)*] \[\[-[DeviceID](#deviceid-string)] *(uint)*] \[*(*[*CommonParameters*](#CommonParameters)*)*]

## DESCRIPTION

Retrieves a map, or a specific device used by the HALB Virtual Server.

## PARAMETERS

## HALBName (string)

The HALB Virtual Server name.

```
        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## SiteId (uint)

The site ID where the HALB settings will be created.

```
        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## HALBId (uint)

The ID of the HALB Virtual Server.

```
        Required?                    false

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## DeviceID (uint)

The ID of the HALB Device.

```
        Required?                    false

        Position?                    2

        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 documentation. 
```

## INPUTS

-none-

## OUTPUTS

[HALBDevice](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/types/halbdevice)

## EXAMPLES

\*\*---------- EXAMPLE 1 ----------

Get-RASHALBDevice -HALBName "HALB-VS"

Returns a dictionary of the HALB Device IPs that are used by the HALB Virtual Server named "HALB-VS".\
\*\*---------- EXAMPLE 2 ----------

Get-RASHALBDevice -HALBId 21

Returns a dictionary of the HALB Device IPs that are used by the HALB Virtual Server with ID 21.\
\*\*---------- EXAMPLE 3 ----------

Get-RASHALBDevice -HALBName "HALB-VS" -DeviceID 1

Returns a specific entry of the HALB Device IP that is used by the HALB Virtual Server named "HALB-VS".\
\*\*---------- EXAMPLE 4 ----------

Get-RASHALBDevice -HALBId 21 -DeviceID 1

Returns a specific entry of the HALB Device IP that is used by the HALB Virtual Server with ID 21.

## RELATED LINKS

* [Add-RASHALBDevice](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/commands/add-rashalbdevice)
* [Remove-RASHALBDevice](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/commands/remove-rashalbdevice)
* [Set-RASHALBDevicePriority](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/commands/set-rashalbdevicepriority)