New-SCVirtualMachine

模組:

VirtualMachineManager

建立要由 VMM 管理的虛擬機。

語法

New-SCVirtualMachine
   [-StartVM]
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-Generation <Int32>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   -VMHost <Host>
   -Path <String>
   [-UseLocalVirtualHardDisk]
   [-UseDiffDiskOptimization]
   [-DelayStartSeconds <Int32>]
   [-HighlyAvailable \<Boolean\>]
   [-DRProtectionRequired \<Boolean\>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-ReplicationGroup <ReplicationGroup>]
   [-BlockDynamicOptimization \<Boolean\>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPURelativeWeight <Int32>]
   [-HardwareProfile <HardwareProfile>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-CPUCyclesReservePercent <UInt16>]
   [-CPUCyclesLimitPercent <UInt16>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-SecureBootEnabled \<Boolean\>]
   [-SecureBootTemplate <String>]
   [-JobGroup <Guid>]
   [-SkipInstallVirtualizationGuestServices]
   [-ReturnImmediately]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualMachine
   [-StartVM]
   -VMTemplate <Template>
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-VMShieldingData <KeyFile>]
   -VMHost <Host>
   -Path <String>
   [-UseLocalVirtualHardDisk]
   [-UseDiffDiskOptimization]
   [-DelayStartSeconds <Int32>]
   [-HighlyAvailable \<Boolean\>]
   [-DRProtectionRequired \<Boolean\>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-ReplicationGroup <ReplicationGroup>]
   [-BlockDynamicOptimization \<Boolean\>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPURelativeWeight <Int32>]
   [-HardwareProfile <HardwareProfile>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-CPUCyclesReservePercent <UInt16>]
   [-CPUCyclesLimitPercent <UInt16>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-SecureBootEnabled \<Boolean\>]
   [-SecureBootTemplate <String>]
   [-GuestOSProfile <GuestOSProfile>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-TimeZone <Int32>]
   [-MergeAnswerFile \<Boolean\>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-Domain <String>]
   [-DomainJoinCredential <VMMCredential>]
   [-Workgroup <String>]
   [-AnswerFile <Script>]
   [-JobGroup <Guid>]
   [-SkipInstallVirtualizationGuestServices]
   [-ReturnImmediately]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualMachine
   [-StartVM]
   -VM <VM>
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   -Cloud <Cloud>
   [-CapabilityProfile <CapabilityProfile>]
   [-UseLocalVirtualHardDisk]
   [-UseDiffDiskOptimization]
   [-StoreToLibrary]
   [-DelayStartSeconds <Int32>]
   [-SelfServiceRole <SelfServiceUserRole>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPURelativeWeight <Int32>]
   [-HardwareProfile <HardwareProfile>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-CPUCyclesReservePercent <UInt16>]
   [-CPUCyclesLimitPercent <UInt16>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-SecureBootEnabled \<Boolean\>]
   [-SecureBootTemplate <String>]
   [-JobGroup <Guid>]
   [-SkipInstallVirtualizationGuestServices]
   [-ReturnImmediately]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualMachine
   [-StartVM]
   -VM <VM>
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   -VMHost <Host>
   -Path <String>
   [-UseLocalVirtualHardDisk]
   [-UseDiffDiskOptimization]
   [-DelayStartSeconds <Int32>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPURelativeWeight <Int32>]
   [-HardwareProfile <HardwareProfile>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-CPUCyclesReservePercent <UInt16>]
   [-CPUCyclesLimitPercent <UInt16>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-SecureBootEnabled \<Boolean\>]
   [-SecureBootTemplate <String>]
   [-JobGroup <Guid>]
   [-SkipInstallVirtualizationGuestServices]
   [-ReturnImmediately]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualMachine
   [-StartVM]
   -VirtualHardDisk <StandaloneVirtualHardDisk>
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-Generation <Int32>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   -VMHost <Host>
   -Path <String>
   [-UseLocalVirtualHardDisk]
   [-UseDiffDiskOptimization]
   [-DelayStartSeconds <Int32>]
   [-HighlyAvailable \<Boolean\>]
   [-DRProtectionRequired \<Boolean\>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-ReplicationGroup <ReplicationGroup>]
   [-BlockDynamicOptimization \<Boolean\>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPURelativeWeight <Int32>]
   [-HardwareProfile <HardwareProfile>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-CPUCyclesReservePercent <UInt16>]
   [-CPUCyclesLimitPercent <UInt16>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-SecureBootEnabled \<Boolean\>]
   [-SecureBootTemplate <String>]
   [-JobGroup <Guid>]
   [-SkipInstallVirtualizationGuestServices]
   [-ReturnImmediately]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualMachine
   [-StartVM]
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   -VMConfiguration <BaseVMConfiguration>
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-VMShieldingData <KeyFile>]
   [-Cloud <Cloud>]
   [-CapabilityProfile <CapabilityProfile>]
   [-UseLocalVirtualHardDisk]
   [-UseDiffDiskOptimization]
   [-StoreToLibrary]
   [-DelayStartSeconds <Int32>]
   [-SelfServiceRole <SelfServiceUserRole>]
   [-BlockDynamicOptimization \<Boolean\>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPURelativeWeight <Int32>]
   [-HardwareProfile <HardwareProfile>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-CPUCyclesReservePercent <UInt16>]
   [-CPUCyclesLimitPercent <UInt16>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-SecureBootEnabled \<Boolean\>]
   [-SecureBootTemplate <String>]
   [-GuestOSProfile <GuestOSProfile>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-TimeZone <Int32>]
   [-MergeAnswerFile \<Boolean\>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-Domain <String>]
   [-DomainJoinCredential <VMMCredential>]
   [-Workgroup <String>]
   [-AnswerFile <Script>]
   [-JobGroup <Guid>]
   [-SkipInstallVirtualizationGuestServices]
   [-ReturnImmediately]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualMachine
   -VirtualHardDisk <StandaloneVirtualHardDisk>
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-Generation <Int32>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   -LibraryServer <LibraryServer>
   -SharePath <String>
   [-UseLocalVirtualHardDisk]
   [-UseDiffDiskOptimization]
   [-DelayStartSeconds <Int32>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPURelativeWeight <Int32>]
   [-HardwareProfile <HardwareProfile>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-CPUCyclesReservePercent <UInt16>]
   [-CPUCyclesLimitPercent <UInt16>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-SecureBootEnabled \<Boolean\>]
   [-SecureBootTemplate <String>]
   [-JobGroup <Guid>]
   [-SkipInstallVirtualizationGuestServices]
   [-ReturnImmediately]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualMachine
   -VM <VM>
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   -LibraryServer <LibraryServer>
   -SharePath <String>
   [-UseLocalVirtualHardDisk]
   [-UseDiffDiskOptimization]
   [-DelayStartSeconds <Int32>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPURelativeWeight <Int32>]
   [-HardwareProfile <HardwareProfile>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-CPUCyclesReservePercent <UInt16>]
   [-CPUCyclesLimitPercent <UInt16>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-SecureBootEnabled \<Boolean\>]
   [-SecureBootTemplate <String>]
   [-JobGroup <Guid>]
   [-SkipInstallVirtualizationGuestServices]
   [-ReturnImmediately]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualMachine
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   -VMConfigurationScaleOut <BaseVMConfiguration>
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-UseLocalVirtualHardDisk]
   [-UseDiffDiskOptimization]
   [-DelayStartSeconds <Int32>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPURelativeWeight <Int32>]
   [-HardwareProfile <HardwareProfile>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-CPUCyclesReservePercent <UInt16>]
   [-CPUCyclesLimitPercent <UInt16>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-SecureBootEnabled \<Boolean\>]
   [-SecureBootTemplate <String>]
   [-JobGroup <Guid>]
   [-SkipInstallVirtualizationGuestServices]
   [-ReturnImmediately]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualMachine
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   -ComputerTier <ComputerTier>
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-UseLocalVirtualHardDisk]
   [-UseDiffDiskOptimization]
   [-DelayStartSeconds <Int32>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPURelativeWeight <Int32>]
   [-HardwareProfile <HardwareProfile>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-CPUCyclesReservePercent <UInt16>]
   [-CPUCyclesLimitPercent <UInt16>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-SecureBootEnabled \<Boolean\>]
   [-SecureBootTemplate <String>]
   [-ComputerName <String>]
   [-JobGroup <Guid>]
   [-SkipInstallVirtualizationGuestServices]
   [-ReturnImmediately]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualMachine
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-Generation <Int32>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   -LibraryServer <LibraryServer>
   -SharePath <String>
   [-UseLocalVirtualHardDisk]
   [-UseDiffDiskOptimization]
   [-DelayStartSeconds <Int32>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPURelativeWeight <Int32>]
   [-HardwareProfile <HardwareProfile>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-CPUCyclesReservePercent <UInt16>]
   [-CPUCyclesLimitPercent <UInt16>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-SecureBootEnabled \<Boolean\>]
   [-SecureBootTemplate <String>]
   [-JobGroup <Guid>]
   [-SkipInstallVirtualizationGuestServices]
   [-ReturnImmediately]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

