Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
1 change: 0 additions & 1 deletion src/Migrate/Migrate.Autorest/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
This directory contains the PowerShell module for the Migrate service.

---

## Info
- Modifiable: yes
- Generated: all
Expand Down
12 changes: 6 additions & 6 deletions src/Migrate/Migrate/Az.Migrate.psd1
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
#
# Generated by: Microsoft Corporation
#
# Generated on: 1/30/2024
# Generated on: 3/17/2024
#

@{
Expand Down Expand Up @@ -51,16 +51,16 @@ DotNetFrameworkVersion = '4.7.2'
# ProcessorArchitecture = ''

# Modules that must be imported into the global environment prior to importing this module
RequiredModules = @(@{ModuleName = 'Az.Accounts'; ModuleVersion = '2.15.1'; })
RequiredModules = @(@{ModuleName = 'Az.Accounts'; ModuleVersion = '2.16.0'; })

# Assemblies that must be loaded prior to importing this module
RequiredAssemblies = 'Migrate.Autorest/bin/Az.Migrate.private.dll'

# Script files (.ps1) that are run in the caller's environment prior to importing this module.
# ScriptsToProcess = @()
ScriptsToProcess = @()

# Type files (.ps1xml) to be loaded when importing this module
# TypesToProcess = @()
TypesToProcess = @()

# Format files (.ps1xml) to be loaded when importing this module
FormatsToProcess = 'Migrate.Autorest/Az.Migrate.format.ps1xml'
Expand Down Expand Up @@ -123,7 +123,7 @@ PrivateData = @{
PSData = @{

# Tags applied to this module. These help with module discovery in online galleries.
Tags = 'Azure','ResourceManager','ARM','PSModule','Migrate'
Tags = 'Azure', 'ResourceManager', 'ARM', 'PSModule', 'Migrate'

# A URL to the license for this module.
LicenseUri = 'https://aka.ms/azps-license'
Expand All @@ -148,7 +148,7 @@ PrivateData = @{

} # End of PSData hashtable

} # End of PrivateData hashtable
} # End of PrivateData hashtable

# HelpInfo URI of this module
# HelpInfoURI = ''
Expand Down
30 changes: 30 additions & 0 deletions src/Migrate/Migrate/help/Az.Migrate.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,15 @@ Microsoft Azure PowerShell: Migrate cmdlets
### [Get-AzMigrateDiscoveredServer](Get-AzMigrateDiscoveredServer.md)
Get All discovered servers in a migrate project.

### [Get-AzMigrateHCIJob](Get-AzMigrateHCIJob.md)
Retrieves the status of an Azure Migrate job.

### [Get-AzMigrateHCIReplicationFabric](Get-AzMigrateHCIReplicationFabric.md)
Gets the details of the fabric.

### [Get-AzMigrateHCIServerReplication](Get-AzMigrateHCIServerReplication.md)
Retrieves the details of the replicating server.

### [Get-AzMigrateJob](Get-AzMigrateJob.md)
Retrieves the status of an Azure Migrate job.

Expand Down Expand Up @@ -47,12 +56,24 @@ Method to get a site.
### [Get-AzMigrateSolution](Get-AzMigrateSolution.md)
Gets a solution in the migrate project.

### [Initialize-AzMigrateHCIReplicationInfrastructure](Initialize-AzMigrateHCIReplicationInfrastructure.md)
Initializes the infrastructure for the migrate project.

### [Initialize-AzMigrateReplicationInfrastructure](Initialize-AzMigrateReplicationInfrastructure.md)
Initialises the infrastructure for the migrate project.

### [New-AzMigrateDiskMapping](New-AzMigrateDiskMapping.md)
Creates a new disk mapping

### [New-AzMigrateHCIDiskMappingObject](New-AzMigrateHCIDiskMappingObject.md)
Creates a new disk mapping

### [New-AzMigrateHCINicMappingObject](New-AzMigrateHCINicMappingObject.md)
Creates an object to update NIC properties of a replicating server.

### [New-AzMigrateHCIServerReplication](New-AzMigrateHCIServerReplication.md)
Starts replication for the specified server.

### [New-AzMigrateNicMapping](New-AzMigrateNicMapping.md)
Creates an object to update NIC properties of a replicating server.

Expand All @@ -74,6 +95,9 @@ Creates an object to update NIC properties of a test migrating server.
### [Register-AzMigrateProjectTool](Register-AzMigrateProjectTool.md)
Registers a tool with the migrate project.

### [Remove-AzMigrateHCIServerReplication](Remove-AzMigrateHCIServerReplication.md)
Stops replication for the migrated server.

### [Remove-AzMigrateProject](Remove-AzMigrateProject.md)
Delete the migrate project.
Deleting non-existent project is a no-operation.
Expand All @@ -90,9 +114,15 @@ Starts the replication that has been suspended.
### [Set-AzMigrateDiskMapping](Set-AzMigrateDiskMapping.md)
Updates disk mapping

### [Set-AzMigrateHCIServerReplication](Set-AzMigrateHCIServerReplication.md)
Updates the target properties for the replicating server.

### [Set-AzMigrateServerReplication](Set-AzMigrateServerReplication.md)
Updates the target properties for the replicating server.

### [Start-AzMigrateHCIServerMigration](Start-AzMigrateHCIServerMigration.md)
Starts the migration for the replicating server.

### [Start-AzMigrateServerMigration](Start-AzMigrateServerMigration.md)
Starts the migration for the replicating server.

Expand Down
65 changes: 50 additions & 15 deletions src/Migrate/Migrate/help/Get-AzMigrateDiscoveredServer.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,34 +15,37 @@ Get All discovered servers in a migrate project.
### List (Default)
```
Get-AzMigrateDiscoveredServer -ProjectName <String> -ResourceGroupName <String> [-DisplayName <String>]
[-SourceMachineType <String>] [-SubscriptionId <String[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
[-SourceMachineType <String>] [-SubscriptionId <String[]>] [-ProgressAction <ActionPreference>] [-WhatIf]
[-Confirm] [<CommonParameters>]
```

### ListInSite
```
Get-AzMigrateDiscoveredServer -ProjectName <String> -ResourceGroupName <String> [-DisplayName <String>]
[-SourceMachineType <String>] [-SubscriptionId <String[]>] -ApplianceName <String> [-WhatIf] [-Confirm]
[<CommonParameters>]
[-SourceMachineType <String>] [-SubscriptionId <String[]>] -ApplianceName <String>
[-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]
```

### Get
```
Get-AzMigrateDiscoveredServer -ProjectName <String> -ResourceGroupName <String> [-SourceMachineType <String>]
[-SubscriptionId <String[]>] -Name <String> [-WhatIf] [-Confirm] [<CommonParameters>]
[-SubscriptionId <String[]>] -Name <String> [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm]
[<CommonParameters>]
```

### GetInSite
```
Get-AzMigrateDiscoveredServer -ProjectName <String> -ResourceGroupName <String> [-SourceMachineType <String>]
[-SubscriptionId <String[]>] -Name <String> -ApplianceName <String> [-WhatIf] [-Confirm] [<CommonParameters>]
[-SubscriptionId <String[]>] -Name <String> -ApplianceName <String> [-ProgressAction <ActionPreference>]
[-WhatIf] [-Confirm] [<CommonParameters>]
```

## DESCRIPTION
Get Azure migrate server commandlet fetches all servers in a migrate project.

## EXAMPLES

### Example 1: List
### Example 1: List VMware machines
```powershell
Get-AzMigrateDiscoveredServer -SubscriptionId xxx-xxx-xxx -ResourceGroupName julytest -ProjectName julytest
```
Expand All @@ -64,7 +67,7 @@ idclab-a360-fareast-corp-micros-86617dcf-effe-59ad-8c3a-cdd3ea7300d3_5029cc18-ef

Get All servers in a migrate project.

### Example 2: Get
### Example 2: Get VMware machine
```powershell
Get-AzMigrateDiscoveredServer -Name idclab-a360-fareast-corp-micros-86617dcf-effe-59ad-8c3a-cdd3ea7300d3_5029e62c-31d2-a6c3-5316-aa39f47c49fc -SubscriptionId xxx-xxx-xxx -ResourceGroupName julytest -ProjectName julytest
```
Expand All @@ -78,7 +81,7 @@ idclab-a360-fareast-corp-micros-86617dcf-effe-59ad-8c3a-cdd3ea7300d3_5029e62c-31
Get a server in a migrate project by name.
Name is a unique paramenter for a server.

### Example 3: List in an appliance
### Example 3: List VMware machines in an appliance
```powershell
Get-AzMigrateDiscoveredServer -ApplianceName BBVMwareAVS -SubscriptionId xxx-xxx-xxx -ResourceGroupName julytest -ProjectName julytest
```
Expand All @@ -100,7 +103,7 @@ idclab-a360-fareast-corp-micros-86617dcf-effe-59ad-8c3a-cdd3ea7300d3_5029cc18-ef

List all servers for an appliance in a project.

### Example 4: Get in an appliance
### Example 4: Get VMware machine in an appliance
```powershell
Get-AzMigrateDiscoveredServer -Name idclab-a360-fareast-corp-micros-86617dcf-effe-59ad-8c3a-cdd3ea7300d3_5029e62c-31d2-a6c3-5316-aa39f47c49fc -ApplianceName BBVMwareAVS -SubscriptionId xxx-xxx-xxx -ResourceGroupName julytest -ProjectName julytest
```
Expand All @@ -114,7 +117,7 @@ idclab-a360-fareast-corp-micros-86617dcf-effe-59ad-8c3a-cdd3ea7300d3_5029e62c-31
Get a server for an appliance in a project.
Name is a unique paramenter for a server.

### Example 5: List and filter by display name
### Example 5: List and filter VMware machines by display name
```powershell
Get-AzMigrateDiscoveredServer -SubscriptionId xxx-xxx-xxx -ResourceGroupName BugBashAVSVMware -ProjectName BugBashAVSVMware -DisplayName Contoso | Format-Table DisplayName,Name,Type
```
Expand All @@ -133,7 +136,7 @@ ContosoAppSrv1 10-150-8-52-b090bef3-b733-5e34-bc8f-eb6f2701432a_5

List servers in a migrate project and filter responses with display name.

### Example 6: List in an appliance and filter by display name
### Example 6: List VMware machines in an appliance and filter by display name
```powershell
Get-AzMigrateDiscoveredServer -SubscriptionId xxx-xxx-xxx -ResourceGroupName BugBashAVSVMware -ProjectName BugBashAVSVMware -ApplianceName BBVMwareAVS -DisplayName Contoso | Format-Table DisplayName,Name,Type
```
Expand All @@ -153,6 +156,23 @@ Contoso-DataTier3 10-150-8-52-b090bef3-b733-5e34-bc8f-eb6f2701432a_5

List servers for an appliance in a migrate project and filter responses with display name.

### Example 7: List HyperV machines
```powershell
Get-AzMigrateDiscoveredServer -SubscriptionId xxx-xxx-xxx -ResourceGroupName "test-rg" -ProjectName "testproj" -SourceMachineType "HyperV" | Format-Table DisplayName,Name,Type
```

```output
DisplayName Name Type
----------- ---- ----
testvm1 291b6c67-8793-4e21-887e-1e6c3bd00a60 Microsoft.OffAzure/HyperVSites/machines
testvm2 0fbd6ccb-7133-4e72-b18e-5ec98c9c628f Microsoft.OffAzure/HyperVSites/machines
testvm3 e6390dfa-6125-431c-871d-f407bdecb571 Microsoft.OffAzure/HyperVSites/machines
testvm4 af83b64b-2314-48e2-8d0f-fd44ab5142ba Microsoft.OffAzure/HyperVSites/machines
```

Get All HyperV servers in a migrate project.
Similarly, specify "HyperV" for -SourceMachineType in all the above examples can retrieve HyperV machine(s) in different ways.

## PARAMETERS

### -ApplianceName
Expand All @@ -172,7 +192,7 @@ Accept wildcard characters: False
```

### -DisplayName
Specifies the VMware machine display name.
Specifies the source machine display name.

```yaml
Type: System.String
Expand All @@ -187,7 +207,7 @@ Accept wildcard characters: False
```

### -Name
Specifies the VMware machine name.
Specifies the source machine name.
This is an internal Name.
For users, use display name.

Expand All @@ -203,6 +223,21 @@ Accept pipeline input: False
Accept wildcard characters: False
```

### -ProgressAction
{{ Fill ProgressAction Description }}

```yaml
Type: System.Management.Automation.ActionPreference
Parameter Sets: (All)
Aliases: proga

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

### -ProjectName
Specifies the migrate project name.

Expand Down Expand Up @@ -302,10 +337,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable

## OUTPUTS

### Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api202001.IHyperVMachine

### Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api202001.IVMwareMachine

## NOTES

ALIASES

## RELATED LINKS
Loading