New-VM
This cmdlet creates a new virtual machine with the provided parameters. The network adapter and the Small Computer System Interface (SCSI) adapter of the new virtual machine are created of the recommended type for the operating system (OS) that is specified by the GuestId parameter. If the OSCustomizationSpec parameter is used, the virtual machine is customized according to the specification. You must specify values for at least one of the ResourcePool, VMHost, and VApp parameters.
Syntax
-Name
<String>
[-AdvancedOption <AdvancedOption[]>]
[-AlternateGuestName <String>]
[-BootDelayMillisecond <Int64>]
[-CD]
[-CoresPerSocket <Int32>]
[-CpuHotAddEnabled <Boolean>]
[-CpuHotRemoveEnabled <Boolean>]
[-Datastore <StorageResource>]
[-DiskGB <Decimal[]>]
[-DiskMB <Int64[]>]
[-DiskPath <String[]>]
[-DiskStorageFormat <VirtualDiskStorageFormat>]
[-DrsAutomationLevel <DrsAutomationLevel>]
[-Floppy]
[-GuestId <String>]
[-HAIsolationResponse <HAIsolationResponse>]
[-HARestartPriority <HARestartPriority>]
[-HardwareVersion <String>]
[-KeyProvider <KeyProvider>]
[-Location <Folder>]
[-MemoryGB <Decimal>]
[-MemoryHotAddEnabled <Boolean>]
[-MemoryMB <Int64>]
[-MigrationEncryption <VMMigrationEncryptionMode>]
[-NetworkName <String[]>]
[-Notes <String>]
[-NumCpu <Int32>]
[-Portgroup <VirtualPortGroupBase[]>]
[-ReplicationGroup <ReplicationGroup>]
[-ResourcePool <VIContainer>]
[-RunAsync]
[-SEVEnabled <Boolean>]
[-Server <VIServer[]>]
[-SkipHardDisks]
[-StoragePolicy <StoragePolicy>]
[-VApp <VApp>]
[-VMHost <VMHost>]
[-VMSwapfilePolicy <VMSwapfilePolicy>]
[-Version <VMVersion>]
[CommonParameters]
[-AdvancedOption <AdvancedOption[]>]
[-AlternateGuestName <String>]
[-BootDelayMillisecond <Int64>]
[-CD]
[-CoresPerSocket <Int32>]
[-CpuHotAddEnabled <Boolean>]
[-CpuHotRemoveEnabled <Boolean>]
[-Datastore <StorageResource>]
[-DiskGB <Decimal[]>]
[-DiskMB <Int64[]>]
[-DiskPath <String[]>]
[-DiskStorageFormat <VirtualDiskStorageFormat>]
[-DrsAutomationLevel <DrsAutomationLevel>]
[-Floppy]
[-GuestId <String>]
[-HAIsolationResponse <HAIsolationResponse>]
[-HARestartPriority <HARestartPriority>]
[-HardwareVersion <String>]
[-KeyProvider <KeyProvider>]
[-Location <Folder>]
[-MemoryGB <Decimal>]
[-MemoryHotAddEnabled <Boolean>]
[-MemoryMB <Int64>]
[-MigrationEncryption <VMMigrationEncryptionMode>]
[-NetworkName <String[]>]
[-Notes <String>]
[-NumCpu <Int32>]
[-Portgroup <VirtualPortGroupBase[]>]
[-ReplicationGroup <ReplicationGroup>]
[-ResourcePool <VIContainer>]
[-RunAsync]
[-SEVEnabled <Boolean>]
[-Server <VIServer[]>]
[-SkipHardDisks]
[-StoragePolicy <StoragePolicy>]
[-VApp <VApp>]
[-VMHost <VMHost>]
[-VMSwapfilePolicy <VMSwapfilePolicy>]
[-Version <VMVersion>]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
String | named |
|
Specifies a name for the new virtual machine. If you want to register or clone an existing virtual machine, this parameter is not mandatory. | optional |
|
AdvancedOption[] | named |
|
Specifies advanced options for creating virtual machines. Accepts only SdrsVMDiskAntiAffinityRule and SdrsVMAntiAffinityRule objects. The SdrsVMDiskAntiAffinityRule defines a Storage DRS intra-VM anti-affinity rule (vm disk anti-affinity rule). It is only applicable when creating a virtual machine or hard disk on a datastore cluster. You can create an instance of the object by invoking its constructor. There are two constructors - "public SdrsVMDiskAntiAffinityRule(param string[] diskIdentifier)" and "public SdrsVMDiskAntiAffinityRule(param HardDisk[] disk)". For the first constructor, "diskIdentifier" can be either the disk key or the index of the disk in the disk array. The specified disks (and the disk to which the rule is applied) are placed in an anti-affinity rule on a DatastoreCluster. Only one such rule is supported per a virtual machine. You can pass the instance to the AdvancedOption parameter of the New-VM or New-HardDisk cmdlets. The SdrsVMAntiAffinityRule defines a Storage DRS inter-VM anti-affinity rule. It is only applicable when creating a virtual machine on a DatastoreCluster. You can create an instance of the object by invoking its constructor. The constructor has one parameter - an array of virtual machines - "public SdrsVMAntiAffinityRule(param VirtualMachine[] vm)". Then you can pass the instance to the AdvancedOption parameter of the New-VM cmdlet. ?he new virtual machine and the virtual machines specified in the constructor are placed in an inter-VM anti-affinity rule on a DatastoreCluster. | optional |
|
String | named |
|
Specifies the full OS name of the new virtual machine. Use this parameter if the GuestID parameter is set to otherGuest or otherGuest64. | optional |
|
Int64 | named |
|
Specifies the time interval in milliseconds between a virtual machine power on or restart and the beginning of the boot sequence. | optional |
|
SwitchParameter | named |
|
Indicates that you want to add a CD drive to the new virtual machine. | optional |
|
Int32 | named |
|
Specifies the number of virtual CPU cores per socket. | optional |
|
Boolean | named |
|
Specifies if virtual processors can be added to the virtual machine while it is running. | optional |
|
Boolean | named |
|
Specifies if virtual processors can be removed from the virtual machine while it is running. | optional |
|
StorageResource | named |
|
Specifies the datastore where you want to place the new virtual machine. If a DatastoreCluster is passed to the Datastore parameter, the virtual machine is placed in the DatastoreCluster in an automated SDRS mode and with enabled intra-VM affinity rule (unless another rule is specified). You can specify a SDRS rule when creating the virtual machine in a DatastoreCluster by passing either a SdrsVMDiskAntiAffinityRule object or a SdrsVMAntiAffinityRule object to the AdvancedOption parameter. These two rules are mutually exclusive. | optional |
|
Decimal[] | named |
|
Specifies the size in gigabytes (GB) of the disks that you want to create and add to the new virtual machine. | optional |
|
Int64[] | named |
|
This parameter is obsolete. Use DiskGB instead. Specifies the size in megabytes (MB) of the disks that you want to create and add to the new virtual machine. | optional |
|
String[] | named |
|
Specifies paths to virtual disks that you want to add to the new virtual machine. | optional |
|
VirtualDiskStorageFormat | named |
|
Specifies the storage format of the disks of the virtual machine. This parameter accepts Thin, Thick, and EagerZeroedThick values. | optional |
|
DrsAutomationLevel | named |
|
Specifies a DRS (Distributed Resource Scheduler) automation level. The valid values are FullyAutomated, Manual, PartiallyAutomated, AsSpecifiedByCluster, and Disabled. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
SwitchParameter | named |
|
Indicates that you want to add a floppy drive to the new virtual machine. | optional |
|
String | named |
|
Specifies the guest operating system of the new virtual machine. The valid values for specific ESX versions are listed in the description of the VirtualMachineGuestOsIdentifier enumeration type in the vSphere API Reference available at http://www.vmware.com/support/developer/vc-sdk/. Depending on the hardware configuration of the host, some of the guest operating systems might be inapplicable. | optional |
|
HAIsolationResponse | named |
|
Indicates whether the virtual machine should be powered off if a host determines that it is isolated from the rest of the compute resource. The available values are AsSpecifiedByCluster, PowerOff, and DoNothing. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
HARestartPriority | named |
|
Specifies the HA restart priority of the new virtual machine. The valid values are Disabled, Lowest, Low, Medium, High, Highest, and ClusterRestartPriority. VMware High Availability (HA) is a feature that detects failed virtual machines and automatically restarts them on alternative ESX hosts. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
String | named |
|
Specifies the version of the new virtual machine. By default, the new virtual machine is created with the latest available version. | optional |
|
KeyProvider | named |
|
Specifies the key provider that you want to use for the encryption key while creating the new virtual machine. If StoragePolicy is not specified, the default encryption storage policy "VM Encryption Policy" is used. | optional |
|
Folder | named |
|
Specifies the folder where you want to place the new virtual machine. | optional |
|
Decimal | named |
|
Specifies the memory size in gigabytes (GB) of the new virtual machine. | optional |
|
Boolean | named |
|
Specifies if memory can be added to the virtual machine while it is running. | optional |
|
Int64 | named |
|
This parameter is obsolete. Use MemoryGB instead. Specifies the memory size in megabytes (MB) of the new virtual machine. | optional |
|
VMMigrationEncryptionMode | named |
|
Specifies the encryption behavior when migrating the virtual machine. Valid options are: - Disabled: Do not use encrypted vSphere vMotion. - Opportunistic: Use encrypted vSphere vMotion if source and destination hosts support it. Only ESXi versions 6.5 and later use encrypted vSphere vMotion. - Required: Allow only encrypted vSphere vMotion. If the source or destination host does not support encrypted vSphere vMotion, migration with vSphere vMotion is not allowed. | optional |
|
String[] | named |
|
Specifies the networks to which you want to connect the new virtual machine. Specifying a distributed port group name is obsolete. Use the Portgroup parameter instead. | optional |
|
String | named |
|
Provides a description of the new virtual machine. The alias of this parameter is Description. | optional |
|
Int32 | named |
|
Specifies the number of the virtual CPUs of the new virtual machine. | optional |
|
VirtualPortGroupBase[] | named |
|
Specifies standard or distributed port groups to which you want to connect the virtual machine. For each specified port group, a new network adapter is created. | optional |
|
ReplicationGroup | named |
|
Specifies the ReplicationGroup where you want to place the new virtual machine. It is applicable with the storage policy provided in the StoragePolicy parameter. | optional |
|
VIContainer | named |
|
Specifies where you want to place the new virtual machine. The parameter accepts VMHost, Cluster, ResourcePool, and VApp objects. If no value is specified, the virtual machine is added to the resource pool of its host. | optional |
|
SwitchParameter | named |
|
Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter, run "help About_RunAsync" in the VMware PowerCLI console. | optional |
|
Boolean | named |
|
Specifies whether SEV (Secure Encrypted Virtualization) is enabled or not. It allows the CPU to encrypt the memory and the state of the virtual machine. It is applicable for AMD CPUs only. | optional |
|
VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet. | optional |
|
SwitchParameter | named |
|
Specifies whether to apply the StoragePolicy or Encryption to the hard disks in the new virtual machine. | optional |
|
StoragePolicy | named |
|
Specifies the StoragePolicy that you want to attach to the new virtual machine during creation. If the StoragePolicy is an encryption policy, the new virtual machine is encrypted. | optional |
|
VApp | named |
|
This parameter is deprecated. Use the ResourcePool parameter instead. Specifies the vApp where you want to create the new virtual machine. | optional |
|
VMHost | named |
|
Specifies the host on which you want to create the new virtual machine. | optional |
|
VMSwapfilePolicy | named |
|
Specifies the swapfile placement policy. The following values are valid: InHostDataStore - stores the swapfile in the datastore specified by the VMSwapfileDatastoreID property of the virtual machine host. If the VMSwapfileDatastoreID property is not set or indicates a datastore with insufficient free space, the swapfile is stored in the same directory as the virtual machine. This setting might degrade the vMotion performance. WithVM - stores the swapfile in the same directory as the virtual machine. | optional |
|
VMVersion | named |
|
This parameter is deprecated. Use the HardwareVersion parameter instead. Specifies the version of the new virtual machine. The valid values are v4, v7, v8, v9, v10, v11, v12, v13, and v14. By default, the new virtual machine is created with the latest available version. |
-VM
<VirtualMachine[]>
[-AdvancedOption <AdvancedOption[]>]
[-BootDelayMillisecond <Int64>]
[-Datastore <StorageResource>]
[-DiskStorageFormat <VirtualDiskStorageFormat>]
[-DrsAutomationLevel <DrsAutomationLevel>]
[-HAIsolationResponse <HAIsolationResponse>]
[-HARestartPriority <HARestartPriority>]
[-KeyProvider <KeyProvider>]
[-LinkedClone]
[-Location <Folder>]
[-Name <String>]
[-Notes <String>]
[-OSCustomizationSpec <OSCustomizationSpec>]
[-ReferenceSnapshot <Snapshot>]
[-ReplicationGroup <ReplicationGroup>]
[-ResourcePool <VIContainer>]
[-RunAsync]
[-SEVEnabled <Boolean>]
[-Server <VIServer[]>]
[-SkipHardDisks]
[-StoragePolicy <StoragePolicy>]
[-StoragePolicyTarget <StoragePolicyTargetType>]
[-VApp <VApp>]
[-VMHost <VMHost>]
[CommonParameters]
[-AdvancedOption <AdvancedOption[]>]
[-BootDelayMillisecond <Int64>]
[-Datastore <StorageResource>]
[-DiskStorageFormat <VirtualDiskStorageFormat>]
[-DrsAutomationLevel <DrsAutomationLevel>]
[-HAIsolationResponse <HAIsolationResponse>]
[-HARestartPriority <HARestartPriority>]
[-KeyProvider <KeyProvider>]
[-LinkedClone]
[-Location <Folder>]
[-Name <String>]
[-Notes <String>]
[-OSCustomizationSpec <OSCustomizationSpec>]
[-ReferenceSnapshot <Snapshot>]
[-ReplicationGroup <ReplicationGroup>]
[-ResourcePool <VIContainer>]
[-RunAsync]
[-SEVEnabled <Boolean>]
[-Server <VIServer[]>]
[-SkipHardDisks]
[-StoragePolicy <StoragePolicy>]
[-StoragePolicyTarget <StoragePolicyTargetType>]
[-VApp <VApp>]
[-VMHost <VMHost>]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
VirtualMachine[] | named |
|
Specifies a virtual machine that you want to clone. | optional |
|
AdvancedOption[] | named |
|
Specifies advanced options for creating virtual machines. Accepts only SdrsVMDiskAntiAffinityRule and SdrsVMAntiAffinityRule objects. The SdrsVMDiskAntiAffinityRule defines a Storage DRS intra-VM anti-affinity rule (vm disk anti-affinity rule). It is only applicable when creating a virtual machine or hard disk on a datastore cluster. You can create an instance of the object by invoking its constructor. There are two constructors - "public SdrsVMDiskAntiAffinityRule(param string[] diskIdentifier)" and "public SdrsVMDiskAntiAffinityRule(param HardDisk[] disk)". For the first constructor, "diskIdentifier" can be either the disk key or the index of the disk in the disk array. The specified disks (and the disk to which the rule is applied) are placed in an anti-affinity rule on a DatastoreCluster. Only one such rule is supported per a virtual machine. You can pass the instance to the AdvancedOption parameter of the New-VM or New-HardDisk cmdlets. The SdrsVMAntiAffinityRule defines a Storage DRS inter-VM anti-affinity rule. It is only applicable when creating a virtual machine on a DatastoreCluster. You can create an instance of the object by invoking its constructor. The constructor has one parameter - an array of virtual machines - "public SdrsVMAntiAffinityRule(param VirtualMachine[] vm)". Then you can pass the instance to the AdvancedOption parameter of the New-VM cmdlet. ?he new virtual machine and the virtual machines specified in the constructor are placed in an inter-VM anti-affinity rule on a DatastoreCluster. | optional |
|
Int64 | named |
|
Specifies the time interval in milliseconds between a virtual machine power on or restart and the beginning of the boot sequence. | optional |
|
StorageResource | named |
|
Specifies the datastore where you want to place the new virtual machine. If a DatastoreCluster is passed to the Datastore parameter, the virtual machine is placed in the DatastoreCluster in an automated SDRS mode and with enabled intra-VM affinity rule (unless another rule is specified). You can specify a SDRS rule when creating the virtual machine in a DatastoreCluster by passing either a SdrsVMDiskAntiAffinityRule object or a SdrsVMAntiAffinityRule object to the AdvancedOption parameter. These two rules are mutually exclusive. | optional |
|
VirtualDiskStorageFormat | named |
|
Specifies the storage format of the disks of the virtual machine. This parameter accepts Thin, Thick, and EagerZeroedThick values. | optional |
|
DrsAutomationLevel | named |
|
Specifies a DRS (Distributed Resource Scheduler) automation level. The valid values are FullyAutomated, Manual, PartiallyAutomated, AsSpecifiedByCluster, and Disabled. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
HAIsolationResponse | named |
|
Indicates whether the virtual machine should be powered off if a host determines that it is isolated from the rest of the compute resource. The available values are AsSpecifiedByCluster, PowerOff, and DoNothing. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
HARestartPriority | named |
|
Specifies the HA restart priority of the new virtual machine. The valid values are Disabled, Lowest, Low, Medium, High, Highest, and ClusterRestartPriority. VMware High Availability (HA) is a feature that detects failed virtual machines and automatically restarts them on alternative ESX hosts. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
KeyProvider | named |
|
Specifies the key provider that you want to use for the encryption key while creating the new virtual machine. If StoragePolicy is not specified, the default encryption storage policy "VM Encryption Policy" is used. | optional |
|
SwitchParameter | named |
|
Indicates that you want to create a linked clone. When you set the LinkedClone parameter, the ReferenceSnapshot parameter becomes mandatory. | optional |
|
Folder | named |
|
Specifies the folder where you want to place the new virtual machine. | optional |
|
String | named |
|
Specifies a name for the new virtual machine. If you want to register or clone an existing virtual machine, this parameter is not mandatory. | optional |
|
String | named |
|
Provides a description of the new virtual machine. The alias of this parameter is Description. | optional |
|
OSCustomizationSpec | named |
|
Specifies a customization specification that is applied to the new virtual machine. | optional |
|
Snapshot | named |
|
Specifies a source snapshot for the linked clone that you want to create. When you set the LinkedClone parameter, the ReferenceSnapshot parameter becomes mandatory. | optional |
|
ReplicationGroup | named |
|
Specifies the ReplicationGroup where you want to place the new virtual machine. It is applicable with the storage policy provided in the StoragePolicy parameter. | optional |
|
VIContainer | named |
|
Specifies where you want to place the new virtual machine. The parameter accepts VMHost, Cluster, ResourcePool, and VApp objects. If no value is specified, the virtual machine is added to the resource pool of its host. | optional |
|
SwitchParameter | named |
|
Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter, run "help About_RunAsync" in the VMware PowerCLI console. | optional |
|
Boolean | named |
|
Specifies whether SEV (Secure Encrypted Virtualization) is enabled or not. It allows the CPU to encrypt the memory and the state of the virtual machine. It is applicable for AMD CPUs only. | optional |
|
VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet. | optional |
|
SwitchParameter | named |
|
Specifies whether to apply the StoragePolicy or Encryption to the hard disks in the new virtual machine. | optional |
|
StoragePolicy | named |
|
Specifies the StoragePolicy that you want to attach to the new virtual machine during creation. If the StoragePolicy is an encryption policy, the new virtual machine is encrypted. | optional |
|
StoragePolicyTargetType | named |
|
Specifies the target of the StoragePolicy in the virtual machine or in the VM parameter. | optional |
|
VApp | named |
|
This parameter is deprecated. Use the ResourcePool parameter instead. Specifies the vApp where you want to create the new virtual machine. | optional |
|
VMHost | named |
|
Specifies the host on which you want to create the new virtual machine. |
[-ContentLibraryItem]
<ContentLibraryItem>
[-CoresPerSocket <Int32>]
[-Datastore <StorageResource>]
[-DiskGB <Decimal[]>]
[-DiskMB <Int64[]>]
[-DiskStorageFormat <VirtualDiskStorageFormat>]
[-DrsAutomationLevel <DrsAutomationLevel>]
[-HAIsolationResponse <HAIsolationResponse>]
[-HARestartPriority <HARestartPriority>]
[-Location <Folder>]
[-MemoryGB <Decimal>]
[-MemoryMB <Int64>]
[-Name <String>]
[-NetworkName <String[]>]
[-Notes <String>]
[-NumCpu <Int32>]
[-OSCustomizationSpec <OSCustomizationSpec>]
[-OvfConfiguration <Hashtable>]
[-Portgroup <VirtualPortGroupBase[]>]
[-ResourcePool <VIContainer>]
[-RunAsync]
[-Server <VIServer[]>]
[-StoragePolicy <StoragePolicy>]
[-VMHost <VMHost>]
[CommonParameters]
[-CoresPerSocket <Int32>]
[-Datastore <StorageResource>]
[-DiskGB <Decimal[]>]
[-DiskMB <Int64[]>]
[-DiskStorageFormat <VirtualDiskStorageFormat>]
[-DrsAutomationLevel <DrsAutomationLevel>]
[-HAIsolationResponse <HAIsolationResponse>]
[-HARestartPriority <HARestartPriority>]
[-Location <Folder>]
[-MemoryGB <Decimal>]
[-MemoryMB <Int64>]
[-Name <String>]
[-NetworkName <String[]>]
[-Notes <String>]
[-NumCpu <Int32>]
[-OSCustomizationSpec <OSCustomizationSpec>]
[-OvfConfiguration <Hashtable>]
[-Portgroup <VirtualPortGroupBase[]>]
[-ResourcePool <VIContainer>]
[-RunAsync]
[-Server <VIServer[]>]
[-StoragePolicy <StoragePolicy>]
[-VMHost <VMHost>]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
ContentLibraryItem | 1 |
|
Specifies the content library template from which you want to deploy the virtual machine. | optional |
|
Int32 | named |
|
Specifies the number of virtual CPU cores per socket. | optional |
|
StorageResource | named |
|
Specifies the datastore where you want to place the new virtual machine. If a DatastoreCluster is passed to the Datastore parameter, the virtual machine is placed in the DatastoreCluster in an automated SDRS mode and with enabled intra-VM affinity rule (unless another rule is specified). You can specify a SDRS rule when creating the virtual machine in a DatastoreCluster by passing either a SdrsVMDiskAntiAffinityRule object or a SdrsVMAntiAffinityRule object to the AdvancedOption parameter. These two rules are mutually exclusive. | optional |
|
Decimal[] | named |
|
Specifies the size in gigabytes (GB) of the disks that you want to create and add to the new virtual machine. | optional |
|
Int64[] | named |
|
This parameter is obsolete. Use DiskGB instead. Specifies the size in megabytes (MB) of the disks that you want to create and add to the new virtual machine. | optional |
|
VirtualDiskStorageFormat | named |
|
Specifies the storage format of the disks of the virtual machine. This parameter accepts Thin, Thick, and EagerZeroedThick values. | optional |
|
DrsAutomationLevel | named |
|
Specifies a DRS (Distributed Resource Scheduler) automation level. The valid values are FullyAutomated, Manual, PartiallyAutomated, AsSpecifiedByCluster, and Disabled. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
HAIsolationResponse | named |
|
Indicates whether the virtual machine should be powered off if a host determines that it is isolated from the rest of the compute resource. The available values are AsSpecifiedByCluster, PowerOff, and DoNothing. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
HARestartPriority | named |
|
Specifies the HA restart priority of the new virtual machine. The valid values are Disabled, Lowest, Low, Medium, High, Highest, and ClusterRestartPriority. VMware High Availability (HA) is a feature that detects failed virtual machines and automatically restarts them on alternative ESX hosts. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
Folder | named |
|
Specifies the folder where you want to place the new virtual machine. | optional |
|
Decimal | named |
|
Specifies the memory size in gigabytes (GB) of the new virtual machine. | optional |
|
Int64 | named |
|
This parameter is obsolete. Use MemoryGB instead. Specifies the memory size in megabytes (MB) of the new virtual machine. | optional |
|
String | named |
|
Specifies a name for the new virtual machine. If you want to register or clone an existing virtual machine, this parameter is not mandatory. | optional |
|
String[] | named |
|
Specifies the networks to which you want to connect the new virtual machine. Specifying a distributed port group name is obsolete. Use the Portgroup parameter instead. | optional |
|
String | named |
|
Provides a description of the new virtual machine. The alias of this parameter is Description. | optional |
|
Int32 | named |
|
Specifies the number of the virtual CPUs of the new virtual machine. | optional |
|
OSCustomizationSpec | named |
|
Specifies a customization specification that is applied to the new virtual machine. | optional |
|
Hashtable | named |
|
Specifies values for a set of user-configurable OVF properties. | optional |
|
VirtualPortGroupBase[] | named |
|
Specifies standard or distributed port groups to which you want to connect the virtual machine. For each specified port group, a new network adapter is created. | optional |
|
VIContainer | named |
|
Specifies where you want to place the new virtual machine. The parameter accepts VMHost, Cluster, ResourcePool, and VApp objects. If no value is specified, the virtual machine is added to the resource pool of its host. | optional |
|
SwitchParameter | named |
|
Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter, run "help About_RunAsync" in the VMware PowerCLI console. | optional |
|
VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet. | optional |
|
StoragePolicy | named |
|
Specifies the StoragePolicy that you want to attach to the new virtual machine during creation. If the StoragePolicy is an encryption policy, the new virtual machine is encrypted. | optional |
|
VMHost | named |
|
Specifies the host on which you want to create the new virtual machine. |
-VMFilePath
<String>
[-BootDelayMillisecond <Int64>]
[-DrsAutomationLevel <DrsAutomationLevel>]
[-HAIsolationResponse <HAIsolationResponse>]
[-HARestartPriority <HARestartPriority>]
[-Location <Folder>]
[-Name <String>]
[-Notes <String>]
[-ResourcePool <VIContainer>]
[-RunAsync]
[-SEVEnabled <Boolean>]
[-Server <VIServer[]>]
[-VApp <VApp>]
[-VMHost <VMHost>]
[CommonParameters]
[-BootDelayMillisecond <Int64>]
[-DrsAutomationLevel <DrsAutomationLevel>]
[-HAIsolationResponse <HAIsolationResponse>]
[-HARestartPriority <HARestartPriority>]
[-Location <Folder>]
[-Name <String>]
[-Notes <String>]
[-ResourcePool <VIContainer>]
[-RunAsync]
[-SEVEnabled <Boolean>]
[-Server <VIServer[]>]
[-VApp <VApp>]
[-VMHost <VMHost>]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
String | named |
|
Specifies a path to the virtual machine that you want to register. | optional |
|
Int64 | named |
|
Specifies the time interval in milliseconds between a virtual machine power on or restart and the beginning of the boot sequence. | optional |
|
DrsAutomationLevel | named |
|
Specifies a DRS (Distributed Resource Scheduler) automation level. The valid values are FullyAutomated, Manual, PartiallyAutomated, AsSpecifiedByCluster, and Disabled. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
HAIsolationResponse | named |
|
Indicates whether the virtual machine should be powered off if a host determines that it is isolated from the rest of the compute resource. The available values are AsSpecifiedByCluster, PowerOff, and DoNothing. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
HARestartPriority | named |
|
Specifies the HA restart priority of the new virtual machine. The valid values are Disabled, Lowest, Low, Medium, High, Highest, and ClusterRestartPriority. VMware High Availability (HA) is a feature that detects failed virtual machines and automatically restarts them on alternative ESX hosts. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
Folder | named |
|
Specifies the folder where you want to place the new virtual machine. | optional |
|
String | named |
|
Specifies a name for the new virtual machine. If you want to register or clone an existing virtual machine, this parameter is not mandatory. | optional |
|
String | named |
|
Provides a description of the new virtual machine. The alias of this parameter is Description. | optional |
|
VIContainer | named |
|
Specifies where you want to place the new virtual machine. The parameter accepts VMHost, Cluster, ResourcePool, and VApp objects. If no value is specified, the virtual machine is added to the resource pool of its host. | optional |
|
SwitchParameter | named |
|
Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter, run "help About_RunAsync" in the VMware PowerCLI console. | optional |
|
Boolean | named |
|
Specifies whether SEV (Secure Encrypted Virtualization) is enabled or not. It allows the CPU to encrypt the memory and the state of the virtual machine. It is applicable for AMD CPUs only. | optional |
|
VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet. | optional |
|
VApp | named |
|
This parameter is deprecated. Use the ResourcePool parameter instead. Specifies the vApp where you want to create the new virtual machine. | optional |
|
VMHost | named |
|
Specifies the host on which you want to create the new virtual machine. |
[-Template]
<Template>
-Name <String>
[-AdvancedOption <AdvancedOption[]>]
[-BootDelayMillisecond <Int64>]
[-Datastore <StorageResource>]
[-DiskStorageFormat <VirtualDiskStorageFormat>]
[-DrsAutomationLevel <DrsAutomationLevel>]
[-HAIsolationResponse <HAIsolationResponse>]
[-HARestartPriority <HARestartPriority>]
[-KeyProvider <KeyProvider>]
[-Location <Folder>]
[-NetworkName <String[]>]
[-Notes <String>]
[-OSCustomizationSpec <OSCustomizationSpec>]
[-Portgroup <VirtualPortGroupBase[]>]
[-ReplicationGroup <ReplicationGroup>]
[-ResourcePool <VIContainer>]
[-RunAsync]
[-SEVEnabled <Boolean>]
[-Server <VIServer[]>]
[-SkipHardDisks]
[-StoragePolicy <StoragePolicy>]
[-StoragePolicyTarget <StoragePolicyTargetType>]
[-VApp <VApp>]
[-VMHost <VMHost>]
[CommonParameters]
-Name <String>
[-AdvancedOption <AdvancedOption[]>]
[-BootDelayMillisecond <Int64>]
[-Datastore <StorageResource>]
[-DiskStorageFormat <VirtualDiskStorageFormat>]
[-DrsAutomationLevel <DrsAutomationLevel>]
[-HAIsolationResponse <HAIsolationResponse>]
[-HARestartPriority <HARestartPriority>]
[-KeyProvider <KeyProvider>]
[-Location <Folder>]
[-NetworkName <String[]>]
[-Notes <String>]
[-OSCustomizationSpec <OSCustomizationSpec>]
[-Portgroup <VirtualPortGroupBase[]>]
[-ReplicationGroup <ReplicationGroup>]
[-ResourcePool <VIContainer>]
[-RunAsync]
[-SEVEnabled <Boolean>]
[-Server <VIServer[]>]
[-SkipHardDisks]
[-StoragePolicy <StoragePolicy>]
[-StoragePolicyTarget <StoragePolicyTargetType>]
[-VApp <VApp>]
[-VMHost <VMHost>]
[CommonParameters]
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required |
|
Template | 1 |
|
Specifies the virtual machine template that you want to use for the creation of the new virtual machine. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. | required |
|
String | named |
|
Specifies a name for the new virtual machine. If you want to register or clone an existing virtual machine, this parameter is not mandatory. | optional |
|
AdvancedOption[] | named |
|
Specifies advanced options for creating virtual machines. Accepts only SdrsVMDiskAntiAffinityRule and SdrsVMAntiAffinityRule objects. The SdrsVMDiskAntiAffinityRule defines a Storage DRS intra-VM anti-affinity rule (vm disk anti-affinity rule). It is only applicable when creating a virtual machine or hard disk on a datastore cluster. You can create an instance of the object by invoking its constructor. There are two constructors - "public SdrsVMDiskAntiAffinityRule(param string[] diskIdentifier)" and "public SdrsVMDiskAntiAffinityRule(param HardDisk[] disk)". For the first constructor, "diskIdentifier" can be either the disk key or the index of the disk in the disk array. The specified disks (and the disk to which the rule is applied) are placed in an anti-affinity rule on a DatastoreCluster. Only one such rule is supported per a virtual machine. You can pass the instance to the AdvancedOption parameter of the New-VM or New-HardDisk cmdlets. The SdrsVMAntiAffinityRule defines a Storage DRS inter-VM anti-affinity rule. It is only applicable when creating a virtual machine on a DatastoreCluster. You can create an instance of the object by invoking its constructor. The constructor has one parameter - an array of virtual machines - "public SdrsVMAntiAffinityRule(param VirtualMachine[] vm)". Then you can pass the instance to the AdvancedOption parameter of the New-VM cmdlet. ?he new virtual machine and the virtual machines specified in the constructor are placed in an inter-VM anti-affinity rule on a DatastoreCluster. | optional |
|
Int64 | named |
|
Specifies the time interval in milliseconds between a virtual machine power on or restart and the beginning of the boot sequence. | optional |
|
StorageResource | named |
|
Specifies the datastore where you want to place the new virtual machine. If a DatastoreCluster is passed to the Datastore parameter, the virtual machine is placed in the DatastoreCluster in an automated SDRS mode and with enabled intra-VM affinity rule (unless another rule is specified). You can specify a SDRS rule when creating the virtual machine in a DatastoreCluster by passing either a SdrsVMDiskAntiAffinityRule object or a SdrsVMAntiAffinityRule object to the AdvancedOption parameter. These two rules are mutually exclusive. | optional |
|
VirtualDiskStorageFormat | named |
|
Specifies the storage format of the disks of the virtual machine. This parameter accepts Thin, Thick, and EagerZeroedThick values. | optional |
|
DrsAutomationLevel | named |
|
Specifies a DRS (Distributed Resource Scheduler) automation level. The valid values are FullyAutomated, Manual, PartiallyAutomated, AsSpecifiedByCluster, and Disabled. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
HAIsolationResponse | named |
|
Indicates whether the virtual machine should be powered off if a host determines that it is isolated from the rest of the compute resource. The available values are AsSpecifiedByCluster, PowerOff, and DoNothing. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
HARestartPriority | named |
|
Specifies the HA restart priority of the new virtual machine. The valid values are Disabled, Lowest, Low, Medium, High, Highest, and ClusterRestartPriority. VMware High Availability (HA) is a feature that detects failed virtual machines and automatically restarts them on alternative ESX hosts. Passing values to this parameter through a pipeline is deprecated and will be deactivated in a future release. Specifying this parameter is only supported when the virtual machine is inside a cluster. Otherwise, an error appears. | optional |
|
KeyProvider | named |
|
Specifies the key provider that you want to use for the encryption key while creating the new virtual machine. If StoragePolicy is not specified, the default encryption storage policy "VM Encryption Policy" is used. | optional |
|
Folder | named |
|
Specifies the folder where you want to place the new virtual machine. | optional |
|
String[] | named |
|
Specifies the networks to which you want to connect the new virtual machine. Specifying a distributed port group name is obsolete. Use the Portgroup parameter instead. | optional |
|
String | named |
|
Provides a description of the new virtual machine. The alias of this parameter is Description. | optional |
|
OSCustomizationSpec | named |
|
Specifies a customization specification that is applied to the new virtual machine. | optional |
|
VirtualPortGroupBase[] | named |
|
Specifies standard or distributed port groups to which you want to connect the virtual machine. For each specified port group, a new network adapter is created. | optional |
|
ReplicationGroup | named |
|
Specifies the ReplicationGroup where you want to place the new virtual machine. It is applicable with the storage policy provided in the StoragePolicy parameter. | optional |
|
VIContainer | named |
|
Specifies where you want to place the new virtual machine. The parameter accepts VMHost, Cluster, ResourcePool, and VApp objects. If no value is specified, the virtual machine is added to the resource pool of its host. | optional |
|
SwitchParameter | named |
|
Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter, run "help About_RunAsync" in the VMware PowerCLI console. | optional |
|
Boolean | named |
|
Specifies whether SEV (Secure Encrypted Virtualization) is enabled or not. It allows the CPU to encrypt the memory and the state of the virtual machine. It is applicable for AMD CPUs only. | optional |
|
VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet. | optional |
|
SwitchParameter | named |
|
Specifies whether to apply the StoragePolicy or Encryption to the hard disks in the new virtual machine. | optional |
|
StoragePolicy | named |
|
Specifies the StoragePolicy that you want to attach to the new virtual machine during creation. If the StoragePolicy is an encryption policy, the new virtual machine is encrypted. | optional |
|
StoragePolicyTargetType | named |
|
Specifies the target of the StoragePolicy in the virtual machine or in the VM parameter. | optional |
|
VApp | named |
|
This parameter is deprecated. Use the ResourcePool parameter instead. Specifies the vApp where you want to create the new virtual machine. | optional |
|
VMHost | named |
|
Specifies the host on which you want to create the new virtual machine. |
Output
VMware.VimAutomation.ViCore.Types.V1.Inventory.VirtualMachine
Examples
Example 1
$myTargetVMHost = Get-VMHost -Name MyVMHost1
New-VM -Name MyVM1 -ResourcePool $myTargetVMHost -Datastore MyDatastore1 -NumCPU 2 -MemoryGB 4 -DiskGB 40 -NetworkName "VM Network" -Floppy -CD -DiskStorageFormat Thin -GuestID winNetDatacenterGuest
Creates a virtual machine by specifying a target host, a target datastore, and a network to connect to, and configures the settings for the virtual machine.
Example 2
$myCluster = Get-Cluster -Name MyCluster1
New-VM -Name MyVM1 -ResourcePool $myCluster
Creates a virtual machine by specifying a cluster. The ResourcePool parameter accepts ResourcePool, Cluster, VApp, and standalone VMHost objects.
Example 3
$vmhost = Get-VMHost -Name MyVMHost1
$myCluster = Get-Cluster -Name MyCluster1
New-VM -Name MyVM1 -VMHost $vmhost -ResourcePool $myCluster -DiskGB 4 -MemoryGB 1
Creates a virtual machine by specifying a cluster and explicitly selecting the host, instead of allowing autoselection of a target host.
Example 4
$vmhost = Get-VMHost -Name MyVMHost1
New-VM -Name MyVM1 -ResourePool $vmhost -DiskGB 40,100
Creates a virtual machine with multiple disks.
Example 5
$vmhost = Get-VMHost -Name MyVMHost1
New-VM -Name MyVM1 -ResourcePool $vmhost -DiskPath "[Storage1] WindowsXP/WindowsXP.vmdk"
Creates a virtual machine by specifying an existing disk.
Example 6
$vmhost = Get-VMHost -Name MyVMHost1
New-VM -Name MyVM1 -ResourcePool $vmhost -HardwareVersion vmx-04
Creates a virtual machine by explicitly specifying the version of the virtual machine hardware through the HardwareVersion parameter.
Example 7
$keyprovider = Get-KeyProvider "MyKeyProvider"
$ds = Get-Datastore -VMHost MyHost1
New-VM -Name 'MyVM' -VMHost MyHost1 -Datastore $ds -KeyProvider $keyprovider
Creates an encrypted virtual machine on the given $ds datastore and MyHost1 host.
Example 8
$policy = Get-SpbmStoragePolicy "MyPolicy"
$ds = Get-Datastore -VMHost MyHost1
New-VM -Name 'MyVM' -VMHost MyHost1 -Datastore $ds -StoragePolicy $policy -SkipHardDisks
Creates a virtual machine with the $policy storage policy attached to its VM Home on the given $ds datastore and MyHost1 host. If the $policy is an encryption policy, VM Home of the virtual machine is encrypted during creation.
Example 9
$myDatastore = Get-Datastore -Name MyDatastore1
$vmhost = Get-VMHost -Name MyVMHost1
New-VM -Name MyVM2 -VM MyVM1 -Datastore $myDatastore -VMHost $vmhost
Creates a new virtual machine named MyVM2 by cloning the MyVM1 virtual machine on the specified datastore and host.
Example 10
New-VM -VM MyVM1, MyVM2 -Location MyFolder1 -VMHost MyHost1
Copies the MyVM1 and MyVM2 virtual machines to the MyFolder1 folder on the MyHost1 host.
Example 11
$myResourcePool = Get-ResourcePool -Name MyResourcePool1
$mySpecification = Get-OSCustomizationSpec -Name WindowsSpec
New-VM -VM MyVM1 -Name MyVM2 -OSCustomizationSpec $mySpecification -ResourcePool $myResourcePool
Clones the virtual machine MyVM1 to MyVM2 and applies a customization specification on the cloned virtual machine.
Example 12
$myResourcePool = Get-ResourcePool -Name MyResourcePool1
$myTemplate = Get-Template -Name WindowsTemplate
$mySpecification = Get-OSCustomizationSpec -Name WindowsSpec
New-VM -Name MyVM2 -Template $myTemplate -ResourcePool $myResourcePool -OSCustomizationSpec $mySpecification
Creates a virtual machine from the specified template and applies the specified customization specification.
Example 13
cd vmstores:\myserver@443\Datacenter\Storage1\MyVM1\
$vmxFile = Get-Item MyVM1.vmx
$vmhost = Get-VMHost -Name MyVMHost1
New-VM -VMHost $vmhost -VMFilePath $vmxFile.DatastoreFullPath
Retrieves the specified configuration file for the MyVM1 virtual machine and registers the MyVM1 virtual machine on the specified host.
Example 14
$vmhost = Get-VMHost -Name MyVMHost1
$myDatastoreCluster = Get-DatastoreCluster -Name MyStorageCluster1
New-VM -Name MyVM1 -DiskGB 40,40 -Datastore $myDatastoreCluster -ResourcePool $vmhost
Creates a virtual machine on a datastore cluster. By default, the new virtual machine has an intra-VM affinity rule.
Example 15
$vmhost = Get-VMHost -Name MyVMHost1
$myDatastoreCluster = Get-DatastoreCluster -Name MyStorageCluster1
$myAdvancedOption = New-Object 'VMware.VimAutomation.ViCore.Types.V1.DatastoreManagement.SdrsVMDiskAntiAffinityRule' 1,2
New-VM -Name MyVM1 -DiskGB 40,40,40 -Datastore $myDatastoreCluster -AdvancedOption $myAdvancedOption -ResourcePool $vmhost
Creates a virtual machine on a datastore cluster. The machine has three hard disks. For the first two disks, the intra-VM anti-affinity rule is specified and the disks are placed on a datastore different from the datastore cluster. Identifying the hard disk in the intra-VM anti-affinity happens by indexing the disks starting from 1.
Example 16
$myVM1 = Get-VM -Name WindowsXP
$myResourcePool = Get-ResourcePool -Name MyResourcePool1
$myAdvancedOption = New-Object 'VMware.VimAutomation.ViCore.Types.V1.DatastoreManagement.SdrsVMAntiAffinityRule' $myVM1
$myDatastoreCluster = Get-DatastoreCluster -Name MyStorageCluster1
New-VM -Name MyVM1 -DiskGB 40,40,40 -Datastore $myDatastoreCluster -AdvancedOption $myAdvancedOption -ResourcePool $myResourcePool
Creates a virtual machine on a datastore cluster and specifies a VM anti-affinity rule between the new virtual machine and an existing virtual machine.
Example 17
$mySourceVM = Get-VM -Name MySourceVM1
$vmhost = Get-VMHost -Name MyVMHost1
$hardDiskList = Get-HardDisk -VM $vm | select -First 2
$myDatastoreCluster = Get-DatastoreCluster -Name MyStorageCluster1
$myAdvancedOption = New-Object 'VMware.VimAutomation.ViCore.Types.V1.DatastoreManagement.SdrsVMDiskAntiAffinityRule' $hardDiskList
New-VM -Name MyVM1 -VM $mySourceVM -Datastore $myDatastoreCluster -AdvancedOption $myAdvancedOption -ResourcePool $vmhost
Clones a virtual machine on a datastore cluster and specifies an intra-VM anti-affinity rule by using references to the hard disks of the source virtual machine. When you apply this rule to the AdvancedOption parameter of the New-VM cmdlet, the first disk and the second disk of the new virtual machine are placed on different datastores within the specified datastore cluster.
Example 18
$mySourceVM = Get-VM -Name MySourceVM1
$myVM1 = Get-VM -Name WindowsXP
$myAdvancedOption = New-Object 'VMware.VimAutomation.ViCore.Types.V1.DatastoreManagement.SdrsVMAntiAffinityRule' $myVM1
$myDatastoreCluster = Get-DatastoreCluster -Name MyStorageCluster1
$vmhost = Get-VMHost -Name MyVMHost1
New-VM -Name MyVM2 -VM $mySourceVM -Datastore $myDatastoreCluster -AdvancedOption $myAdvancedOption -ResourcePool $vmhost
Clones a virtual machine on a datastore cluster and specifies a VM anti-afffinity rule between the new virtual machine and an existing virtual machine. When you apply this rule to the AdvancedOption parameter of the New-VM cmdlet, the new virtual machine and the WindowsXP virtual machine are placed on different datastores within the specified datastore cluster.
Example 19
$mySourceTemplate = Get-Template -Name WindowsTemplate
$myDatastoreCluster = Get-DatastoreCluster -Name MyStorageCluster
$myAdvancedOption = New-Object 'VMware.VimAutomation.ViCore.Types.V1.DatastoreManagement.SdrsVMDiskAntiAffinityRule' $hardDiskList
$vmhost = Get-VMHost -Name MyVMHost1
New-VM -Name MyVM1 -Template $mySourceTemplate -Datastore $myDatastoreCluster -AdvancedOption $myAdvancedOption -ResourcePool $vmhost
Creates a virtual machine from a template, specifies a VM anti-affinity rule, and stores the virtual machine on a specified datastore cluster.
Example 20
$vmhost = Get-VMHost -Name MyVMHost1
$myVM = Get-VM -Name WindowsXP
$mySourceTemplate = Get-Template -Name WindowsTemplate
$myDatastoreCluster = Get-DatastoreCluster -Name MyStorageCluster1
$myAdvancedOption = New-Object 'VMware.VimAutomation.ViCore.Types.V1.DatastoreManagement.SdrsVMAntiAffinityRule' $myVM
New-VM -Name VM -Template $mySourceTemplate -Datastore $myDatastoreCluster -AdvancedOption $myAdvancedOption -ResourcePool $vmhost
Creates a virtual machine from a template, specifies a VM anti-affinity rule, and stores the virtual machine on a specified datastore cluster.
Example 21
$mySourceVM = Get-VM -Name MySourceVM1
$myReferenceSnapshot = Get-Snapshot -VM $mySourceVM -Name "InitialState"
$vmhost = Get-VMHost -Name MyVMHost1
$myDatastore = Get-Datastore -Name MyDatastore1
New-VM -Name MyLinkedCloneVM1 -VM $mySourceVM -LinkedClone -ReferenceSnapshot $myReferenceSnapshot -ResourcePool $vmhost -Datastore $myDatastore
Creates a linked clone from the specified snapshot of the parent virtual machine. The linked clone is stored on the specified VM host and datastore.
Example 22
$myCluster = Get-Cluster -Name "MyCluster"
$myVDPortGroup = Get-VDPortgroup -Name "MyVDPortGroup"
$mySharedDatastore = Get-Datastore -Name "MySharedDatastore"
New-VM -Name MyVM -ResourcePool $myCluster -Portgroup $myVDPortGroup -DiskGB 40 -MemoryGB 4 -Datastore $mySharedDatastore
Creates a new virtual machine with the specified configuration and connects it to the specified distributed port group.
Example 23
$vmhost = Get-VMHost -Name MyVMHost1
New-VM -Name MyVM1 -VMHost $vmhost -SEVEnabled $true
Creates a new virtual machine and enables SEV (Secure Encrypted Virtualization) for the virtual machine.
Example 24
$datastore = Get-Datastore -Name 'MyDatastore'
$portGroup = Get-VirtualPortGroup -Name "VM Network" -Standard
$contentLibraryItem = Get-ContentLibraryItem -Name 'MyContentLibraryItem'
$target = Get-VMHost -Name 'MyVMHost'
$ovfConfig = Get-OvfConfiguration -ContentLibraryItem $contentLibraryItem -Target $target
$ovfConfig.EULAs.Accept.Value = $true
$ovfConfig.NetworkMapping.Network.Value = $portGroup
New-VM -Name 'MyVM1' -VMHost $target -Datastore $datastore -ContentLibraryItem $contentLibraryItem -OvfConfiguration $ovfConfig
Deploys a virtual machine named MyVM1 from a content library item by specifying network mapping with a standard port group object and accepting all EULAs.
Example 25
$vmhost = Get-VMHost -Name 'MyVMHost'
$contentLibraryItem = Get-ContentLibraryItem -Name 'MyContentLibraryItem'
$datastore = Get-Datastore -Name 'MyDatastore'
$vdPortGroup = Get-VDPortgroup -Name 'MyVDPortGroup''
New-VM -Name 'MyVM1' -VMHost $vmhost -ContentLibraryItem $contentLibraryItem -Datastore $datastore -NumCpu 1 -MemoryGB 1 -DiskGB 4 -Portgroup $vdPortGroup
Deploys a virtual machine named 'MyVM1' from a virtual machine template content library item with the specified configuration and connects the virtual machine to the specified distributed port group.
Example 26
$vmhost = Get-VMHost -Name 'MyVMHost'
$datastore = Get-Datastore -Name 'MyDatastore'
New-VM -Name 'MyVM1' -VMHost $vmhost -Datastore $datastore -MemoryGB 1 -DiskGB 4 -BootDelayMillisecond 5000
Creates a virtual machine named 'MyVM1' and sets the boot delay between the virtual machine power on or restart and the beginning of the boot sequence to 5000 milliseconds.
Related Commands
VM
This cmdlet retrieves the virtual machines on a vCenter Server system.
This cmdlet moves virtual machines to another location.
This cmdlet restarts the specified virtual machines.
This cmdlet modifies the configuration of the virtual machine.
This cmdlet powers on virtual machines.
This cmdlet powers off virtual machines.
This cmdlet suspends virtual machines.
This cmdlet removes the specified virtual machines from the vCenter Server system.
This cmdlet creates a new virtual machine.
VMConsoleWindow
This cmdlet opens a window to the virtual machine's console.
VMGuest
This cmdlet retrieves the guest operating systems of the specified virtual machines.
This cmdlet restarts the virtual machine guest operating systems.
This cmdlet shuts down the specified virtual machine guest OS.
This cmdlet suspends the specified guest operating systems.
VMGuestDisk
This cmdlet retrieves storage volumes as seen by the virtual machines' guest operating systems.
VMGuestFile
This cmdlet copies files and folders from and to the guest OS of the specified virtual machines using VMware Tools.
VMQuestion
This cmdlet retrieves the pending questions for the specified virtual machines.
This cmdlet answers the specified virtual machine question.
VMResourceConfiguration
This cmdlet retrieves information about the resource allocation between the selected virtual machines.
This cmdlet configures resource allocation between the virtual machines.
VMScript
This cmdlet runs a script in the guest OS of each of the specified virtual machines.
VMStartPolicy
This cmdlet retrieves the start policy of the virtual machines on a vCenter Server system.
This cmdlet modifies the virtual machine start policy.
