VMware PowerCLI for Mirage

Get-MiragePendingDevice

Synopsis

This cmdlet retrieves the pending devices from Mirage system.

Syntax

Get-MiragePendingDevice [[-Name] <String[]>] [-Connected [<Boolean>]] [-Id <String[]>] [-ModelName <String[]>] [-OS <OsVersion[]>] [-UserName <String[]>] [-VendorName <String[]>] [<CommonParameters>]

Related Commands

Detailed Description

This cmdlet retrieves the pending devices from the Mirage system.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
NameString[]Specify the name of the pending device.falsefalse
ConnectedBooleanSpecify the connection state of the pending device.falsefalse
IdString[]Specify the ID of the CVD.falsefalse
ModelNameString[]Specify the ModelName of the pending device.falsefalse
OSOsVersion[]Specify the OS of the pending device.falsefalse
UserNameString[]Specify the user name of the pending device.falsefalse
VendorNameString[]Specify the vendor name of the pending device.falsefalse

Return Type

DeviceInfo

Notes

Since VMware Mirage 5.2.0.

Examples

-------------- Example 1: Return all pending devices. --------------

Get-MiragePendingDevice

Returns all pending devices.





Id Name UserName OsVersion Connected
-- ---- -------- --------- ---------
device-22 MIRAGE-XP MIRAGEDOMAIN\Admi... XP True
device-23 W7MIGRATION-PC MIRAGEDOMAIN\admi... WIN7 True

-------------- Example 2: Retrieve a pending device with a specified connection state. --------------

Get-MiragePendingDevice -Connected $True

Retrieves connected pending devices.





Id Name UserName OsVersion Connected
-- ---- -------- --------- ---------
device-22 MIRAGE-XP MIRAGEDOMAIN\Admi... XP True
device-23 W7MIGRATION-PC MIRAGEDOMAIN\admi... WIN7 True

-------------- Example 3: Retrieve a pending device with a specified Id. --------------

Get-MiragePendingDevice -Id device-22

Retrieves the pending device whose Id is 22.





Id Name UserName OsVersion Connected
-- ---- -------- --------- ---------
device-22 MIRAGE-XP MIRAGEDOMAIN\Admi... XP True

-------------- Example 4: Retrieve pending device with OS. --------------

Get-MiragePendingDevice -OS XP

Retrieves pending devices with OS version XP.





Id Name UserName OsVersion Connected
-- ---- -------- --------- ---------
device-22 MIRAGE-XP MIRAGEDOMAIN\Admi... XP True

-------------- Example 5: Retrieve pending devices with a specified user name. --------------

Get-MiragePendingDevice -UserName miragedomain\administrator

Retrieves pending devices whose user name is miragedomain\administrator.





Id Name UserName OsVersion Connected
-- ---- -------- --------- ---------
device-22 MIRAGE-XP MIRAGEDOMAIN\Admi... XP True
device-23 W7MIGRATION-PC MIRAGEDOMAIN\admi... WIN7 True

-------------- Example 6: Use wildcards to filter pending devices. --------------

Get-MiragePendingDevice -UserName miragedomain*

Returns pending devices whose name begins with "miragedomain".





Id Name UserName OsVersion Connected
-- ---- -------- --------- ---------
device-22 MIRAGE-XP MIRAGEDOMAIN\Admi... XP True
device-23 W7MIGRATION-PC MIRAGEDOMAIN\admi... WIN7 True

-------------- Example 7: Use wildcards to filter pending devices with contains expression. --------------

Get-MiragePendingDevice -UserName *miragedomain*

Returns pending devices whose user name contains "miragedomain".





Id Name UserName OsVersion Connected
-- ---- -------- --------- ---------
device-22 MIRAGE-XP MIRAGEDOMAIN\Admi... XP True
device-23 W7MIGRATION-PC MIRAGEDOMAIN\admi... WIN7 True


Copyright © VMware, Inc. All rights reserved.