注意

VMM 2019 UR1 包含新的參數 [-EnableNestedVirtualization] <布爾值>。 如需詳細資訊，請參閱參數。

New-SCVirtualMachine Cmdlet 會建立 Virtual Machine Manager （VMM） 所管理的虛擬機。 您可以從下列來源建立虛擬機：

• 部署在主機上的已停止虛擬機。
• 儲存在 VMM 連結庫中的虛擬機。
• 虛擬機範本。
• 已包含作業系統的虛擬硬碟。 您可以從包含第三方操作系統的現有硬碟建立虛擬機，例如Linux。
• 空白虛擬硬碟。

System Center 2019 的新功能，您可以使用差異磁碟來建立虛擬機。 如需差異磁碟的詳細資訊，請參閱 New-SCVirtualDiskDrive。

當您將新的虛擬機部署到 Hyper-V 主機時，您可以指定虛擬機檔案的位置，或使用預設路徑：<C>：\ProgramData\Microsoft\Windows\Hyper-V。 當您在 VMware ESX 主機或 Citrix XenServer 主機上部署虛擬機時，沒有預設路徑。 指定路徑。

作為目前 Cmdlet 的替代方案，您可以使用下列 Cmdlet 來建立虛擬機：

• New-SCP2V。 此 Cmdlet 會從現有的實體電腦建立虛擬機。 這稱為 P2V 轉換。 如需詳細資訊，請輸入：Get-Help New-SCP2V。
• New-SCV2V 從現有的虛擬機建立虛擬機，例如在 VMWare 中建立的虛擬機。 這稱為 V2V 轉換。 如需詳細資訊，請輸入：Get-Help New-SCV2V。

範例

範例 1：從虛擬硬碟建立虛擬機，並將其部署在主機上

PS C:\> $VHD = Get-SCVirtualHardDisk -Name "Blank Disk - Large"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> New-SCVirtualMachine -Name "VM01" -VirtualHardDisk $VHD -VMHost $VMHost -Path "C:\VirtualMachinePath" -RunAsynchronously

