Set-VMHost
Set-VMHost
Configures a Hyper-V host.
구문
Parameter Set: Default
Set-VMHost [[-ComputerName] <String[]> ] [-EnableEnhancedSessionMode <Boolean> ] [-FibreChannelWwnn <String> ] [-FibreChannelWwpnMaximum <String> ] [-FibreChannelWwpnMinimum <String> ] [-MacAddressMaximum <String> ] [-MacAddressMinimum <String> ] [-MaximumStorageMigrations <UInt32> ] [-MaximumVirtualMachineMigrations <UInt32> ] [-NumaSpanningEnabled <Boolean> ] [-Passthru] [-ResourceMeteringSaveInterval <TimeSpan> ] [-UseAnyNetworkForMigration <Boolean> ] [-VirtualHardDiskPath <String> ] [-VirtualMachineMigrationAuthenticationType <MigrationAuthenticationType> ] [-VirtualMachineMigrationPerformanceOption <VMMigrationPerformance> ] [-VirtualMachinePath <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
자세한 설명
The Set-VMHost cmdlet configures a Hyper-V host.
매개 변수
-ComputerName<String[]>
Specifies one or more Hyper-V hosts to be configured. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer — use “localhost” or a dot (“.”) to specify the local computer explicitly.
별칭 |
없음 |
필수 여부 |
false |
위치 |
1 |
기본값 |
. |
파이프라인 입력 적용 여부 |
True (ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-EnableEnhancedSessionMode<Boolean>
Indicates whether users can use enhanced mode when they connect to virtual machines on this server by using Virtual Machine Connection.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-MacAddressMaximum<String>
Specifies the maximum MAC address using a valid hexadecimal value. Use with MacAddressMinimum to establish a range of MAC addresses that the specified Hyper-V host can assign to virtual machines configured to receive dynamic MAC addresses.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-MacAddressMinimum<String>
Specifies the minimum MAC address using a valid hexadecimal value. Use with MacAddressMaximum to establish a range of MAC addresses that the specified Hyper-V host can assign to virtual machines configured to receive dynamic MAC addresses.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-Passthru
Specifies that a Microsoft.HyperV.PowerShell.Host is to be passed through to the pipeline representing the Hyper-V host to be configured.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-UseAnyNetworkForMigration<Boolean>
Specifies how networks are selected for incoming live migration traffic. If set to $TRUE, any available network on the host can be used for this traffic. If set to $FALSE, incoming live migration traffic is transmitted only on the networks specified in the MigrationNetworks property of the host. The Get-VMMigrationNetwork returns the list of networks that can be used for migration traffic.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-VirtualHardDiskPath<String>
Specifies the default folder to store virtual hard disks on the Hyper-V host.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-VirtualMachinePath<String>
Specifies the default folder to store virtual machine configuration files on the Hyper-V host.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-FibreChannelWwnn<String>
Specifies the default value of the World Wide Node Name on the Hyper-V host.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-FibreChannelWwpnMaximum<String>
Specifies the maximum value that can be used to generate World Wide Port Names on the Hyper-V host. Use with FibreChannelWwpnMinimum to establish a range of WWPNs that the specified Hyper-V host can assign to virtual Fibre Channel adapters.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-FibreChannelWwpnMinimum<String>
Specifies the minimum value that can be used to generate the World Wide Port Names on the Hyper-V host. Use with FibreChannelWwpnMaximum to establish a range of WWPNs that the specified Hyper-V host can assign to virtual Fibre Channel adapters.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-MaximumStorageMigrations<UInt32>
Specifies the maximum number of storage migrations that can be performed at the same time on the Hyper-V host.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-MaximumVirtualMachineMigrations<UInt32>
Specifies the maximum number of live migrations that can be performed at the same time on the Hyper-V host.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-NumaSpanningEnabled<Boolean>
Specifies whether virtual machines on the Hyper-V host can use resources from more than one NUMA node.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-ResourceMeteringSaveInterval<TimeSpan>
Specifies how often the Hyper-V host saves the data that tracks resource usage. The range is a minimum of 1 hour to a maximum of 24 hours. Time within that range can be specified using a format of hh:mm:ss, where hh indicates hours, mm indicates minutes, and ss indicates seconds. You also can use a Timespan object to specify the interval.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-VirtualMachineMigrationAuthenticationType<MigrationAuthenticationType>
Specifies the type of authentication to be used for live migrations. Allowed values are Kerberos or CredSSP.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-VirtualMachineMigrationPerformanceOption<VMMigrationPerformance>
Specifies the performance option to use for live migration. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- Compression. Compress data to speed up live migration on constrained networks.
-- SMBTransport. Use server message block (SMB) to get the highest throughput possible.
-- None. Perform standard live migration.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
필수 여부 |
false |
위치 |
named |
기본값 |
false |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
false |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
<CommonParameters>
이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).
입력
입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.
출력
출력 유형은 cmdlet이 내보내는 개체의 유형입니다.
- None by default; Microsoft.HyperV.PowerShell.Host if –PassThru is specified.
예제
Example 1
This example configures the local Hyper-V host to allow 10 simultaneous live migrations and storage migrations.
PS C:\> Set-VMHost -MaximumVirtualMachineMigrations 10 –MaximumStorageMigrations 10
Example 2
This example configures a range of MAC addresses range for the local Hyper-V host.
PS C:\> Set-VMHost -MacAddressMinimum 00155D020600 -MacAddressMaximum 00155D0206FF
Example 3
This example enables the use of any network for incoming live migrations on the local Hyper-V host.
PS C:\> Set-VMHost –UseAnyNetworkForMigration $true
Example 4
This example specifies new default locations for virtual hard disksand virtual machines on the local Hyper-V host.
PS C:\> Set-VMHost –VirtualHardDiskPath "C:\Hyper-V\Virtual Hard Disks" –VirtualMachinePath "C:\Hyper-V\Configuration Files"
Example 5
This example configures Fibre Channel host settings on the local Hyper-V host.
PS C:\> Set-VMHost -FibreChannelWwnn C003FF0000FFFF00 -FibreChannelWwpnMinimum C003FF661D200000 -FibreChannelWwpnMaximum C003FF661D200000
Example 6
This example disables NUMA spanning on the local Hyper-V host.
PS C:\> Set-VMHost –NumaSpanningEnabled $false
Example 7
This example configures the local Hyper-V host to save data that tracks resource consumption every hour and a half.
PS C:\> Set-VMHost -ResourceMeteringSaveInterval 01:30:00
Example 8
The example configures the local Hyper-V host to use Kerberos to authenticate incoming live migrations.
PS C:\> Set-VMHost –VirtualMachineMigrationAuthenticationType Kerberos