Edit

Share via

Set-VMHostPartitionableGpu

  • Reference
Module:
Hyper-V

Configures the host partitionable GPU to the number of partitions supported by the manufacturer.

Syntax

Set-VMHostPartitionableGpu
   [[-ComputerName] <String[]>]
   [[-Credential] <PSCredential[]>]
   [-Passthru]
   [-PartitionCount <UInt16>]
   [<CommonParameters>]
Set-VMHostPartitionableGpu
   [-CimSession] <CimSession[]>
   [-Passthru]
   [-PartitionCount <UInt16>]
   [<CommonParameters>]
Set-VMHostPartitionableGpu
   [-HostPartitionableGpu] <VMHostPartitionableGpu[]>
   [-Passthru]
   [-PartitionCount <UInt16>]
   [<CommonParameters>]
Set-VMHostPartitionableGpu
   [-Passthru]
   [-Name <String>]
   [-PartitionCount <UInt16>]
   [<CommonParameters>]

Description

The Set-VMHostPartitionableGpu cmdlet configures the host partitionable GPU to the number of partitions supported by the manufacturer.

Examples

Example 1

Set-VMHostPartitionableGpu -ComputerName "MyHost" -PartitionCount 8

This example partitions a GPU in a specific host into eight partitions.

Example 2

$GPU = Get-VMHostPartitionableGpu -Name "GPUDeviceIDName"
Set-VMHostPartitionableGpu -Name $GPU -PartitionCount 4

This example partitions a GPU in a host into four partitions by using the GPU device ID name.

Parameters

-CimSession

Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.

Type:CimSession[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Specifies one or more Hyper-V hosts on the virtual network adapters are to be retrieved. NetBIOS names, IP addresses, and fully qualified domain names are allowed. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

Type:PSCredential[]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostPartitionableGpu

Full GPU object, obtained by executing Get-VMHostPartitionableGpu.

Type:VMHostPartitionableGpu[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifies the name of the GPU.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartitionCount

Specifies the number of partitions that the GPU will assign. The number of partitions is defined by the manufacturer.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Passthru

Returns an object for each process that the cmdlet started.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

CimSession[]

Microsoft.HyperV.PowerShell.VMHostPartitionableGpu[]

Outputs

Microsoft.HyperV.PowerShell.VMHostPartitionableGpu