第一個命令會從 VMM 連結庫取得名為 Blank Disk - Large 的虛擬硬碟物件，並將該物件儲存在$VHD 變數中。

第二個命令會取得名為 VMHost01 的主機物件，並將該物件儲存在$VMHost變數中。

最後一個命令會從儲存在 $VHD 中的虛擬硬碟建立名為 VM01 的虛擬機。 命令會在名為 VMHost01 的主機上，於 C：\VirtualMachinePath 中部署新的虛擬機。 命令會指定 RunAsynchronously 參數。 命令會在命令完成之前，立即將控件傳回殼層。

範例 2：從虛擬機範本建立虛擬機，並將其部署在主機上

PS C:\> $VMTemplate = Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "WindowsServer2008R2"}
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02.Contoso.com"
PS C:\> New-SCVirtualMachine -VMTemplate $VMTemplate -Name "VM02" -VMHost $VMHost -Path "C:\VirtualMachinePath" -RunAsynchronously -ComputerName "Server01" -FullName "Elisa Daugherty" -OrgName "Contoso" -ProductKey "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"

第一個命令會取得名為 WindowsServer2008R2 的虛擬機範本物件，並將該物件儲存在 $Template 變數中。

第二個命令會取得名為 VMHost02 的主機物件，並將該物件儲存在$VMHost變數中。

最後一個命令會從儲存在 $Template中的虛擬機範本建立虛擬機。 命令會將虛擬機命名為 VM02。 它會在主機 VMHost02 上部署虛擬機，並將虛擬機檔案儲存在 C：\VirtualMachinePath。 最後一個命令會自定義下列屬性：虛擬機的計算機名稱、虛擬機註冊者的名稱、組織名稱和產品密鑰。 命令會指定 RunAsynchronously 參數。 命令會在命令完成之前，立即將控件傳回殼層。

範例 3：藉由複製現有的虛擬機來建立虛擬機

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> if($VM.Status -eq "PowerOff"){New-SCVirtualMachine -Name "VM03" -VM $VM -VMHost $VMHost -Path "C:\VirtualMachinePath" -RunAsynchronously}

第一個命令會取得名為 VM03 的虛擬機物件，並將該物件儲存在 $VM 變數中。

第二個命令會取得名為 VMHost03 的主機物件，並將該物件儲存在$VMHost變數中。

最後一個命令會檢查虛擬機 VM01 是否處於電源關閉狀態。 如果虛擬機已關閉電源，命令會從 VM01 建立名為 VM03 的虛擬機，並在 C：\VirtualMachinePath 的 VMHost03 上部署新的虛擬機。

範例 4：從儲存在連結庫中的虛擬機建立虛擬機

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost04"
PS C:\> $VM = Get-SCVirtualMachine -Name "StoredVM01" | where {$_.LibraryServer.Name -eq "LibServer01.Contoso.com"} | where {$_.Location -eq "\\LibServer01.Consoso.com\MSSCVMMLibrary\StoredVM01"}
PS C:\> New-SCVirtualMachine -VM $VM -Name "VM04" -Description "New virtual machine from virtual machine stored in Library" -Owner "Contoso\ElisaDaugherty" -VMHost $VMHost -Path "C:\VirtualMachinePath" -RunAsynchronously -StartAction NeverAutoTurnOnVM -StopAction SaveVM -MemoryMB 1024

第一個命令會取得名為 VMHost04 的主機物件，並將該物件儲存在$VMHost變數中。

第二個命令會從連結庫伺服器 LibServer01 上的指定路徑取得名為 StoredVM01 的虛擬機物件，並將虛擬機物件儲存在 $VM 變數中。

最後一個命令會從 StoredVM01 建立名為 VM04 且記憶體為 1024 MB 的虛擬機。 命令會將它部署在指定的路徑。 此命令也會指定描述和擁有者，並指定虛擬機的啟動動作設定為永不自動開啟，而且停止動作是儲存虛擬機。

範例 5：建立高可用性虛擬機

PS C:\> $JobGuid = [System.Guid]::NewGuid().ToString()
PS C:\> $VMName = "HAVM01"
PS C:\> New-SCVirtualNetworkAdapter -JobGroup $JobGuid -PhysicalAddressType Dynamic -VLANEnabled $False
PS C:\> New-SCVirtualDVDDrive -JobGroup $JobGuid -Bus 1 -LUN 0
PS C:\> New-SCHardwareProfile -Owner "Contoso\ElisaDaugherty" -Name "HWProfile02" -CPUCount 1 -MemoryMB 512 -HighlyAvailable $True -NumLock $False -BootOrder "CD", "IdeHardDrive", "PxeBoot", "Floppy" -LimitCPUFunctionality $False -JobGroup $JobGuid
PS C:\> New-SCVirtualDiskDrive -IDE -Bus 0 -LUN 0 -JobGroup $JobGuid -Size 40960 -Dynamic -Filename "HAVM01_disk_1.vhd"
PS C:\> $VMHost = Get-SCVMHost | where {$_.Name -eq "VMMHANode02.Contoso.com"}
PS C:\> $HardwareProfile = Get-SCHardwareProfile | where {$_.Name -eq "HWProfile02"}
PS C:\> $OperatingSystem = Get-SCOperatingSystem | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Datacenter"}
PS C:\> New-SCVirtualMachine -Name $VMName -Description "" -VMMServer "VMMServer01.Contoso.com" -Owner "Contoso\ElisaDaugherty" -VMHost $VMHost -Path "R:\" -HardwareProfile $HardwareProfile -JobGroup $JobGuid -OperatingSystem $OperatingSystem -RunAsynchronously -StartAction NeverAutoTurnOnVM -StopAction SaveVM

