New-VMResourcePool
Creates a resource pool.
Syntax
New-VMResourcePool
[-Name] <String>
[-ResourcePoolType] <VMResourcePoolType[]>
[[-ParentName] <String[]>]
[[-Paths] <Object[]>]
[-ComputerName <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The New-VMResourcePool cmdlet creates a resource pool.
Examples
Example 1
PS C:\> New-VMResourcePool "New Resource Pool" VHD -Paths d:\VHDs
Creates a new virtual hard disk resource pool associated with a single path.
Example 2
PS C:\> New-VMResourcePool "New Resource Pool" VHD -Paths "d:\VHDs","e:\Temp"
Creates a new virtual hard disk resource pool associated with multiple paths.
Example 3
PS C:\> New-VMResourcePool "New Resource Pool" Ethernet
Creates a new ethernet resource pool.
Parameters
-ComputerName
Specifies one or more Hyper-V hosts on which the resource pool is to be created. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer - use "localhost" or a dot (".") to specify the local computer explicitly.
Type: | String[] |
Position: | Named |
Default value: | . |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specifies the name of the resource pool
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ParentName
Specifies the name of the parent resource pool for the new resource pool.
Type: | String[] |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Paths
Specifies an array of paths to be associated with a new storage resource pool.
Type: | Object[] |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourcePoolType
Specifies the resource type of the resource pool.
Type: | VMResourcePoolType[] |
Accepted values: | Memory, Processor, Ethernet, VHD, ISO, VFD, FibreChannelPort, FibreChannelConnection |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Outputs
Microsoft.HyperV.PowerShell.ResourcePool
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for