Skip to content

Enhance Get-AzMigrateServerMigrationStatus cmdlet to support -Expedit… #28529

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed

Enhance Get-AzMigrateServerMigrationStatus cmdlet to support -Expedit… #28529

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
478 changes: 369 additions & 109 deletions src/Migrate/Migrate.Autorest/custom/Get-AzMigrateServerMigrationStatus.ps1
View file
Open in desktop

Large diffs are not rendered by default.

132 changes: 105 additions & 27 deletions src/Migrate/Migrate.Autorest/docs/Get-AzMigrateServerMigrationStatus.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,12 @@ Get-AzMigrateServerMigrationStatus -MachineName <String> -ProjectName <String> -
[-SubscriptionId <String>] [-DefaultProfile <PSObject>] [<CommonParameters>]
```

### GetByPrioritiseServer
```
Get-AzMigrateServerMigrationStatus -Expedite -MachineName <String> -ProjectName <String>
-ResourceGroupName <String> [-SubscriptionId <String>] [-DefaultProfile <PSObject>] [<CommonParameters>]
```

### GetHealthByMachineName
```
Get-AzMigrateServerMigrationStatus -Health -MachineName <String> -ProjectName <String>
Expand All @@ -44,14 +50,16 @@ The Get-AzMigrateServerMigrationStatus cmdlet retrieves the replication status f

### Example 1: List status by project name.
```powershell
Get-AzMigrateServerMigrationStatus -ResourceGroupName cbtpvtrg -ProjectName migpvt
Get-AzMigrateServerMigrationStatus -ProjectName "cbt-resync-gql" -ResourceGroupName "ankitbaluni-resync-rg"
```

```output
Appliance Server State Progress TimeElapsed TimeRemaining UploadSpeed Health LastSync Datastore
--------- ------ ----- -------- ----------- ------------- ----------- ------ -------- ---------
migpvt CVM-Win2019 DeltaReplication Completed - - - - Normal 12/7/2023, 11:18:07 AM Shared_1TB, datastore1
migpvt CVM-Win2022 DeltaReplication Completed - - - - Normal 12/7/2023, 10:41:42 AM datastore1

Appliance Server State Progress TimeElapsed TimeRemaining UploadSpeed Health LastSync Datastore ESXiHost
--------- ------ ----- -------- ----------- ------------- ----------- ------ -------- --------- --------
nosbm-test-ds el41-r5w12r1-3 InitialReplication InProgress 48 % 3 hr 48 min 12 hr 37 min 1230 Mbps Normal - IDCLAB-T100_10TB idclab-vcen65.corp.microsoft.com_10.150.84.28
nosbm-test-ds el41-r5w2k8r2-1 DeltaReplication Completed - - - - Normal 9/4/2025, 3:04:45 PM IDCLAB-T100_10TB idclab-vcen65.corp.microsoft.com_10.150.84.28
nosbm-test-ds dsinha-cbt-test DeltaReplication Completed - - - - Normal 9/4/2025, 2:58:21 PM IDCLAB-T100_10TB idclab-vcen65.corp.microsoft.com_10.150.84.28



Expand All @@ -64,44 +72,102 @@ Get by project name.

### Example 2: List status by machine name.
```powershell
Get-AzMigrateServerMigrationStatus -ProjectName "migpvt-ecyproj" -ResourceGroupName "cbtprivatestamprg" -MachineName "CVM-Win2019"
Get-AzMigrateServerMigrationStatus -ProjectName "cbt-resync-gql" -ResourceGroupName "ankitbaluni-resync-rg" -MachineName "Rhel8-Vm"
```

```output
Server CVM-Win2019 is currently healthy.
Server Rhel8-Vm is currently healthy.

Appliance Server State Progress TimeElapsed TimeRemaining UploadSpeed LastSync ESXiHost Datastore
--------- ------ ----- -------- ----------- ------------- ----------- -------- -------- ---------
cbtresyncgql Rhel8-Vm DeltaReplication Completed - - - - 7/14/2025, 9:51:05 PM idclab-vcen8.fareast.corp.microsoft.com_10.150.102.181 IDCLAB-B161-3TB