第一個命令會建立 GUID 字串，並將它儲存在 $VMGuid 變數中。 此 GUID 是一個作業群組識別碼，可作為識別碼，可將包含此標識碼的後續命令分組到單一作業群組中。

第二個命令會將字串 HAVM01 儲存在 $VMName 變數中。 此字串是新虛擬機的名稱。

第三個命令會建立具有動態 MAC 位址且已停用 VLAN 的虛擬網路適配器。 因為 命令會指定 JobGroup 參數，因此在目前的 Cmdlet 執行之前，不會建立網路適配器。

第四個命令會建立連接到第二個通道和第一個插槽的 IDE 虛擬 DVD 磁碟驅動器。 因為命令會指定 JobGroup 參數，因此在目前的 Cmdlet 執行之前，不會建立虛擬 DVD 磁碟驅動器。

第五個命令會建立硬體配置檔，並指定配置檔名稱、擁有者、CPU 計數、記憶體和開機程式的值。 命令會停用 NumLock，同時也會限制 CPU 功能。 不需要有限的CPU，因為這是虛擬機不會執行較舊的作業系統。 此命令會將虛擬機指定為高可用性。 因為命令會指定 JobGroup 參數，因此在目前的 Cmdlet 執行之前，不會建立硬體配置檔。

第六個命令會在第一個通道和第一個插槽上建立儲存容量為 4 GB 的 IDE 虛擬磁碟驅動器。 因為命令指定 JobGroup 參數，因此在目前的 Cmdlet 執行之前，才會建立新的虛擬磁碟驅動器。

第七個命令會取得名為 VMMHANode02 的虛擬機主機物件，並將該物件儲存在$VMHost變數中。 此主機是 VMM 所管理主機叢集的一個節點。

第八個命令會取得名為 HWProfile02 的硬體配置檔物件，該物件是在第五個命令中建立的，並將該物件儲存在$HardwareProfile變數中。

第九個命令會依名稱取得操作系統物件，並將物件儲存在$OperatingSystem變數中。

最後一個命令會使用先前命令中建立和取得的物件，建立名為 HAVM01 的新高可用性虛擬機。 此命令也會指定 Path 參數，以指定要儲存虛擬機的位置。 此位置必須是叢集可移轉的 LUN。 此外，命令會指定當主機啟動時，虛擬機不會自動啟動，而且當虛擬化服務停止時，虛擬機會進入儲存狀態。

範例 6：在目的地主機上使用現有的 VHD 檔案，從範本建立新的虛擬機

PS C:\> $JobGroupID = [Guid]::NewGuid().ToString()
PS C:\> $VMTemplate = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost06.Contoso.com"
PS C:\> Move-SCVirtualHardDisk -IDE -BUS 0 -LUN 0 -Path "L:\OS.VHD" -JobGroup $JobGroupID
PS C:\> New-SCVirtualMachine -Name "VM06" -Path "L:\" -VMTemplate $VMTemplate -VMHost $VMHost -JobGroup $JobGroupID -UseLocalVirtualHardDisk

第一個命令會產生 GUID，並將它儲存在$JobGroupID變數中。

第二個命令會取得名為 VMTemplate01 的虛擬機範本物件，並將該物件儲存在$Template 變數中。 在此範例中，VMTemplate01 在 IDE 總線 0 LUN 0 上具有包含虛擬硬碟的虛擬磁碟驅動器。

第三個命令會取得名為 VMHost06 的主機物件，並將該物件儲存在$VMHost變數中。

第四個命令會將指定的虛擬硬碟連接到虛擬機上虛擬 IDE 控制器上主要通道 （0） 的第一個插槽 （0），而不是範本中的預設虛擬硬碟。 儲存在 L：\OS 的虛擬硬碟。VHD 包含虛擬機上執行的作業系統。 此外，此命令會使用 JobGroup 參數來指定在 New-SCVirtualMachine Cmdlet 會觸發 JobGroup 參數中的命令才能執行。

最後一個命令會觸發包含要執行之$JobGroupID變數的所有命令。 此命令會從儲存在 $VMTemplate 的範本建立名為 VM06 的新虛擬機。 命令會在 $VMHost的主機上部署虛擬機。 命令會將虛擬機儲存在 L： 磁碟驅動器的根目錄中。 UseLocalVirtualHardDisk 參數會指定命令在主機上使用現有的硬碟，而不是從連結庫複製 VHD。 因此，範本上與虛擬磁碟驅動器相關聯的虛擬硬碟會取代為主機上存在的虛擬硬碟 L：\OS。VHD。 因此，虛擬機及其操作系統都會儲存在主機上的 L： 磁碟驅動器上。

範例 7：使用目的地主機上的現有 VHD 從範本建立虛擬機，並將另一個 VHD 移至新的虛擬機

PS C:\> $JobGroupID = [guid]::NewGuid()
PS C:\> $VMTemplate = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost07.Contoso.com"
PS C:\> $VHD = Get-SCVirtualHardDisk -All | where {$_.Name -eq "Other.Vhd"}
PS C:\> Move-SCVirtualHardDisk -IDE -BUS 0 -LUN 0 -Path "L:\OS.VHD" -JobGroup $JobGroupID
PS C:\> New-SCVirtualDiskDrive -VirtualHardDisk $VHD -IDE -BUS 0 -LUN 1 -Path "R:\" -Filename "Other.Vhd" -JobGroup $JobGroupID
PS C:\> New-SCVirtualMachine -Name "VM07" -Path "D:\VirtualMachinePath" -VMTemplate $VMTemplate -VMHost $VMHost -JobGroup $JobGroupID -UseLocalVirtualHardDisk

