# Get-RASVDIHostStatus

## NAME

Get-RASVDIHostStatus

## SYNOPSIS

Retrieves the list of, or a specific, host status.

## SYNTAX

**Get-RASVDIHostStatus** \[-[ProviderId](#ProviderId)] _\<uint>_ \[\[-[SiteId](#SiteId)] _\<uint>_] -[HostId](#HostId) _\<string>_ \[-[StatusLevel](#StatusLevel) {Level1 | Level2 | Level3}] \[-[User](#User) _\<string>_] \[_<_[_CommonParameters_](#CommonParameters)_>_]

**Get-RASVDIHostStatus** \[-[InputObject](#InputObject)] _<_[_VDIHost_](../classes-and-enumerations/vdihost)_>_ \[-[ProviderId](#ProviderId)] _\<uint>_ \[\[-[SiteId](#SiteId)] _\<uint>_] \[-[StatusLevel](#StatusLevel) {Level1 | Level2 | Level3}] \[-[User](#User) _\<string>_] \[_<_[_CommonParameters_](#CommonParameters)_>_]

**Get-RASVDIHostStatus** \[\[-[ProviderId](#ProviderId)] _\<uint>_] \[\[-[SiteId](#SiteId)] _\<uint>_] \[-[StatusLevel](#StatusLevel) {Level1 | Level2 | Level3}] \[-[User](#User) _\<string>_] \[_<_[_CommonParameters_](#CommonParameters)_>_]

## DESCRIPTION

Retrieves the list of, or a specific, host status.

## PARAMETERS

-**ProviderId \<uint>**\
The ID of a Provider server from which to obtain the Host vm list.

```
        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

-**SiteId \<uint>**\
Site ID from which to retrieve the Host VM list.

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

-**HostId \<string>**\
The ID of the Host vm. To obtain the ID, use the Get-RASVDIHost cmdlet.

```
        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

-**InputObject <**[**VDIHost**](../classes-and-enumerations/vdihost)**>**\
An object of type VDIHost representing a Host vm for which to retrieve the information.

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

```
        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false
```

-**User \<string>**\
The username assigned to Host.

If empty square brackets (\[]) are passed, the Host list will be filtered with those with an assigned user.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

-**StatusLevel <**[**StatusLevel**](../classes-and-enumerations/statuslevel)**>**\
Specifies the level of detail that should be returned.

Acceptable values: Level1 (VDI Host status information only), Level2 (VDI Host status and Host VM info), Level3 (VDI Host status, Host VMs, Applications).

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

[VDIHost](../classes-and-enumerations/vdihost)

## OUTPUTS

[VDIHostSysInfo](../classes-and-enumerations/vdihostsysinfo)

## EXAMPLES

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

Get-RASVDIHostStatus | Format-List

Retrieves the list of host statuses.\
&#xNAN;**---------- EXAMPLE 2 ----------**

Get-RASVDIHostStatus -ProviderId 1

Retrieves the list of host statuses from the specified Provider server.\
&#xNAN;**---------- EXAMPLE 3 ----------**

Get-RASVDIHostStatus -ProviderId 1 -SiteId 1

Retrieves the list of host statuses from the specified Provider server from the specified site.\
&#xNAN;**---------- EXAMPLE 4 ----------**

Get-RASVDIHostStatus -ProviderId 1 -SiteId 1 -HostId "" | Format-List

Retrieves the specified host status from the specified Provider server from the pecified site.

## RELATED LINKS

* [Get-RASVDIHost](get-rasvdihost)
* [Remove-RASVDIHost](remove-rasvdihost)
