New-AzureRmVmssConfig
VMSS 구성 개체를 만듭니다.
Warning
AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 AzureRM에서 Az PowerShell 모듈로 마이그레이션하는 것이 좋습니다.
AzureRM 모듈은 여전히 작동할 수 있지만 더 이상 유지 관리되거나 지원되지 않으므로 사용자의 재량에 따라 계속 사용할 수 있습니다. Az 모듈로 전환하는 방법에 대한 지침은 마이그레이션 리소스를 참조하세요.
구문
New-AzureRmVmssConfig
[[-Overprovision] <Boolean>]
[[-Location] <String>]
[[-Tag] <Hashtable>]
[[-SkuName] <String>]
[[-SkuTier] <String>]
[[-SkuCapacity] <Int32>]
[[-UpgradePolicyMode] <UpgradeMode>]
[[-OsProfile] <VirtualMachineScaleSetOSProfile>]
[[-StorageProfile] <VirtualMachineScaleSetStorageProfile>]
[[-NetworkInterfaceConfiguration] <VirtualMachineScaleSetNetworkConfiguration[]>]
[[-Extension] <VirtualMachineScaleSetExtension[]>]
[-SinglePlacementGroup <Boolean>]
[-ZoneBalance]
[-PlatformFaultDomainCount <Int32>]
[-Zone <String[]>]
[-PlanName <String>]
[-PlanPublisher <String>]
[-PlanProduct <String>]
[-PlanPromotionCode <String>]
[-RollingUpgradePolicy <RollingUpgradePolicy>]
[-AutoOSUpgrade]
[-DisableAutoRollback <Boolean>]
[-EnableUltraSSD]
[-HealthProbeId <String>]
[-BootDiagnostic <BootDiagnostics>]
[-LicenseType <String>]
[-Priority <String>]
[-EvictionPolicy <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmVmssConfig
[[-Overprovision] <Boolean>]
[[-Location] <String>]
[[-Tag] <Hashtable>]
[[-SkuName] <String>]
[[-SkuTier] <String>]
[[-SkuCapacity] <Int32>]
[[-UpgradePolicyMode] <UpgradeMode>]
[[-OsProfile] <VirtualMachineScaleSetOSProfile>]
[[-StorageProfile] <VirtualMachineScaleSetStorageProfile>]
[[-NetworkInterfaceConfiguration] <VirtualMachineScaleSetNetworkConfiguration[]>]
[[-Extension] <VirtualMachineScaleSetExtension[]>]
[-SinglePlacementGroup <Boolean>]
[-ZoneBalance]
[-PlatformFaultDomainCount <Int32>]
[-Zone <String[]>]
[-PlanName <String>]
[-PlanPublisher <String>]
[-PlanProduct <String>]
[-PlanPromotionCode <String>]
[-RollingUpgradePolicy <RollingUpgradePolicy>]
[-AutoOSUpgrade]
[-DisableAutoRollback <Boolean>]
[-EnableUltraSSD]
[-HealthProbeId <String>]
[-BootDiagnostic <BootDiagnostics>]
[-LicenseType <String>]
[-Priority <String>]
[-EvictionPolicy <String>]
-IdentityType <ResourceIdentityType>
[-IdentityId <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureRmVmssConfig
[[-Overprovision] <Boolean>]
[[-Location] <String>]
[[-Tag] <Hashtable>]
[[-SkuName] <String>]
[[-SkuTier] <String>]
[[-SkuCapacity] <Int32>]
[[-UpgradePolicyMode] <UpgradeMode>]
[[-OsProfile] <VirtualMachineScaleSetOSProfile>]
[[-StorageProfile] <VirtualMachineScaleSetStorageProfile>]
[[-NetworkInterfaceConfiguration] <VirtualMachineScaleSetNetworkConfiguration[]>]
[[-Extension] <VirtualMachineScaleSetExtension[]>]
[-SinglePlacementGroup <Boolean>]
[-ZoneBalance]
[-PlatformFaultDomainCount <Int32>]
[-Zone <String[]>]
[-PlanName <String>]
[-PlanPublisher <String>]
[-PlanProduct <String>]
[-PlanPromotionCode <String>]
[-RollingUpgradePolicy <RollingUpgradePolicy>]
[-AutoOSUpgrade]
[-DisableAutoRollback <Boolean>]
[-EnableUltraSSD]
[-HealthProbeId <String>]
[-BootDiagnostic <BootDiagnostics>]
[-LicenseType <String>]
[-Priority <String>]
[-EvictionPolicy <String>]
[-AssignIdentity]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
New-AzureRmVmssConfig cmdlet은 구성 가능한 로컬 VMSS(Virtual Manager Scale Set) 개체를 만듭니다. VMSS 개체를 구성하려면 다른 cmdlet이 필요합니다. 이러한 cmdlet은 다음과 같습니다.
- Set-AzureRmVmssOsProfile
- Set-AzureRmVmssStorageProfile
- Add-AzureRmVmssNetworkInterfaceConfiguration
- Add-AzureRmVmssExtension
예제
예제 1: VMSS 구성 개체 만들기
PS C:\> $VMSS = New-AzureRmVmssConfig -Location $Loc -SkuCapacity 2 -SkuName "Standard_A0" -UpgradePolicyMode "Automatic" -NetworkInterfaceConfiguration $NetCfg `
| Add-AzureRmVmssNetworkInterfaceConfiguration -Name "Test" -Primary $True -IPConfiguration $IPCfg `
| Set-AzureRmVmssOSProfile -ComputerNamePrefix "Test" -AdminUsername $adminUsername -AdminPassword $AdminPassword `
| Set-AzureRmVmssStorageProfile -Name "Test" -OsDiskCreateOption "FromImage" -OsDiskCaching "None" `
-ImageReferenceOffer $ImgRef.Offer -ImageReferenceSku $ImgRef.Skus -ImageReferenceVersion $ImgRef.Version `
-ImageReferencePublisher $ImgRef.PublisherName -VhdContainer $VHDContainer `
| Add-AzureRmVmssAdditionalUnattendContent -ComponentName $AUCComponentName -Content $AUCContent -PassName $AUCPassName -SettingName $AUCSetting `
| Remove-AzureRmVmssAdditionalUnattendContent -ComponentName $AUCComponentName;
New-AzureRmVmss -ResourceGroupName $RGName -Name $VMSSName -VirtualMachineScaleSet $VMSS;이 예제에서는 VMSS 구성 개체를 만듭니다. 첫 번째 명령은 New-AzureRmVmssConfig cmdlet을 사용하여 VMSS 구성 개체를 만들고 결과를 $VMSS 변수에 저장합니다. 두 번째 명령은 New-AzureRmVmss cmdlet을 사용하여 첫 번째 명령에서 만든 VMSS 구성 개체를 사용하는 VMSS를 만듭니다.
매개 변수
-AssignIdentity
가상 머신 확장 집합에 대한 시스템 할당 ID를 지정합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AutoOSUpgrade
최신 버전의 이미지를 사용할 수 있게 되면 OS 업그레이드를 확장 집합 인스턴스에 자동으로 적용할지 여부를 롤링 방식으로 설정합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-BootDiagnostic
가상 머신 확장 집합 부팅 진단 프로필을 지정합니다.
| 형식: | BootDiagnostics |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
| 형식: | IAzureContextContainer |
| 별칭: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisableAutoRollback
자동 OS 업그레이드 정책에 대한 자동 롤백 사용 안 함
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EnableUltraSSD
가상 머신 확장 집합에 UltraSSD_LRS 스토리지 계정 유형이 있는 하나 이상의 관리되는 데이터 디스크를 사용할 수 있습니다. 스토리지 계정 유형이 UltraSSD_LRS 관리 디스크는 이 속성을 사용하는 경우에만 VMSS에 추가할 수 있습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-EvictionPolicy
확장 집합의 가상 머신에 대한 제거 정책을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Extension
VMSS의 확장 정보 개체를 지정합니다. Add-AzureRmVmssExtension cmdlet을 사용하여 이 개체를 추가할 수 있습니다.
| 형식: | VirtualMachineScaleSetExtension[] |
| Position: | 10 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-HealthProbeId
가상 머신 확장 집합에서 인스턴스의 상태를 확인하는 데 사용되는 부하 분산 장치 프로브의 ID를 지정합니다. HealthProbeId는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}' 형식입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-IdentityId
가상 머신 확장 집합과 연결된 사용자 ID 목록을 지정합니다. 사용자 ID 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}' 형식의 ARM 리소스 ID입니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-IdentityType
가상 머신 확장 집합에 사용되는 ID 유형을 지정합니다. 'SystemAssignedUserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신 확장 집합에서 모든 ID를 제거합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- SystemAssigned
- UserAssigned
- SystemAssignedUserAssigned
- None
| 형식: | Nullable<T>[ResourceIdentityType] |
| 허용되는 값: | SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-LicenseType
고유한 라이선스 시나리오를 가져오는 라이선스 유형을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Location
VMSS가 만들어지는 Azure 위치를 지정합니다.
| 형식: | String |
| Position: | 1 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-NetworkInterfaceConfiguration
VMSS 구성에 대한 네트워킹 속성을 포함하는 네트워크 프로필 개체를 지정합니다. Add-AzureRmVmssNetworkInterfaceConfiguration cmdlet을 사용하여 이 개체를 추가할 수 있습니다.
| 형식: | VirtualMachineScaleSetNetworkConfiguration[] |
| Position: | 9 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-OsProfile
VMSS 구성에 대한 운영 체제 속성을 포함하는 운영 체제 프로필 개체를 지정합니다. Set-AzureRmVmssOsProfile cmdlet을 사용하여 이 개체를 설정할 수 있습니다.
| 형식: | VirtualMachineScaleSetOSProfile |
| Position: | 7 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Overprovision
cmdlet이 VMSS를 과도하게 프로비전하는지 여부를 나타냅니다.
| 형식: | Nullable<T>[Boolean] |
| Position: | 0 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PlanName
계획 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PlanProduct
계획 제품을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PlanPromotionCode
계획 승격 코드를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PlanPublisher
계획 게시자를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PlatformFaultDomainCount
각 배치 그룹의 장애 도메인 수입니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Priority
확장 집합의 가상 머신에 대한 우선 순위를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-RollingUpgradePolicy
롤링 업그레이드 정책을 지정합니다.
| 형식: | RollingUpgradePolicy |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-SinglePlacementGroup
단일 배치 그룹을 지정합니다.
| 형식: | Nullable<T>[Boolean] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-SkuCapacity
VMSS의 인스턴스 수를 지정합니다.
| 형식: | Int32 |
| Position: | 5 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-SkuName
VMSS의 모든 인스턴스 크기를 지정합니다.
| 형식: | String |
| 별칭: | AccountType |
| Position: | 3 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-SkuTier
VMSS 계층을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- Standard
- Basic
| 형식: | String |
| Position: | 4 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-StorageProfile
VMSS 구성에 대한 디스크 속성을 포함하는 스토리지 프로필 개체를 지정합니다. Set-AzureRmVmssStorageProfile cmdlet을 사용하여 이 개체를 설정할 수 있습니다.
| 형식: | VirtualMachineScaleSetStorageProfile |
| Position: | 8 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Tag
해시 테이블 형식의 키-값 쌍입니다. 예: @{key0="value0"; key1=$null; key2="value2"}
| 형식: | Hashtable |
| Position: | 2 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-UpgradePolicyMode
확장 집합에서 가상 머신으로 업그레이드하는 모드를 지정했습니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 자동
- 수동
| 형식: | Nullable<T>[UpgradeMode] |
| 허용되는 값: | Automatic, Manual, Rolling |
| Position: | 6 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Zone
가상 머신 확장 집합의 영역 목록을 지정합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ZoneBalance
영역 중단이 있는 경우 가상 머신 배포가 x 영역 간에 엄격하게 강제 적용할지 여부입니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.UpgradeMode, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
VirtualMachineScaleSetOSProfile
VirtualMachineScaleSetStorageProfile
VirtualMachineScaleSetNetworkConfiguration[]
VirtualMachineScaleSetExtension[]
String[]
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.ResourceIdentityType, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]