Get-XenDriverVariantProperty

Last published : Nov 12, 2026
Gets a property of a DriverVariant object.

Syntax

Get-XenDriverVariantProperty [-DriverVariant] <Driver_variant>
    -XenProperty {Uuid | Name | Driver | Version | HardwarePresent | Priority | Status}
    [-BestEffort] [-SessionOpaqueRef <string>] [<CommonParameters>]
Get-XenDriverVariantProperty [-Ref] <XenRef[Driver_variant]>
    -XenProperty {Uuid | Name | Driver | Version | HardwarePresent | Priority | Status}
    [-BestEffort] [-SessionOpaqueRef <string>] [<CommonParameters>]

Description

Gets a specified property of a DriverVariant object. Use the -XenProperty parameter to select which property to retrieve.
Uuid: Get the uuid field of the given Driver\_variant.
Name: Get the name field of the given Driver\_variant.
Driver: Get the driver field of the given Driver\_variant.
Version: Get the version field of the given Driver\_variant.
HardwarePresent: Get the hardware\_present field of the given Driver\_variant.
Priority: Get the priority field of the given Driver\_variant.
Status: Get the status field of the given Driver\_variant.

Parameters

-BestEffort

If set, the cmdlet continues processing further objects instead of throwing a terminating error when an operation fails for one object.
Attribute Value
Type SwitchParameter
Required False
Position Named
Accepts pipeline input False

-DriverVariant

The DriverVariant object to operate on.
Attribute Value
Type Driver_variant
Required True
Position 0
Accepts pipeline input True (ByValue)

-Ref

The DriverVariant object to operate on, specified by its opaque reference.
Attribute Value
Type XenRef[Driver_variant]
Required True
Position 0
Accepts pipeline input True (ByPropertyName)
Aliases opaque_ref

-SessionOpaqueRef

The session object on which to run the cmdlet. This overrides the default session and lets you target a specific open XenServer connection.
Attribute Value
Type string
Required False
Position Named
Accepts pipeline input False

-XenProperty

Selects which property to use.
Attribute Value
Type XenDriverVariantProperty
Required True
Position Named
Accepts pipeline input False
Accepted values Uuid, Name, Driver, Version, HardwarePresent, Priority, Status

Inputs

  • Driver_variant
  • XenRef[Driver_variant]

Outputs

  • System.Object

Examples

Example 1: Get the Name property

PS> Get-XenDriverVariant -Uuid 1871ac51-ce6b-efc3-7fd0-28bc65aa39ff | Get-XenDriverVariantProperty -XenProperty Name
Gets the Name property of a DriverVariant.

Example 2: Get the Driver property

PS> Get-XenDriverVariant -Uuid 1871ac51-ce6b-efc3-7fd0-28bc65aa39ff | Get-XenDriverVariantProperty -XenProperty Driver
Gets the Driver property of a DriverVariant.

Example 3: Get the Version property

PS> Get-XenDriverVariant -Uuid 1871ac51-ce6b-efc3-7fd0-28bc65aa39ff | Get-XenDriverVariantProperty -XenProperty Version
Gets the Version property of a DriverVariant.