Appliance Server State Progress TimeElapsed TimeRemaining UploadSpeed LastSync Datastore
--------- ------ ----- -------- ----------- ------------- ----------- -------- ---------
migpvt CVM-Win2019 DeltaReplication Completed - - - - 12/7/2023, 11:18:07 AM Shared_1TB, datastore1


Disk Level Operation Status:

Disk State Progress TimeElapsed TimeRemaining UploadSpeed Datastore
---- ----- -------- ----------- ------------- ----------- ---------
TestVM DeltaReplication Completed - - - - Shared_1TB
CVM-Win2019 DeltaReplication Completed - - - - datastore1
Disk State Progress TimeElapsed TimeRemaining UploadSpeed Datastore
---- ----- -------- ----------- ------------- ----------- ---------
Rhel8-Vm DeltaReplication Completed - - - - IDCLAB-B161-3TB
```

Get by machine name.

### Example 2: List status by appliance name.
### Example 3: List status by appliance name.
```powershell
Get-AzMigrateServerMigrationStatus -ProjectName "migpvt-ecyproj" -ResourceGroupName "cbtprivatestamprg" -ApplianceName "migpvt"
Get-AzMigrateServerMigrationStatus -ProjectName "cbt-resync-gql" -ResourceGroupName "ankitbaluni-resync-rg" -ApplianceName "cbtresyncgql"
```

```output
Server State Progress TimeElapsed TimeRemaining UploadSpeed Health LastSync Datastore
------ ----- -------- ----------- ------------- ----------- ------ -------- ---------
CVM-Win2019 DeltaReplication Completed - - - - Normal 12/7/2023, 11:18:07 AM Shared_1TB, datastore1
CVM-Win2022 DeltaReplication Completed - - - - Normal 12/7/2023, 10:41:42 AM datastore1
Server State Progress TimeElapsed TimeRemaining UploadSpeed Health LastSync Datastore ESXiHost
------ ----- -------- ----------- ------------- ----------- ------ -------- --------- --------
el41-r5w12r1-3 InitialReplication InProgress 48 % 3 hr 48 min 12 hr 37 min 1230 Mbps Normal - IDCLAB-T100_10TB idclab-vcen65.corp.microsoft.com_10.150.84.28
el41-r5w2k8r2-1 DeltaReplication Completed - - - - Normal 9/4/2025, 3:04:45 PM IDCLAB-T100_10TB idclab-vcen65.corp.microsoft.com_10.150.84.28
dsinha-cbt-test DeltaReplication Completed - - - - Normal 9/4/2025, 2:58:21 PM IDCLAB-T100_10TB idclab-vcen65.corp.microsoft.com_10.150.84.28


To check expedite the operation of a server use the command
Get-AzMigrateServerMigrationStatus -ProjectName <String> -ResourceGroupName <String> -MachineName <String> -Expedite

To resolve the health issue use the command
Get-AzMigrateServerMigrationStatus -ProjectName <String> -ResourceGroupName <String> -MachineName <String> -Health
```

Get by appliance name.

### Example 4: Expedite replication for a server.
```powershell
Get-AzMigrateServerMigrationStatus -ProjectName "cbt-resync-gql" -ResourceGroupName "ankitbaluni-resync-rg" -MachineName "Rhel8-Vm" -Expedite
```

```output
Server Information:

Appliance Server State Progress TimeElapsed TimeRemaining UploadSpeed LastSync ESXiHost Datastore
--------- ------ ----- -------- ----------- ------------- ----------- -------- -------- ---------
cbtresyncgql Rhel8-Vm DeltaReplication Completed - - - - 7/14/2025, 9:51:05 PM idclab-vcen8.fareast.corp.microsoft.com_10.150.102.181 IDCLAB-B161-3TB



Disk Level Operation Status:

Disk State Progress TimeElapsed TimeRemaining UploadSpeed Datastore
---- ----- -------- ----------- ------------- ----------- ---------
Rhel8-Vm DeltaReplication Completed - - - - IDCLAB-B161-3TB


