New-AzVmss
가상 머신 확장 집합을 만듭니다.
구문
New-AzVmss
[-ResourceGroupName] <String>
[-VMScaleSetName] <String>
[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
[-AsJob]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-EdgeZone <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzVmss
[[-ResourceGroupName] <String>]
[-VMScaleSetName] <String>
[-AsJob]
[-UserData <String>]
[-EnableAutomaticOSUpgrade]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-ImageName <String>]
-Credential <PSCredential>
[-InstanceCount <Int32>]
[-VirtualNetworkName <String>]
[-SubnetName <String>]
[-PublicIpAddressName <String>]
[-DomainNameLabel <String>]
[-SecurityGroupName <String>]
[-LoadBalancerName <String>]
[-BackendPort <Int32[]>]
[-Location <String>]
[-EdgeZone <String>]
[-VmSize <String>]
[-UpgradePolicyMode <UpgradeMode>]
[-AllocationMethod <String>]
[-VnetAddressPrefix <String>]
[-SubnetAddressPrefix <String>]
[-FrontendPoolName <String>]
[-BackendPoolName <String>]
[-SystemAssignedIdentity]
[-UserAssignedIdentity <String>]
[-EnableUltraSSD]
[-Zone <System.Collections.Generic.List`1[System.String]>]
[-NatBackendPort <Int32[]>]
[-DataDiskSizeInGb <Int32[]>]
[-ProximityPlacementGroupId <String>]
[-HostGroupId <String>]
[-Priority <String>]
[-EvictionPolicy <String>]
[-MaxPrice <Double>]
[-ScaleInPolicy <String[]>]
[-SkipExtensionsOnOverprovisionedVMs]
[-EncryptionAtHost]
[-PlatformFaultDomainCount <Int32>]
[-OrchestrationMode <String>]
[-CapacityReservationGroupId <String>]
[-ImageReferenceId <String>]
[-DiskControllerType <String>]
[-SharedGalleryImageId <String>]
[-SecurityType <String>]
[-EnableVtpm <Boolean>]
[-EnableSecureBoot <Boolean>]
[-SkuProfileVmSize <String[]>]
[-SkuProfileAllocationStrategy <String>]
[-DefaultProfile <IAzureContextContainer>]
[-SinglePlacementGroup]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
New-AzVmss cmdlet은 Azure에서 VMSS(Virtual Machine Scale Set)를 만듭니다.
간단한 매개 변수 집합(SimpleParameterSet)을 사용하여 미리 설정된 VMSS 및 관련 리소스를 빠르게 만듭니다.
만들기 전에 VMSS의 각 구성 요소와 연결된 각 리소스를 정확하게 구성해야 하는 경우 고급 시나리오에 기본 매개 변수 집합(DefaultParameter)을 사용합니다.
기본 매개 변수 집합의 경우 먼저 New-AzVmssConfig cmdlet을 사용하여 가상 머신 확장 집합 개체를 만듭니다.
그런 다음, 다음 cmdlet을 사용하여 가상 머신 확장 집합 개체의 다른 속성을 설정합니다.
- 네트워크 프로필을 설정하기 위한 Add-AzVmssNetworkInterfaceConfiguration 입니다.
- OS 프로필을 설정하기 위한 Set-AzVmssOsProfile 입니다.
- 스토리지 프로필을 설정하기 위한 Set-AzVmssStorageProfile 입니다.
- Get-AzComputeResourceSku 를 사용하여 구독 및 지역에 사용 가능한 가상 머신 크기를 확인할 수도 있습니다.
여기에서 가상 머신 확장 집합 에 대한 다른 cmdlet을 참조하세요.
VMSS 만들기는 기본적으로 OrchestrationMode:Flexible로 설정됩니다. 기본 매개 변수 집합은 기본적으로 VirtualMachineScaleSetVMProfile의 속성을 설정합니다. 빈 VirtualMachineScaleSetVMProfile 속성을 사용하여 VMSS를 만들려면 먼저 New-AzVmssConfig를 사용하여 빈 VirtualMachineScaleSetVMProfile 속성이 있는 VirtualMachineScaleSet 개체를 만들어서 간단한 매개 변수 집합을 사용합니다.
자습서는 [빠른 시작: Azure PowerShell을 사용하여 가상 머신 확장 집합 만들기](를 참조하세요.)https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/quick-create-powershell)
예제
예제 1: SimpleParameterSet을 사용하여 VMSS 만들기
$vmssName = 'VMSSNAME'
# Create credentials, I am using one way to create credentials, there are others as well.
# Pick one that makes the most sense according to your use case.
$vmPassword = ConvertTo-SecureString -String "****" -AsPlainText -Force
$vmCred = New-Object System.Management.Automation.PSCredential('USERNAME', $vmPassword)
$securityTypeStnd = "Standard"
#Create a VMSS using the default settings
New-AzVmss -Credential $vmCred -VMScaleSetName $vmssName -SecurityType $securityTypeStnd위의 명령은 이름을 $vmssName 사용하여 다음을 만듭니다.
- 리소스 그룹
- 가상 네트워크
- 부하 분산 장치
- 공용 IP
- 인스턴스가 2개인 VMSS
VMSS에서 VM에 대해 선택한 기본 이미지는 SKU입니다 2016-Datacenter Windows Server . Standard_DS1_v2
예제 2: DefaultParameterSet을 사용하여 VMSS 만들기
# Common
$LOC = "WestUs";
$RGName = "rgkyvms";
New-AzResourceGroup -Name $RGName -Location $LOC -Force;
# SRP
$STOName = "sto" + $RGName;
$STOType = "Standard_GRS";
New-AzStorageAccount -ResourceGroupName $RGName -Name $STOName -Location $LOC -Type $STOType;
$STOAccount = Get-AzStorageAccount -ResourceGroupName $RGName -Name $STOName;
# NRP
$SubNet = New-AzVirtualNetworkSubnetConfig -Name ("subnet" + $RGName) -AddressPrefix "10.0.0.0/24";
$VNet = New-AzVirtualNetwork -Force -Name ("vnet" + $RGName) -ResourceGroupName $RGName -Location $LOC -AddressPrefix "10.0.0.0/16" -DnsServer "10.1.1.1" -Subnet $SubNet;
$VNet = Get-AzVirtualNetwork -Name ('vnet' + $RGName) -ResourceGroupName $RGName;
$SubNetId = $VNet.Subnets[0].Id;
$PubIP = New-AzPublicIpAddress -Force -Name ("pubip" + $RGName) -ResourceGroupName $RGName -Location $LOC -AllocationMethod Dynamic -DomainNameLabel ("pubip" + $RGName);
$PubIP = Get-AzPublicIpAddress -Name ("pubip" + $RGName) -ResourceGroupName $RGName;
# Create LoadBalancer
$FrontendName = "fe" + $RGName
$BackendAddressPoolName = "bepool" + $RGName
$ProbeName = "vmssprobe" + $RGName
$InboundNatPoolName = "innatpool" + $RGName
$LBRuleName = "lbrule" + $RGName
$LBName = "vmsslb" + $RGName
$Frontend = New-AzLoadBalancerFrontendIpConfig -Name $FrontendName -PublicIpAddress $PubIP
$BackendAddressPool = New-AzLoadBalancerBackendAddressPoolConfig -Name $BackendAddressPoolName
$Probe = New-AzLoadBalancerProbeConfig -Name $ProbeName -RequestPath healthcheck.aspx -Protocol http -Port 80 -IntervalInSeconds 15 -ProbeCount 2
$InboundNatPool = New-AzLoadBalancerInboundNatPoolConfig -Name $InboundNatPoolName -FrontendIPConfigurationId `
$Frontend.Id -Protocol Tcp -FrontendPortRangeStart 3360 -FrontendPortRangeEnd 3367 -BackendPort 3370;
$LBRule = New-AzLoadBalancerRuleConfig -Name $LBRuleName `
-FrontendIPConfiguration $Frontend -BackendAddressPool $BackendAddressPool `
-Probe $Probe -Protocol Tcp -FrontendPort 80 -BackendPort 80 `
-IdleTimeoutInMinutes 15 -EnableFloatingIP -LoadDistribution SourceIP;
$ActualLb = New-AzLoadBalancer -Name $LBName -ResourceGroupName $RGName -Location $LOC `
-FrontendIpConfiguration $Frontend -BackendAddressPool $BackendAddressPool `
-Probe $Probe -LoadBalancingRule $LBRule -InboundNatPool $InboundNatPool;
$ExpectedLb = Get-AzLoadBalancer -Name $LBName -ResourceGroupName $RGName
# New VMSS Parameters
$VMSSName = "vmss" + $RGName;
$AdminUsername = "Admin01";
$AdminPassword = "p4ssw0rd@123" + $RGName;
$PublisherName = "MicrosoftWindowsServer"
$Offer = "WindowsServer"
$Sku = "2012-R2-Datacenter"
$Version = "latest"
$VHDContainer = "https://" + $STOName + ".blob.core.windows.net/" + $VMSSName;
$ExtName = "CSETest";
$Publisher = "Microsoft.Compute";
$ExtType = "BGInfo";
$ExtVer = "2.1";
#IP Config for the NIC
$IPCfg = New-AzVmssIpConfig -Name "Test" `
-LoadBalancerInboundNatPoolsId $ExpectedLb.InboundNatPools[0].Id `
-LoadBalancerBackendAddressPoolsId $ExpectedLb.BackendAddressPools[0].Id `
-SubnetId $SubNetId;
#VMSS Config
$securityTypeStnd = "Standard";
$VMSS = New-AzVmssConfig -Location $LOC -SkuCapacity 2 -SkuName "Standard_E4-2ds_v4" -UpgradePolicyMode "Automatic" -SecurityType $securityTypeStnd `
| Add-AzVmssNetworkInterfaceConfiguration -Name "Test" -Primary $True -IPConfiguration $IPCfg `
| Add-AzVmssNetworkInterfaceConfiguration -Name "Test2" -IPConfiguration $IPCfg `
| Set-AzVmssOsProfile -ComputerNamePrefix "Test" -AdminUsername $AdminUsername -AdminPassword $AdminPassword `
| Set-AzVmssStorageProfile -Name "Test" -OsDiskCreateOption 'FromImage' -OsDiskCaching "None" `
-ImageReferenceOffer $Offer -ImageReferenceSku $Sku -ImageReferenceVersion $Version `
-ImageReferencePublisher $PublisherName -VhdContainer $VHDContainer `
| Add-AzVmssExtension -Name $ExtName -Publisher $Publisher -Type $ExtType -TypeHandlerVersion $ExtVer -AutoUpgradeMinorVersion $True
#Create the VMSS
New-AzVmss -ResourceGroupName $RGName -Name $VMSSName -VirtualMachineScaleSet $VMSS;위의 복잡한 예제에서는 VMSS를 만듭니다. 다음은 무슨 일이 일어나고 있는지에 대한 설명입니다.
- 첫 번째 명령은 지정된 이름과 위치를 사용하여 리소스 그룹을 만듭니다.
- 두 번째 명령은 New-AzStorageAccount cmdlet을 사용하여 스토리지 계정을 만듭니다.
- 그런 다음 세 번째 명령은 Get-AzStorageAccount cmdlet을 사용하여 두 번째 명령에서 만든 스토리지 계정을 가져와 결과를 $STOAccount 변수에 저장합니다.
- 다섯 번째 명령은 New-AzVirtualNetworkSubnetConfig cmdlet을 사용하여 서브넷을 만들고 결과를 $SubNet 변수에 저장합니다.
- 여섯 번째 명령은 New-AzVirtualNetwork cmdlet을 사용하여 가상 네트워크를 만들고 결과를 $VNet 변수에 저장합니다.
- 일곱 번째 명령은 Get-AzVirtualNetwork를 사용하여 여섯 번째 명령에서 만든 가상 네트워크에 대한 정보를 가져와서 $VNet 변수에 저장합니다.
- 여덟 번째 및 아홉 번째 명령은 New-AzPublicIpAddress 및 Get- AzureRmPublicIpAddress를 사용하여 해당 공용 IP 주소에서 정보를 만들고 가져옵니다.
- 명령은 $PubIP 변수에 정보를 저장합니다.
- 10번째 명령은 New- AzureRmLoadBalancerFrontendIpConfig cmdlet을 사용하여 프런트 엔드 부하 분산 장치를 만들고 결과를 $Frontend 변수에 저장합니다.
- 11번째 명령은 New-AzLoadBalancerBackendAddressPoolConfig를 사용하여 백 엔드 주소 풀 구성을 만들고 결과를 $BackendAddressPool 변수에 저장합니다.
- 12번째 명령은 New-AzLoadBalancerProbeConfig를 사용하여 프로브를 만들고 프로브 정보를 $Probe 변수에 저장합니다.
- 13번째 명령은 New-AzLoadBalancerInboundNatPoolConfig cmdlet을 사용하여 부하 분산 장치 NAT(인바운드 네트워크 주소 변환) 풀 구성을 만듭니다.
- 14번째 명령은 New-AzLoadBalancerRuleConfig를 사용하여 부하 분산 장치 규칙 구성을 만들고 결과를 $LBRule 변수에 저장합니다.
- 15번째 명령은 New-AzLoadBalancer cmdlet을 사용하여 부하 분산 장치를 만들고 결과를 $ActualLb 변수에 저장합니다.
- 16번째 명령은 Get-AzLoadBalancer를 사용하여 15번째 명령에서 만든 부하 분산 장치에 대한 정보를 가져와서 $ExpectedLb 변수에 저장합니다.
- 17번째 명령은 New-AzVmssIpConfig cmdlet을 사용하여 VMSS IP 구성을 만들고 $IPCfg 변수에 정보를 저장합니다.
- 18번째 명령은 New-AzVmssConfig cmdlet을 사용하여 VMSS 구성 개체를 만들고 결과를 $VMSS 변수에 저장합니다.
- 19번째 명령은 New-AzVmss cmdlet을 사용하여 VMSS를 만듭니다.
예제 3: UserData 값을 사용하여 VMSS 만들기
$ResourceGroupName = 'RESOURCE GROUP NAME';
$vmssName = 'VMSSNAME';
$domainNameLabel = "dnl" + $ResourceGroupName;
# Create credentials, I am using one way to create credentials, there are others as well.
# Pick one that makes the most sense according to your use case.
$vmPassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$vmCred = New-Object System.Management.Automation.PSCredential('USERNAME', $vmPassword);
$text = "UserData value to encode";
$bytes = [System.Text.Encoding]::Unicode.GetBytes($text);
$userData = [Convert]::ToBase64String($bytes);
$securityTypeStnd = "Standard";
#Create a VMSS
New-AzVmss -ResourceGroupName $ResourceGroupName -Name $vmssName -Credential $vmCred -DomainNameLabel $domainNameLabel -Userdata $userData -SecurityType $securityTypeStnd;
$vmss = Get-AzVmss -ResourceGroupName $ResourceGroupName -VMScaleSetName $vmssName -InstanceView:$false -Userdata;UserData 값을 사용하여 VMSS 만들기
예제 4: 보안 유형 TrustedLaunch를 사용하여 Vmss 만들기
$rgname = "rgname";
$loc = "eastus";
# VMSS Profile & Hardware requirements for the TrustedLaunch default behavior.
$vmssSize = 'Standard_D4s_v3';
$vmssName1 = 'vmss1' + $rgname;
$imageName = "Win2022AzureEdition";
$adminUsername = "<Username>";
$adminPassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$vmCred = New-Object System.Management.Automation.PSCredential ($adminUsername, $adminPassword);
# VMSS Creation
$result = New-AzVmss -Credential $vmCred -VMScaleSetName $vmssName1 -ImageName $imageName -SecurityType "TrustedLaunch";
# Validate that for -SecurityType "TrustedLaunch", "-Vtpm" and -"SecureBoot" are "Enabled/true"
# $result.VirtualMachineProfile.SecurityProfile.UefiSettings.VTpmEnabled;
# $result.VirtualMachineProfile.SecurityProfile.UefiSettings.SecureBootEnabled;이 예제에서는 새 보안 유형 'TrustedLaunch'와 필요한 UEFISettings 값을 사용하여 새 VMSS를 만듭니다. VTpmEnabled 및 SecureBootEnalbed는 true입니다. 자세한 내용은 신뢰할 수 있는 시작 기능 페이지를 확인하세요.
예제 5: 오케스트레이션 모드에서 Vm 만들기: 기본적으로 유연
# Create configration object
$vmssConfig = New-AzVmssConfig -Location EastUs2 -UpgradePolicyMode Manual -SinglePlacementGroup $true
# VMSS Creation
New-AzVmss -ResourceGroupName TestRg -VMScaleSetName myVMSS -VirtualMachineScaleSet $vmssConfig다음은 새 VMSS를 만들고 OrchestrationMode Flexible로 기본값을 지정하는 예제입니다.
예제 6: TrustedLaunch가 기본적으로 켜져 있는 새 VMSS를 만듭니다.
$rgname = "<Resource Group>";
$loc = "<Azure Region>";
New-AzResourceGroup -Name $rgname -Location $loc -Force;
$vmssName = 'vmss' + $rgname;
$vmssSize = 'Standard_D4s_v3';
$imageName = "Win2022AzureEdition";
$publisherName = "MicrosoftWindowsServer";
$offer = "WindowsServer";
$sku = "2022-Datacenter-Azure-Edition";
$adminUsername = "<Username>";
$password = "<Password>";
# NRP
$vnetworkName = 'vnet' + $rgname;
$subnetName = 'subnet' + $rgname;
$subnet = New-AzVirtualNetworkSubnetConfig -Name $subnetName -AddressPrefix "10.0.0.0/24";
$vnet = New-AzVirtualNetwork -Name $vnetworkName -ResourceGroupName $rgname -Location $loc -AddressPrefix "10.0.0.0/16" -Subnet $subnet;
$vnet = Get-AzVirtualNetwork -Name $vnetworkName -ResourceGroupName $rgname;
$subnetId = $vnet.Subnets[0].Id;
$ipCfg = New-AzVmssIpConfig -Name 'test' -SubnetId $subnetId;
$vmss = New-AzVmssConfig -Location $loc -SkuCapacity 2 -SkuName $vmssSize -UpgradePolicyMode 'Manual' `
| Add-AzVmssNetworkInterfaceConfiguration -Name 'test' -Primary $true -IPConfiguration $ipCfg `
| Set-AzVmssOsProfile -ComputerNamePrefix 'test' -AdminUsername $adminUsername -AdminPassword $password;
# Create TL Vmss
$result = New-AzVmss -ResourceGroupName $rgname -VMScaleSetName $vmssName -VirtualMachineScaleSet $vmss;
$vmssGet = Get-AzVmss -ResourceGroupName $rgname -VMScaleSetName $vmssName;
# Verify $vmssGet.VirtualMachineProfile.SecurityProfile.SecurityType is TrustedLaunch.
# Verify $vmssGet.VirtualMachineProfile.SecurityProfile.UefiSettings.VTpmEnabled is True.
# Verify $vmssGet.VirtualMachineProfile.SecurityProfile.UefiSettings.SecureBootEnabled is True.
# Verify $vmssGet.VirtualMachineProfile.StorageProfile.ImageReference.Sku is 2022-Datacenter-Azure-Edition.위의 가상 머신 확장 집합은 기본적으로 신뢰할 수 있는 시작을 사용하도록 설정되어 있습니다. 자세한 내용은 신뢰할 수 있는 시작 기능 페이지를 확인하세요.
매개 변수
-AllocationMethod
확장 집합의 공용 IP 주소(정적 또는 동적)에 대한 할당 방법입니다. 값이 제공되지 않으면 할당이 정적입니다.
| 형식: | String |
| 허용되는 값: | Static, Dynamic |
| Position: | Named |
| Default value: | Static |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AsJob
백그라운드에서 cmdlet을 실행하고 작업을 반환하여 진행률을 추적합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-BackendPoolName
이 확장 집합의 부하 분산 장치에서 사용할 백 엔드 주소 풀의 이름입니다. 값이 제공되지 않으면 확장 집합과 동일한 이름으로 새 백 엔드 풀이 만들어집니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-BackendPort
확장 집합 부하 분산 장치에서 확장 집합의 VM과 통신하는 데 사용하는 백 엔드 포트 번호입니다. 값을 지정하지 않으면 포트 3389 및 5985가 Windows VMS에 사용되고 포트 22는 Linux VM에 사용됩니다.
| 형식: | Int32[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CapacityReservationGroupId
할당하는 데 사용되는 용량 예약 그룹의 ID입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Credential
이 확장 집합의 VM에 대한 관리자 자격 증명(사용자 이름 및 암호)입니다.
사용자 이름
제한:
Windows: 특수 문자를 포함할 수 없음 /""[]:|<>+=;,?*@> 또는 ""로 끝납니다.
Linux: 사용자 이름은 문자, 숫자, 하이픈 및 밑줄만 포함해야 하며 하이픈 또는 숫자로 시작할 수 없습니다.
허용되지 않는 값: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5".
최소 길이: 1자
최대 길이: Windows의 경우 20자, Linux의 경우 64자
암호
소문자 1개, 대문자 1개, 숫자 1개, 특수 문자 1개 중 3개여야 합니다.
값은 12자에서 123자 사이여야 합니다.
| 형식: | PSCredential |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DataDiskSizeInGb
데이터 디스크의 크기를 GB 단위로 지정합니다.
| 형식: | Int32[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
| 형식: | IAzureContextContainer |
| 별칭: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DiskControllerType
VM 및 VirtualMachineScaleSet에 대해 구성된 디스크 컨트롤러 유형을 지정합니다. 이 속성은 운영 체제 디스크 및 VM sku가 2세대(https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2)를 지원하는 가상 머신에 대해서만 지원됩니다. 지역에 대한 Microsoft.Compute SKU API의 응답에서 VM sku 기능의 일부로 반환된 HyperVGenerations 기능에 V2(https://learn.microsoft.com/rest/api/compute/resourceskus/list)가 포함되어 있는지 확인하세요.
지원되는 디스크 컨트롤러 유형에 대한 자세한 내용은 을 참조 https://aka.ms/azure-diskcontrollertypes하세요.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DomainNameLabel
이 확장 집합의 공용 FQDN(정규화된 도메인 이름)에 대한 도메인 이름 레이블입니다. 확장 집합에 자동으로 할당되는 도메인 이름의 첫 번째 구성 요소입니다. 자동으로 할당된 도메인 이름은 양식(<DomainNameLabel>.<Location>.cloudapp.azure.com)을 사용합니다. 값이 제공되지 않으면 기본 도메인 이름 레이블은 <ScaleSetName> 연결 및 <ResourceGroupName>.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EdgeZone
에지 영역 이름을 설정합니다. 설정된 경우 쿼리는 주 지역 대신 지정된 에지존으로 라우팅됩니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-EnableAutomaticOSUpgrade
최신 버전의 이미지를 사용할 수 있게 되면 OS 업그레이드를 확장 집합 인스턴스에 롤링 방식으로 자동으로 적용해야 하는지 여부입니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EnableSecureBoot
가상 머신에서 보안 부팅을 사용하도록 설정할지 여부를 지정합니다.
| 형식: | Nullable<T>[Boolean] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-EnableUltraSSD
확장 집합의 VM에 UltraSSD 디스크를 사용합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EnableVtpm
가상 머신에서 vTPM을 사용하도록 설정할지 여부를 지정합니다.
| 형식: | Nullable<T>[Boolean] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-EncryptionAtHost
이 매개 변수는 호스트 자체의 리소스/임시 디스크를 비롯한 모든 디스크에 대한 암호화를 사용하도록 설정합니다. 기본값: 리소스에 대해 이 속성을 true로 설정하지 않으면 호스트의 암호화가 비활성화됩니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EvictionPolicy
우선 순위가 낮은 가상 머신 확장 집합에 대한 제거 정책입니다. 지원되는 값만 '할당 취소' 및 '삭제'입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-FrontendPoolName
확장 집합 부하 분산 장치에서 사용할 프런트 엔드 주소 풀의 이름입니다. 값이 제공되지 않으면 확장 집합과 동일한 이름으로 새 프런트 엔드 주소 풀이 만들어집니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-HostGroupId
가상 머신 확장 집합이 상주할 전용 호스트 그룹을 지정합니다.
| 형식: | String |
| 별칭: | HostGroup |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-IfMatch
PUT 및 기타 안전하지 않은 메서드에 대한 조건부 요청을 만드는 데 사용됩니다. 서버는 리소스가 나열된 ETag 값 중 하나와 일치하는 경우에만 요청된 리소스를 반환합니다. 현재 리소스를 항상 덮어쓰려면 이 값을 생략합니다. 실수로 동시 변경 내용을 덮어쓰지 않도록 마지막으로 본 ETag 값을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IfNoneMatch
GET 및 HEAD 메서드에 대한 조건부 요청을 만드는 데 사용됩니다. 나열된 ETag 값이 현재 엔터티와 일치하지 않는 경우에만 서버에서 요청된 리소스를 반환합니다. GET 및 HEAD 메서드에 대한 조건부 요청을 만드는 데 사용됩니다. 나열된 ETag 값이 현재 엔터티와 일치하지 않는 경우에만 서버에서 요청된 리소스를 반환합니다. 새 레코드 집합을 만들 수 있지만 기존 레코드 집합을 업데이트하지 않도록 하려면 '*'로 설정합니다. 다른 값은 지원되지 않으므로 서버에서 오류가 발생합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ImageName
이 확장 집합에 있는 VM에 대한 이미지의 별칭입니다. 값이 제공되지 않으면 "Windows Server 2016 DataCenter" 이미지가 사용됩니다. 사용 가능한 별칭은 Win2022AzureEdition, Win2022AzureEditionCore, Win2019Datacenter, Win2016Datacenter, Win2012R2Datacenter, Win2012Datacenter, UbuntuLTS, Ubuntu204, CentOS85Gen2, Debian11, OpenSuseLeap154Gen2, RHELRaw8LVMGen2, SuseSles15SP3, FlatcarLinuxFreeGen2.
| 형식: | String |
| 별칭: | Image |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ImageReferenceId
vmss 배포에 대한 공유 갤러리 이미지 고유 ID를 지정했습니다. 공유 갤러리 이미지 GET 호출에서 가져올 수 있습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InstanceCount
확장 집합의 VM 이미지 수입니다. 값이 제공되지 않으면 2개의 인스턴스가 만들어집니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | 2 |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-LoadBalancerName
이 확장 집합에 사용할 부하 분산 장치의 이름입니다. 값이 지정되지 않은 경우 확장 집합과 동일한 이름을 사용하는 새 부하 분산 장치가 만들어집니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Location
이 확장 집합을 만들 Azure 위치입니다. 값이 지정되지 않은 경우 위치는 매개 변수에서 참조되는 다른 리소스의 위치에서 유추됩니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MaxPrice
우선 순위가 낮은 가상 머신 확장 집합의 최대 청구 가격입니다.
| 형식: | Double |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-NatBackendPort
인바운드 네트워크 주소 변환을 위한 백 엔드 포트입니다.
| 형식: | Int32[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-OrchestrationMode
가상 머신 확장 집합의 오케스트레이션 모드를 지정합니다. 가능한 값: Uniform, Flexible
OrchestrationMode:Flexible에서 기본 매개 변수 집합을 사용하여 VMSS를 만들면 VirtualMachineScaleSetVMProfile이 기본적으로 채워집니다. 빈 VirtualMachineScaleSetVMProfile을 사용하여 VMSS를 만들려면 먼저 New-AzVmssConfig를 사용하여 빈 VMProfile 속성이 있는 VirtualMachineScaleSet 개체를 만든 다음 간단한 매개 변수 집합을 사용하여 VMSS를 만듭니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PlatformFaultDomainCount
각 배치 그룹의 장애 도메인 수입니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Priority
확장 집합의 가상 머신에 대한 우선 순위입니다. 지원되는 값만 'Regular', 'Spot' 및 'Low'입니다. '일반'은 일반 가상 머신용입니다. 'Spot'은 스폿 가상 머신을 위한 것입니다. 'Low'는 스폿 가상 머신용이지만 '스폿'으로 대체됩니다. '낮음' 대신 'Spot'을 사용하세요.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ProximityPlacementGroupId
이 확장 집합에 사용할 근접 배치 그룹의 리소스 ID입니다.
| 형식: | String |
| 별칭: | ProximityPlacementGroup |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PublicIpAddressName
이 확장 집합에 사용할 공용 IP 주소의 이름입니다. 값이 제공되지 않으면 확장 집합과 이름이 같은 새 공용 IPAddress가 만들어집니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ResourceGroupName
VMSS의 리소스 그룹 이름을 지정합니다. 값을 지정하지 않으면 확장 집합과 동일한 이름을 사용하여 새 ResourceGroup이 만들어집니다.
| 형식: | String |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ScaleInPolicy
가상 머신 확장 집합을 스케일 인할 때 따라야 할 규칙입니다. 가능한 값은 'Default', 'OldestVM' 및 'NewestVM'입니다. 가상 머신 확장 집합이 확장되면 '기본값'은 영역 확장 집합인 경우 먼저 영역 간에 분산됩니다. 그런 다음 가능한 한 장애 도메인 간에 균형이 조정됩니다. 각 장애 도메인 내에서 제거를 위해 선택한 가상 머신은 규모 감축으로부터 보호되지 않는 최신 컴퓨터가 됩니다. 가상 머신 확장 집합이 확장될 때 'OldestVM'은 확장으로부터 보호되지 않는 가장 오래된 가상 머신을 제거하도록 선택됩니다. 영역 가상 머신 확장 집합의 경우 확장 집합은 먼저 영역 간에 균형을 이루게 됩니다. 각 영역 내에서 보호되지 않는 가장 오래된 가상 머신이 제거되도록 선택됩니다. 'NewestVM'은 가상 머신 확장 집합을 스케일 인할 때 확장으로부터 보호되지 않는 최신 가상 머신을 제거하도록 선택됩니다. 영역 가상 머신 확장 집합의 경우 확장 집합은 먼저 영역 간에 균형을 이루게 됩니다. 각 영역 내에서 보호되지 않는 최신 가상 머신이 제거를 위해 선택됩니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SecurityGroupName
이 확장 집합에 적용할 네트워크 보안 그룹의 이름입니다. 값이 제공되지 않으면 확장 집합과 이름이 같은 기본 네트워크 보안 그룹이 만들어지고 확장 집합에 적용됩니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SecurityType
가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다. 이 속성을 설정하지 않으면 UefiSettings를 사용할 수 없습니다.
| 형식: | String |
| 허용되는 값: | TrustedLaunch, ConfidentialVM, Standard |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-SharedGalleryImageId
vm 배포에 대한 공유 갤러리 이미지 고유 ID를 지정했습니다. 공유 갤러리 이미지 GET 호출에서 가져올 수 있습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SinglePlacementGroup
단일 배치 그룹에서 확장 집합을 만들려면 이 값을 사용합니다. 기본값은 여러 그룹입니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SkipExtensionsOnOverprovisionedVMs
확장이 과도하게 프로비전된 추가 VM에서 실행되지 않도록 지정합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SkuProfileAllocationStrategy
SKU 프로필에 대한 할당 전략입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-SkuProfileVmSize
확장 집합에 대한 VM 크기의 배열입니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-SubnetAddressPrefix
ScaleSet에서 사용할 서브넷의 주소 접두사입니다. 값이 제공되지 않으면 기본 서브넷 설정(192.168.1.0/24)이 적용됩니다.
| 형식: | String |
| Position: | Named |
| Default value: | 192.168.1.0/24 |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SubnetName
이 확장 집합에 사용할 서브넷의 이름입니다. 값이 제공되지 않으면 확장 집합과 동일한 이름으로 새 서브넷이 만들어집니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SystemAssignedIdentity
매개 변수가 있는 경우 확장 집합의 VM에 자동 생성되는 관리되는 시스템 ID가 할당됩니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UpgradePolicyMode
이 확장 집합의 VM 인스턴스에 대한 업그레이드 정책 모드입니다. 업그레이드 정책은 자동, 수동 또는 롤링 업그레이드를 지정할 수 있습니다.
| 형식: | UpgradeMode |
| 허용되는 값: | Automatic, Manual, Rolling |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UserAssignedIdentity
확장 집합의 VM에 할당해야 하는 관리 서비스 ID의 이름입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UserData
Base-64로 인코딩되는 VM에 대한 UserData입니다. 고객은 여기에 비밀을 전달해서는 안됩니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-VirtualMachineScaleSet
이 cmdlet에서 만드는 VMSS의 속성을 포함하는 VirtualMachineScaleSet 개체를 지정합니다.
| 형식: | PSVirtualMachineScaleSet |
| Position: | 2 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-VirtualNetworkName
이 확장 집합에 사용할 Virtual Network의 이름입니다. 값이 제공되지 않으면 확장 집합과 이름이 같은 새 가상 네트워크가 만들어집니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-VMScaleSetName
이 cmdlet에서 만드는 VMSS의 이름을 지정합니다.
| 형식: | String |
| 별칭: | Name |
| Position: | 1 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-VmSize
이 확장 집합의 VM 인스턴스 크기입니다. Get-AzComputeResourceSku 를 사용하여 구독 및 지역에 사용 가능한 크기를 확인할 수 있습니다. 크기가 지정되지 않은 경우 기본 크기(Standard_DS1_v2)가 사용됩니다.
| 형식: | String |
| Position: | Named |
| Default value: | Standard_DS1_v2 |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-VnetAddressPrefix
이 확장 집합에 사용되는 가상 네트워크의 주소 접두사입니다. 값이 제공되지 않으면 기본 가상 네트워크 주소 접두사 설정(192.168.0.0/16)이 사용됩니다.
| 형식: | String |
| Position: | Named |
| Default value: | 192.168.0.0/16 |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Zone
리소스에 할당된 IP를 나타내는 가용성 영역의 목록입니다.
| 형식: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
입력
List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
출력
관련 링크
Azure PowerShell