前三個命令與上一個範例中的前三個命令相同。 在此範例中，VMTemplate01 在 IDE 總線 0 和 LUN 0 上有一個虛擬磁碟驅動器，其中包含虛擬硬碟。

第四個命令會取得名為 Other.VHD 的虛擬硬碟物件。 Get-SCVirtualHardDisk Cmdlet 可以從虛擬機、範本或儲存在 VMM 連結庫中的獨立檔案擷取虛擬硬碟物件。 指定 All 參數會擷取與父對象無關之所有從屬物件的完整清單。 在此情況下，命令會擷取所有可用的虛擬硬碟對象，然後選取 Other.VHD。

第五個命令會將指定的虛擬硬碟連接到虛擬機上虛擬 IDE 控制器上主要通道 （0） 的第一個插槽 （0），而不是範本中的預設虛擬硬碟。 儲存在 L：\OS 的虛擬硬碟。VHD 包含將在虛擬機上啟動的作業系統。 此外，此命令會指定 JobGroup 參數，以指定要執行，直到目前的 Cmdlet 觸發 JobGroup 列表中的命令才能執行。

第六個命令會建立虛擬磁碟驅動器物件，並將儲存在 $VHD 中的虛擬硬碟對象連結至新磁碟驅動器上的 IDE 總線 0 和 LUN 1。 命令會指定 Path 參數，將虛擬硬碟物件儲存在虛擬機上 R 磁碟驅動器的根目錄中$VHD，並指定其名稱為 Other.VHD。 此外，此命令會使用 JobGroup 參數來指定它不會執行，直到最後一個命令觸發 JobGroup 清單中的命令才能執行。

最後一個命令會觸發包含要執行之$JobGroupID變數的所有命令。 此命令會從儲存在 $VMTemplate 的範本建立名為 VM07 的虛擬機。 命令會在 $VMHost 中指定的主機上部署虛擬機。 命令會將虛擬機儲存在 D：\VirtualMachinePath 資料夾中。 UseLocalVirtualHarddisk 參數會指定 commmand 使用主機上的現有硬碟，而不是從連結庫複製 VHD。 因此，範本上與虛擬磁碟驅動器相關聯的虛擬硬碟會取代為主機上存在的虛擬硬碟 L：\OS。VHD。 因此，虛擬機的路徑為 D：\VirtualMachinePath\VM07，操作系統的路徑為 L：\OS。VHD，而其他虛擬硬碟的路徑是 R：\Other.VHD。

範例 8：從虛擬機範本建立以 Linux 為基礎的虛擬機，並將其部署在主機上

謹慎

本文參考 CentOS，這是已達到生命周期結束 （EOL） 狀態的 Linux 發行版。 請據以考慮您的使用和規劃。 如需詳細資訊，請參閱CentOS 生命週期結束指引。

PS C:\> $VMTemplate = Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | Where-Object {$_.Name -eq "CentOSConfigurable"}
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02.Contoso.com"
PS C:\> $Cred = Get-Credential
PS C:\> New-SCVirtualMachine -VMTemplate $VMTemplate -Name "MyCentOSVM" -RunAsynchronously -ComputerName "MyCentOSVM" -LinuxDomainName "Contoso.com" -LocalAdministratorCredential $Cred -VMHost $VMhost -Path "C:\VirtualMachinePath"

第一個命令會取得名為 CentOSConfigurable 的虛擬機範本物件，並將該物件儲存在$Template 變數中。

第二個命令會取得名為 VMHost02 的主機，並將該物件儲存在$VMHost變數中。

第三個命令會取得認證，並將該物件儲存在$Cred變數中。 此認證適用於根帳戶。

最後一個命令會從儲存在 $Template中的虛擬機範本建立虛擬機。 命令會將虛擬機命名為 MyCentOSVM。 它會在名為 VMHost02 的主機上部署虛擬機，並將其檔案儲存在 C：\VirtualMachinePath。 最後一個命令會自定義下列屬性：虛擬機的計算機名稱、Linux dnsdomainname 和根帳戶密碼。

參數

-AnswerFile

指定儲存在 VMM 連結庫中的腳本物件，以作為回應檔案使用。 回應檔案文稿的名稱取決於您要在虛擬機上安裝的作業系統：

• Sysprep.inf。 Windows XP、Windows Server 2000 或 Windows Server 2003
• Unattend.xml。 Windows Vista、Windows 7 或 Windows Server 2008

類型:	Script
別名:	SysPrepFile
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-AutomaticCriticalErrorAction

指定 VM 遇到嚴重錯誤時要採取的動作，並超過 AutomaticCriticalErrorActionTimeout 參數所指定的逾時持續時間。 此參數可接受的值為：Pause 和 None。

類型:	UInt16
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AutomaticCriticalErrorActionTimeout

指定在關閉虛擬機電源之前，在重大暫停中等候的時間量，以分鐘為單位。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-BlockDynamicOptimization

指出虛擬機是否封鎖動態優化。

類型:	Boolean
別名:	ExcludeFromPRO
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CapabilityProfile

指定功能設定檔物件。

類型:	CapabilityProfile
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CheckpointType

指定檢查點類型。 此參數可接受的值為：

• 禁用
• 生產
• ProductionOnly
• 標準

類型:	CheckpointType
接受的值:	Disabled, Production, ProductionOnly, Standard
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Cloud

指定私人雲端物件。

類型:	Cloud
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ComputerName

指定 VMM 可在網路上唯一識別的電腦名稱。 有效格式如下：

• FQDN （完整功能變數名稱）
• IPv4 或 IPv6 位址
• NetBIOS 名稱

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ComputerTier

指定計算機層物件。

類型:	ComputerTier
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-CPUCount

