Edit

Share via


Set-VMHostPartitionableGpu

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

Syntax

ComputerName (Default)

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

CimSession

Set-VMHostPartitionableGpu
    [-CimSession] <CimSession[]>
    [-Passthru]
    [-PartitionCount <UInt16>]
    [<CommonParameters>]

Object

Set-VMHostPartitionableGpu
    [-HostPartitionableGpu] <VMHostPartitionableGpu[]>
    [-Passthru]
    [-PartitionCount <UInt16>]
    [<CommonParameters>]

Name

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.

Parameter properties

Type:

CimSession[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CimSession
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments: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.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:0
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Credential

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

Parameter properties

Type:

PSCredential[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ComputerName
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-HostPartitionableGpu

Full GPU object, obtained by executing Get-VMHostPartitionableGpu.

Parameter properties

Type:

VMHostPartitionableGpu[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Object
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the name of the GPU.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Name
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PartitionCount

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

Parameter properties

Type:UInt16
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Passthru

Returns an object for each process that the cmdlet started.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

CimSession

Microsoft.HyperV.PowerShell.VMHostPartitionableGpu

Outputs

Microsoft.HyperV.PowerShell.VMHostPartitionableGpu