Resource Sharing:

The following VMs share at least one resource (Appliance, ESXi Host, or Datastore) with VM 'Rhel8-Vm'. The 'SharedResourceType' and 'SharedResourceName' columns indicate which resource is shared.

Appliance Server SharedResourceType State TimeRemaining ESXiHost Datastore
--------- ------ ------------------ ----- ------------- -------- ---------
cbtresyncgql wave-selfhost-vm8 Appliance DeltaReplication Completed - idclab-vcen8.fareast.corp.microsoft.com_10.150.102.191 Shared_1TB
cbtresyncgql el41-r5w12r2-1 Appliance DeltaReplication Completed - idclab-vcen65.corp.microsoft.com_10.150.84.28 IDCLAB-T100_10TB
cbtresyncgql el41-r5w2k8r2-1 Appliance DeltaReplication Completed - idclab-vcen65.corp.microsoft.com_10.150.84.28 IDCLAB-T100_10TB
cbtresyncgql el41-r5w12r1-2 Appliance DeltaReplication Completed - idclab-vcen65.corp.microsoft.com_10.150.84.28 IDCLAB-T100_10TB
cbtresyncgql ubuntu22-liverserver-bios-nolvm Appliance, ESXiHost, Datastore DeltaReplication Completed - idclab-vcen8.fareast.corp.microsoft.com_10.150.102.181 IDCLAB-B161-3TB


Resource utilization information for migration operations:

Resource Capacity Utilization for server migrations Total utilization Status
-------- -------- --------------------------------- ----------------- ------
Appliance RAM Sum : Primary and scale out appliances 32768 MB 1808 MB 7014 MB Underutilized
Appliance CPU Sum : Primary and scale out appliances 4 Cores - 99% At capacity
Network bandwidth Sum : Primary and scale out appliances 1192 MBps - - Underutilized
ESXi host NFC buffer 32 MB 8 MB - Underutilized
Parallel Disks Replicated Sum : Primary and scale out appliances 58 3 - Underutilized
Datastore 'IDCLAB-B161-3TB' Snapshot Count 15 2 - Underutilized


Based on the resource utilization seen above, here are suggestions to expedite server Rhel8-Vm migration:

1. CPU is At capacity. Pause or stop other migrations under this appliance, or increase CPU resources if possible.
```

Expedite replication for a specific server.

## PARAMETERS

### -ApplianceName
Expand Down Expand Up @@ -134,6 +200,21 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -Expedite
Specifies whether to expedite the operation of a replicating server.

```yaml
Type: System.Management.Automation.SwitchParameter
Parameter Sets: GetByPrioritiseServer
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Filter
OData filter options.

Expand Down Expand Up @@ -165,12 +246,11 @@ Accept wildcard characters: False
```

### -MachineName
[Parameter(ParameterSetName = 'GetByPrioritiseServer', Mandatory)]
Specifies the display name of the replicating machine.
Specifies the display name of the replicating machine.

```yaml
Type: System.String
Parameter Sets: GetByMachineName, GetHealthByMachineName
Parameter Sets: GetByMachineName, GetByPrioritiseServer, GetHealthByMachineName
Aliases:

Required: True
Expand All @@ -181,8 +261,7 @@ Accept wildcard characters: False
```

### -ProjectName
[Parameter(ParameterSetName = 'GetByPrioritiseServer', Mandatory)]
Specifies the Azure Migrate project in the current subscription.
Specifies the Azure Migrate project in the current subscription.

```yaml
Type: System.String
Expand All @@ -197,8 +276,7 @@ Accept wildcard characters: False
```

### -ResourceGroupName
[Parameter(ParameterSetName = 'GetByPrioritiseServer', Mandatory)]
Specifies the Resource Group of the Azure Migrate Project in the current subscription.
Specifies the Resource Group of the Azure Migrate Project in the current subscription.

```yaml
Type: System.String
Expand Down
Loading
Loading