指定虛擬機上的CPU數目。 下列主機支援下列處理器數目：

• Hyper-V。 每個虛擬機最多四個CPU，視客體作業系統而定。
• VMware ESX。 針對任何支援的客體操作系統，每個虛擬機最多 4 個 CPU，但執行 Windows NT 4.0 的虛擬機上只有一個 CPU。
• Citrix XenServer。 每個虛擬機最多 8 個 CPU，視客體作業系統而定。

類型:	Byte
別名:	ProcessorCount
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CPUCyclesLimitPercent

將 CPU 週期的限制指定為百分比。

類型:	UInt16
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CPUCyclesReservePercent

將保留 CPU 週期指定為百分比。

類型:	UInt16
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CPULimitForMigration

指出是否要限制指定虛擬機的處理器功能，以便移轉至與來源計算機不同版本之實體計算機。 VMM 不支援在不同製造商擁有處理器的實體計算機之間移轉虛擬機。

類型:	Boolean
別名:	LimitCPUForMigration
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CPULimitFunctionality

指出是否要為虛擬機提供有限的CPU功能。 指定 $True 值，以支援部署在 Hyper-V 主機或 VMware ESX 主機上的虛擬機上，例如 Windows NT 4.0 等舊版操作系統。

類型:	Boolean
別名:	LimitCPUFunctionality
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CPUPerVirtualNumaNodeMaximum

指定每個虛擬 NUMA 節點允許的最大 CPU 數目。

類型:	Byte
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CPURelativeWeight

指定此虛擬機可相對於相同主機上其他虛擬機使用的主機上的 CPU 資源數量。 具有較高權數值的虛擬機會配置比加權值較低的虛擬機配置更多的 CPU 資源。 這些值的 VMware 詞彙是共用。 主機類型支援下列相對值：

• Hyper-V。 1 到 10000。
• VMware ESX。 高。 2000.
• VMware ESX。 高於標準。 1500.
• VMware ESX。 一般 （預設值）。 1000.
• VMware ESX。 在 [一般] 下方。 750.
• VMware ESX。 低。 500.
• VMware ESX。 自訂 1 到 1000000。
• Citrix XenServer。 1 到 65536，正常為 256。

類型:	Int32
別名:	RelativeWeight
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CPUType

指定虛擬機的CPU類型。 若要擷取 VMM 環境中虛擬機中可用之所有 CPU 類型的清單，請參閱 get-SCCPUType Cmdlet 。

類型:	ProcessorType
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DelayStartSeconds

指定虛擬化服務在自動啟動虛擬機之前等待的秒數。 此延遲會停滯多個虛擬機的啟動時間，以協助減少實體計算機資源的需求。 一般設定可能是 30 到 60 秒。 主機可設定的延遲上限如下：

• Hyper-V。 1000000000 秒 （277777 小時）
• VMware ESX。 65535 秒 （18 小時）

此參數不適用於 XenServer 虛擬機。

類型:	Int32
別名:	DelayStart
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Description

指定虛擬機的描述。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Domain

指定 Active Directory 網域的 FQDN。

類型:	String
別名:	JoinDomain
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DomainJoinCredential

指定有權將計算機加入網域之帳戶的使用者名稱和密碼。 建議您使用有限的許可權帳戶，將計算機加入網域。 這包括虛擬和實體計算機。

您可以使用目前的 參數，在 VMHostProfile 上指定認證，以便將實體主計算機加入網域，或在新的或現有的範本、新的或現有的客體操作系統配置檔或新的虛擬機上指定認證，以將虛擬機加入網域。

類型:	VMMCredential
別名:	JoinDomainCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DRProtectionRequired

此參數保留供日後使用。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DynamicMemoryBufferPercentage

指定主機應嘗試保留為緩衝區之虛擬機目前記憶體配置上方的記憶體百分比。 預設值為 20。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DynamicMemoryEnabled

指出是否要啟用虛擬機的易失記憶體。 您可以直接在虛擬機上，或在用來建立虛擬機的範本或硬體配置檔上啟用易失記憶體。 預設值為 $False。

只有當該虛擬機部署在執行 Windows Server 2008 SP1 或更新版本的主機上，或是虛擬機儲存在處於已停止狀態的連結庫中時，您才能啟用虛擬機的易失記憶體。 只有在虛擬機沒有快照集時，才能對預存虛擬機進行硬體變更。 在儲存在連結庫的虛擬機上啟用易失記憶體，會將該機器的位置限制為執行 Windows Server 2008 SP1 或更新版本的主機。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DynamicMemoryMaximumMB

指定如果已啟用易失記憶體，主機可以配置給虛擬機的記憶體數量上限。 預設值為 65536。

只有當該虛擬機部署在執行 Windows Server 2008 SP1 或更新版本的主機上，或是虛擬機儲存在處於已停止狀態的連結庫中時，您才能啟用虛擬機的易失記憶體。 只有在虛擬機沒有快照集時，才能對預存虛擬機進行硬體變更。 在儲存在連結庫的虛擬機上啟用易失記憶體，會將該機器的位置限制為執行 Windows Server 2008 SP1 或更新版本的主機。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DynamicMemoryMinimumMB

指定如果啟用易失記憶體，主機可以配置給虛擬機的最小記憶體數量。 預設值為 65536。

只有當該虛擬機部署在執行 Windows Server 2008 SP1 或更新版本的主機上，或是虛擬機儲存在處於已停止狀態的連結庫中時，您才能啟用虛擬機的易失記憶體。 只有在虛擬機沒有快照集時，才能對預存虛擬機進行硬體變更。 在儲存在連結庫的虛擬機上啟用易失記憶體，會將該機器的位置限制為執行 Windows Server 2008 SP1 或更新版本的主機。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableNestedVirtualization

