# Get-RASRDSHostStatus

## NAME

Get-RASRDSHostStatus

## SYNOPSIS

Retrieves the RD Session Host server status information.

## SYNTAX

**Get-RASRDSHostStatus** \[\[-[Id](#id-string)]\*\* *(uint)*] \[-[StatusLevel](#StatusLevel) {Level1 | Level2 | Level3}] \[*(*[*CommonParameters*](#CommonParameters)*)*]

**Get-RASRDSHostStatus** \[\[-[InputObject](#inputobject)] *(*[*RDSHost*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/rdshost)*)*] \[-[StatusLevel](#StatusLevel) {Level1 | Level2 | Level3}] \[*(*[*CommonParameters*](#CommonParameters)*)*]

**Get-RASRDSHostStatus** \[\[-[Server](#server-string)] *(string)*] \[\[-[SiteId](#siteid-string)] *(uint)*] \[-[StatusLevel](#StatusLevel) {Level1 | Level2 | Level3}] \[*(*[*CommonParameters*](#CommonParameters)*)*]

## DESCRIPTION

Retrieves the RD Session Host status information and optionally session and application information.

## PARAMETERS

## Server (string)

The name of the RD Session Host server for which to retrieve the information.

This must be the actual server name used in the RAS farm.

```
        Required?                    false

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## SiteId (uint)

Site ID from which to retrieve the specified RD Session Host server information.

If the parameter is omitted, the site ID of the Licensing Server will be used.

```
        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Id (uint)

The ID of the RD Session Host server. To obtain the ID, use the Get-RASRDS cmdlet.

```
        Required?                    false

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## InputObject ([RDSHost](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/rdshost))

An object of type RDS representing the RD Session Host server.

To obtain the object, use the Get-RASRDS cmdlet.

```
        Required?                    false

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false
```

## StatusLevel ([StatusLevel](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/statuslevel))

Specifies the level of detail that should be retrieved.

Acceptable values: Level1 (status information only), Level2 (status and session information), Level3 (status, session, and application info).

Possible values: Level1, Level2, Level3

```
        Required?                    false

        Position?                    named

        Default value                Level1

        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

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

## OUTPUTS

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

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

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

## EXAMPLES

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

Get-RASRDSHostStatus -Id 15

Retrieves the RD Session Host status information for the server with ID 15.\
\&#xNAN;**---------- EXAMPLE 2 ----------**

Get-RASRDSHostStatus -Server MyRDSH -StatusLevel Level2

Retrieves the RD Session Host status and session information for the server named "MyRDSH".\
\&#xNAN;**---------- EXAMPLE 3 ----------**

Get-RASRDSHostStatus -InputObject $RDSH -StatusLevel Level3

Retrieves the RD Session Host status, session, and application information for the server represented by the $RDSH object.\
\&#xNAN;**---------- EXAMPLE 4 ----------**

Get-RASRDSHost -Id 15 | Get-RDSStatus -StatusLevel Level1

Retrieves the RD Session Host status information for the server represented by the object obtained from the pipeline output.

## RELATED LINKS

* [New-RASRDSHost](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/new-rasrdshost)
* [Get-RASRDSHost](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/commands/get-rasrdshost)