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 SampleHost -partitioncount 8

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

Example 2

$GPU = Get-VMHostPartitionableGpu -name "SampleGPUDeviceIDName"
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