啟用巢狀虛擬化。

注意

此參數適用於 VMM 2019 UR1。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-FullName

指定此 Cmdlet 註冊虛擬機名稱的人員名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Generation

指定產生新虛擬機的值。

類型:	Int32
Position:	Named
預設值:	1
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-GuestOSProfile

指定客體作業系統配置檔物件。

類型:	GuestOSProfile
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-GuiRunOnceCommands

指定要新增至自動響應檔案 [GuiRunOnce] 區段的命令陣列。 在每個以雙引號括住的字串周圍使用單引號。

範例格式：-GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

如需 Windows PowerShell 如何使用引號的資訊，請輸入 Get-Help about_Quoting_Rules。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-HardwareProfile

指定硬體配置檔物件。

類型:	HardwareProfile
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-HighlyAvailable

指出是否要將虛擬機放在屬於主機叢集的 Hyper-V 主機上。 在虛擬機或用來建立虛擬機的範本或硬體配置檔上設定此設定。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-JobGroup

指定一系列命令的標識碼，這些命令會在包含相同作業群組標識符執行的最後一個命令之前，以集合的形式執行。

類型:	Guid
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-JobVariable

指定作業進度的變數名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LibraryServer

指定 VMM 連結庫伺服器物件。

類型:	LibraryServer
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-LinuxAdministratorSSHKey

指定 Linux SSH 金鑰的公鑰檔案。

類型:	SSHKey
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LinuxAdministratorSSHKeyString

將 Linux 系統管理員 SSH 金鑰指定為字串。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LinuxDomainName

指定 Linux 作業系統特製化的 FQDN。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LocalAdministratorCredential

指定 Linux 相容客體作業系統設定檔之本機系統管理員帳戶或 Linux 根帳戶的使用者名稱和密碼。

此 Cmdlet 會在新的或現有的範本、新的或現有的客體作業系統配置檔或新的虛擬機上指定這些認證，以覆寫任何現有的系統管理員密碼。

類型:	VMMCredential
別名:	AdminPasswordCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MemoryMB

指定配置給虛擬機之主機上的隨機存取記憶體 （RAM）數量，以 MB 為單位。 預設值為 512 MB。 針對啟用易失記憶體的虛擬機，請指定啟動記憶體值。 可指派主機記憶體上限如下：

• Hyper-V。 每個虛擬機最多 65536 MB RAM
• VMware ESX Server 3.0.x 每個虛擬機最多 16384 MB RAM
• VMware ESX Server 3.5.x。 每個虛擬機最多 65532 MB RAM
• Citrix XenServer。 每個虛擬機最多 32265 MB RAM

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MemoryPerVirtualNumaNodeMaximumMB

指定主機允許每個虛擬 NUMA 節點的最大記憶體數量，以 MB 為單位。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MemoryWeight

指定將記憶體配置至虛擬機的優先順序，相對於相同主機上的其他虛擬機。 主機會將更多的記憶體配置給具有高於設定較低設定之虛擬機的虛擬機。 對於執行 Windows Server 2008 R2 SP1 或更新版本的主機，以下是預設值：

• 低。 0
• 正常。 5000
• 高。 10,000
• 習慣。 10,000

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MergeAnswerFile

指出這個 Cmdlet 是否將回應檔案與客體作業系統設定合併在一起。 預設值為 $True。 VMM 控制台會使用此參數。 請勿指定此參數。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MonitorMaximumCount

指定虛擬視訊配接器所支援的監視器數目上限。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MonitorMaximumResolution

指定值做為字串，表示虛擬視訊配接器的最大可能監視解析度。 有效值為：

• 1024x768
• 1280x1024
• 1600x1200
• 1920x1200

預設值為 1280x1024。

類型:	String
別名:	MonitorResolutionMaximum
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

指定新虛擬機的名稱。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-NumaIsolationRequired

指出是否需要 NUMA 隔離。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OnBehalfOfUser

指定用戶名稱。 這個 Cmdlet 代表此參數指定的用戶運作。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OnBehalfOfUserRole

指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 這個 Cmdlet 代表此參數指定的使用者角色運作。

類型:	UserRole
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OperatingSystem

指定虛擬機的作業系統類型。 若要列出 VMM 中所有可用作業系統的名稱，請使用 get-SCOperatingSystem Cmdlet 。

類型:	OperatingSystem
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OrganizationName

指定此 Cmdlet 註冊虛擬機名稱之人員的組織名稱。

類型:	String
別名:	OrgName
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Owner

將虛擬機的擁有者指定為有效的網域用戶帳戶。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Path

指定新虛擬機的目的地路徑。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ProductKey

指定產品金鑰。 產品金鑰是識別產品授權的 25 位數數位。 產品密鑰可用來註冊 VMM 或要安裝在虛擬機或主機上的作業系統。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ProtectionProvider

指定保護提供者。

類型:	ProtectionProvider
接受的值:	None, HVR8, HVRBlue, HVRAzure, DiskReplication, SANReplication
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PROTipID

指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。

類型:	Guid
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RecoveryPointObjective

指定因重大事件而無法容忍從IT服務遺失數據的最大期間。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ReplicationGroup

指定複寫群組。

類型:	ReplicationGroup
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ReturnImmediately

表示在建立作業之前，控件會立即傳回呼叫進程。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RunAsynchronously

表示作業會以異步方式執行，讓控件立即返回命令殼層。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SecureBootEnabled

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SecureBootTemplate

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SelfServiceRole

指定有權存取虛擬機的自助角色。

類型:	SelfServiceUserRole
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SharePath

