@@ -69,7 +69,7 @@ The PowerShell module performs the following functions:
69
69
Install the module from [ PowerShell Gallery] ( https://www.powershellgallery.com/packages/AzureBasicLoadBalancerUpgrade )
70
70
71
71
``` powershell
72
- PS C:\> Install-Module -Name AzureBasicLoadBalancerUpgrade -Scope CurrentUser -Repository PSGallery -Force
72
+ Install-Module -Name AzureBasicLoadBalancerUpgrade -Scope CurrentUser -Repository PSGallery -Force
73
73
```
74
74
75
75
## Pre- and Post-migration Steps
@@ -95,7 +95,7 @@ PS C:\> Install-Module -Name AzureBasicLoadBalancerUpgrade -Scope CurrentUser -R
95
95
1 . Ensure you have selected the Basic Load Balancer's subscription ID by running ` Select-AzSubscription ` .
96
96
97
97
``` powershell
98
- PS C:\> Select-AzAccount -Subscription <SubscriptionId>
98
+ Select-AzSubscription -Subscription <SubscriptionId>
99
99
```
100
100
101
101
2. Find the Load Balancer you wish to upgrade. Record its name and resource group name.
@@ -116,39 +116,39 @@ PS C:\> Install-Module -Name AzureBasicLoadBalancerUpgrade -Scope CurrentUser -R
116
116
Validate that a Basic Load Balancer is supported for upgrade
117
117
118
118
```powershell
119
- PS C:\> Start-AzBasicLoadBalancerUpgrade -ResourceGroupName <loadBalancerRGName> -BasicLoadBalancerName <basicLBName> -validateScenarioOnly
119
+ Start-AzBasicLoadBalancerUpgrade -ResourceGroupName <loadBalancerRGName> -BasicLoadBalancerName <basicLBName> -validateScenarioOnly
120
120
```
121
121
122
122
### Example: upgrade by name
123
123
124
124
Upgrade a Basic Load Balancer to a Standard Load Balancer with the same name, providing the Basic Load Balancer name and resource group name
125
125
126
126
``` powershell
127
- PS C:\> Start-AzBasicLoadBalancerUpgrade -ResourceGroupName <loadBalancerRGName> -BasicLoadBalancerName <basicLBName>
127
+ Start-AzBasicLoadBalancerUpgrade -ResourceGroupName <loadBalancerRGName> -BasicLoadBalancerName <basicLBName>
128
128
```
129
129
130
130
### Example: upgrade, change name, and show logs
131
131
132
132
Upgrade a Basic Load Balancer to a Standard Load Balancer with the specified name, displaying logged output on screen
133
133
134
134
``` powershell
135
- PS C:\> Start-AzBasicLoadBalancerUpgrade -ResourceGroupName <loadBalancerRGName> -BasicLoadBalancerName <basicLBName> -StandardLoadBalancerName <newStandardLBName> -FollowLog
135
+ Start-AzBasicLoadBalancerUpgrade -ResourceGroupName <loadBalancerRGName> -BasicLoadBalancerName <basicLBName> -StandardLoadBalancerName <newStandardLBName> -FollowLog
136
136
```
137
137
138
138
### Example: upgrade with alternate backup path
139
139
140
140
Upgrade a Basic Load Balancer to a Standard Load Balancer with the specified name and store the Basic Load Balancer backup file at the specified path
141
141
142
142
``` powershell
143
- PS C:\> Start-AzBasicLoadBalancerUpgrade -ResourceGroupName <loadBalancerRGName> -BasicLoadBalancerName <basicLBName> -StandardLoadBalancerName <newStandardLBName> -RecoveryBackupPath C:\BasicLBRecovery
143
+ Start-AzBasicLoadBalancerUpgrade -ResourceGroupName <loadBalancerRGName> -BasicLoadBalancerName <basicLBName> -StandardLoadBalancerName <newStandardLBName> -RecoveryBackupPath C:\BasicLBRecovery
144
144
```
145
145
146
146
### Example: validate completed migration
147
147
148
148
Validate a completed migration by passing the Basic Load Balancer state file backup and the Standard Load Balancer name
149
149
150
150
``` powershell
151
- PS C:\> Start-AzBasicLoadBalancerUpgrade -validateCompletedMigration -StandardLoadBalancerName <newStandardLBName> -basicLoadBalancerStatePath C:\RecoveryBackups\State_mybasiclb_rg-basiclbrg_20220912T1740032148.json
151
+ Start-AzBasicLoadBalancerUpgrade -validateCompletedMigration -StandardLoadBalancerName <newStandardLBName> -basicLoadBalancerStatePath C:\RecoveryBackups\State_mybasiclb_rg-basiclbrg_20220912T1740032148.json
152
152
```
153
153
154
154
### Example: migrate multiple, related Load Balancers
@@ -157,7 +157,7 @@ Migrate multiple Load Balancers with shared backend members at the same time, us
157
157
158
158
``` powershell
159
159
# build array of multiple basic load balancers
160
- PS C:\> $multiLBConfig = @(
160
+ $multiLBConfig = @(
161
161
@{
162
162
'standardLoadBalancerName' = 'myStandardInternalLB01' # specifying the standard load balancer name is optional
163
163
'basicLoadBalancer' = (Get-AzLoadBalancer -ResourceGroupName myRG -Name myBasicInternalLB01)
@@ -168,23 +168,23 @@ PS C:\> $multiLBConfig = @(
168
168
}
169
169
)
170
170
# pass the array of load balancer configurations to the -MultiLBConfig parameter
171
- PS C:\> Start-AzBasicLoadBalancerUpgrade -MultiLBConfig $multiLBConfig
171
+ Start-AzBasicLoadBalancerUpgrade -MultiLBConfig $multiLBConfig
172
172
```
173
173
174
174
### Example: retry failed virtual machine scale set migration
175
175
176
176
Retry a failed upgrade for a virtual machine scale set's load balancer (due to error or script termination) by providing the Basic Load Balancer and Virtual Machine Scale Set backup state file
177
177
178
178
``` powershell
179
- PS C:\> Start-AzBasicLoadBalancerUpgrade -FailedMigrationRetryFilePathLB C:\RecoveryBackups\State_mybasiclb_rg-basiclbrg_20220912T1740032148.json -FailedMigrationRetryFilePathVMSS C:\RecoveryBackups\VMSS_myVMSS_rg-basiclbrg_20220912T1740032148.json
179
+ Start-AzBasicLoadBalancerUpgrade -FailedMigrationRetryFilePathLB C:\RecoveryBackups\State_mybasiclb_rg-basiclbrg_20220912T1740032148.json -FailedMigrationRetryFilePathVMSS C:\RecoveryBackups\VMSS_myVMSS_rg-basiclbrg_20220912T1740032148.json
180
180
```
181
181
182
182
### Example: retry failed virtual machine migration
183
183
184
184
Retry a failed upgrade for a VM load balancer (due to error or script termination) by providing the Basic Load Balancer backup state file
185
185
186
186
``` powershell
187
- PS C:\> Start-AzBasicLoadBalancerUpgrade -FailedMigrationRetryFilePathLB C:\RecoveryBackups\State_mybasiclb_rg-basiclbrg_20220912T1740032148.json
187
+ Start-AzBasicLoadBalancerUpgrade -FailedMigrationRetryFilePathLB C:\RecoveryBackups\State_mybasiclb_rg-basiclbrg_20220912T1740032148.json
188
188
```
189
189
190
190
## Common Questions
0 commit comments