在使用通用命名約定 （UNC） 路徑的現有連結庫伺服器上，指定有效連結庫共用的路徑。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SkipInstallVirtualizationGuestServices

指出此 Cmdlet 不會在虛擬機上安裝虛擬化客體服務。 默認值為 $False，VMM 會自動安裝適當的虛擬化客體服務。

對於 Hyper-V 主機上的虛擬機，虛擬化客體服務稱為整合元件或VMGuest.iso。 針對 XenServer 主機上的虛擬機，虛擬化客體服務稱為 Citrix Tools for Virtual Machines 或 xs-tools.iso。 VMware ESX 主機上的虛擬機不會使用虛擬化客體服務。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-StartAction

指定虛擬化服務啟動時虛擬機的行為。 有效值為：

• AlwaysAutoTurnOnVM
• NeverAutoTurnOnVM
• TurnOnVMIfRunningWhenVSStopped

類型:	VMStartAction
接受的值:	NeverAutoTurnOnVM, AlwaysAutoTurnOnVM, TurnOnVMIfRunningWhenVSStopped
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-StartVM

指出虛擬機在到達目的地主機時啟動。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-StopAction

指定虛擬化服務停止時虛擬機的行為。 有效值為：

• SaveVM
• TurnOffVM
• ShutdownGuestOS。

類型:	VMStopAction
接受的值:	SaveVM, TurnOffVM, ShutdownGuestOS
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-StoreToLibrary

指出此 Cmdlet 會將虛擬機儲存在 VMM 連結庫中。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TimeZone

指定數位，識別共用相同標準時間的地理區域。 如需時區索引的清單，請參閱Microsoft開發人員網路上的 Microsoft時區索引值（http://go.microsoft.com/fwlink/?LinkId=120935）。 如果您未指定時區，預設時區是虛擬機主機上的相同時區設定。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UseDiffDiskOptimization

指出此 Cmdlet 使用差異磁碟優化。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UseLocalVirtualHardDisk

指出此 Cmdlet 會確認此 Cmdlet 必須有此 Cmdlet 才能建立虛擬機的 VHD 檔案存在，並儲存在目的地主機上。

類型:	SwitchParameter
別名:	UseLocalVirtualHardDisks
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UserRole

指定使用者角色物件。

類型:	UserRole
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VirtualHardDisk

指定虛擬硬碟物件。

類型:	StandaloneVirtualHardDisk
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-VirtualNumaNodesPerSocketMaximum

指定每個套接字允許的 NUMA 節點數目上限。

類型:	Byte
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VirtualVideoAdapterEnabled

指出是否要為虛擬機啟用Microsoft綜合 3D 虛擬視訊配接器。 您可以直接在虛擬機或用來建立虛擬機的範本或硬體配置檔上啟用虛擬視訊配接器。

您只能在執行 Windows Server 2008 R2 SP1 或更新版本的主機上部署該虛擬機時，為虛擬機啟用 Microsoft綜合 3D 虛擬視訊配接器，或是已安裝遠端桌面服務角色和遠端桌面虛擬圖形角色服務的主機，或是虛擬機儲存在停止狀態。 只有在虛擬機沒有快照集時，才能對預存虛擬機進行硬體變更。 在儲存在連結庫的虛擬機上啟用Microsoft綜合 3D 虛擬視訊配接器，會將該機器的位置限製為執行 Windows Server 2008 R2 SP1 的主機，或已安裝遠端桌面服務角色和遠端桌面虛擬圖形角色服務的主機。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VM

指定虛擬機物件。

類型:	VM
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-VMConfiguration

指定虛擬機組態物件。

類型:	BaseVMConfiguration
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-VMConfigurationScaleOut

指定相應放大服務時所使用的虛擬機組態物件。

類型:	BaseVMConfiguration
別名:	ScaleOutVMConfiguration
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-VMHost

指定虛擬機主機物件。 VMM 支援 Hyper-V 主機、VMware ESX 主機和 Citrix XenServer 主機。 如需每種主機類型的詳細資訊，請參閱 Add-SCVMHost Cmdlet。

類型:	Host
別名:	Host
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-VMMServer

指定 VMM 伺服器物件。

類型:	ServerConnection
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-VMShieldingData

指定 VMShieldingData 物件。

類型:	KeyFile
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VMTemplate

指定此 Cmdlet 用來建立虛擬機的 VMM 樣本物件。

類型:	Template
別名:	Template
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Workgroup

指定要加入虛擬機的工作組名稱。 您可以使用此參數來覆寫範本或客體作業系統設定檔上的現有值。

類型:	String
別名:	JoinWorkgroup
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸出

VirtualMachine

此 Cmdlet 會傳回 VirtualMachine 物件。

備註

• 此 Cmdlet 需要 VMM 虛擬硬碟物件、虛擬機範本物件或虛擬機物件。 若要取得這類物件，請使用 Get-SCVirtualHardDisk、Get-SCVMTemplate或 Get-SCVirtualMachine Cmdlet。

相關連結

• Add-SCVMHost
• Get-SCOperatingSystem
• Get-SCCPUType
• Get-SCUserRole
• Get-SCVirtualHardDisk
• Get-SCVirtualMachine
• Get-SCVMTemplate
• Move-SCVirtualMachine
• New-SCV2V
• New-SCVirtualDiskDrive
• Read-SCVirtualMachine
• Remove-SCVirtualMachine
• Repair-SCVirtualMachine
• Resume-SCVirtualMachine
• Save-SCVirtualMachine
• Set-SCVirtualMachine
• Start-SCVirtualMachine
• Stop-SCVirtualMachine
• Suspend-SCVirtualMachine