Skip to content

Commit 93a8895

Browse files
Migrate DataMigration from generation to main (#20857)
* Move DataMigration to main * Update ChangeLog.md --------- Co-authored-by: Beisi Zhou <[email protected]>
1 parent 88a2cc5 commit 93a8895

File tree

10 files changed

+16
-14
lines changed

10 files changed

+16
-14
lines changed

src/DataMigration/DataMigration.Autorest/Az.DataMigration.psm1

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@
3333
}
3434

3535
if(-not $accountsModule) {
36-
Write-Error "`nThis module requires $accountsName version 2.7.5 or greater. For installation instructions, please see: https://learn.microsoft.com/powershell/azure/install-az-ps" -ErrorAction Stop
36+
Write-Error "`nThis module requires $accountsName version 2.7.5 or greater. For installation instructions, please see: https://docs.microsoft.com/powershell/azure/install-az-ps" -ErrorAction Stop
3737
} elseif (($accountsModule.Version -lt [System.Version]'2.7.5') -and (-not $localAccounts)) {
3838
Write-Error "`nThis module requires $accountsName version 2.7.5 or greater. An earlier version of Az.Accounts is imported in the current PowerShell session. If you are running test, please try to add the switch '-RegenerateSupportModule' when executing 'test-module.ps1'. Otherwise please open a new PowerShell session and import this module again.`nAdditionally, this error could indicate that multiple incompatible versions of Azure PowerShell modules are installed on your system. For troubleshooting information, please see: https://aka.ms/azps-version-error" -ErrorAction Stop
3939
}

src/DataMigration/DataMigration.Autorest/custom/Cmdlets/New-AzDataMigrationLoginsMigration.ps1

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ function New-AzDataMigrationLoginsMigration
9494
#Downloading and extracting LoginsMigration Zip file
9595
if(-Not $TestExePath)
9696
{
97-
$ZipSource = "https://sqlloginmigration.blob.core.windows.net/app/LoginsMigration.zip";
97+
$ZipSource = "https://sqlassess.blob.core.windows.net/app/LoginsMigration.zip";
9898
$ZipDestination = Join-Path -Path $BaseFolder -ChildPath "LoginsMigration.zip";
9999
Invoke-RestMethod -Uri $ZipSource -OutFile $ZipDestination;
100100

src/DataMigration/DataMigration.Autorest/custom/readme.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ These provide functionality to our HTTP pipeline and other useful features. In s
3232
### Attributes
3333
For processing the cmdlets, we've created some additional attributes:
3434
- `Microsoft.Azure.PowerShell.Cmdlets.DataMigration.DescriptionAttribute`
35-
- Used in C# cmdlets to provide a high-level description of the cmdlet. This is propagated to reference documentation via [help comments](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_comment_based_help) in the exported scripts.
35+
- Used in C# cmdlets to provide a high-level description of the cmdlet. This is propagated to reference documentation via [help comments](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_comment_based_help) in the exported scripts.
3636
- `Microsoft.Azure.PowerShell.Cmdlets.DataMigration.DoNotExportAttribute`
3737
- Used in C# and script cmdlets to suppress creating an exported cmdlet at build-time. These cmdlets will *not be exposed* by `Az.DataMigration`.
3838
- `Microsoft.Azure.PowerShell.Cmdlets.DataMigration.InternalExportAttribute`

src/DataMigration/DataMigration.Autorest/docs/readme.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,4 +8,4 @@ This directory contains the documentation of the cmdlets for the `Az.DataMigrati
88
- Packaged: yes
99

1010
## Details
11-
The process of documentation generation loads `Az.DataMigration` and analyzes the exported cmdlets from the module. It recognizes the [help comments](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_comment_based_help) that are generated into the scripts in the `..\exports` folder. Additionally, when writing custom cmdlets in the `..\custom` folder, you can use the help comments syntax, which decorate the exported scripts at build-time. The documentation examples are taken from the `..\examples` folder.
11+
The process of documentation generation loads `Az.DataMigration` and analyzes the exported cmdlets from the module. It recognizes the [help comments](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_comment_based_help) that are generated into the scripts in the `..\exports` folder. Additionally, when writing custom cmdlets in the `..\custom` folder, you can use the help comments syntax, which decorate the exported scripts at build-time. The documentation examples are taken from the `..\examples` folder.

src/DataMigration/DataMigration.Autorest/exports/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# Exports
2-
This directory contains the cmdlets *exported by* `Az.DataMigration`. No other cmdlets in this repository are directly exported. What that means is the `Az.DataMigration` module will run [Export-ModuleMember](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/export-modulemember) on the cmldets in this directory. The cmdlets in this directory are generated at **build-time**. Do not put any custom code, files, cmdlets, etc. into this directory. Please use `..\custom` for all custom implementation.
2+
This directory contains the cmdlets *exported by* `Az.DataMigration`. No other cmdlets in this repository are directly exported. What that means is the `Az.DataMigration` module will run [Export-ModuleMember](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/export-modulemember) on the cmldets in this directory. The cmdlets in this directory are generated at **build-time**. Do not put any custom code, files, cmdlets, etc. into this directory. Please use `..\custom` for all custom implementation.
33

44
## Info
55
- Modifiable: no
Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
2+
"autorest_powershell": "3.0.498",
3+
"autorest": "`-- (empty)",
24
"autorest_modelerfour": "4.15.414",
3-
"swagger_commit": "34ba022add0034e30462b76e1548ce5a7e053e33",
4-
"autorest_core": "3.9.2",
55
"node": "v14.15.5",
6-
"autorest": "`-- (empty)",
7-
"autorest_powershell": "3.0.494"
6+
"swagger_commit": "e217fd77475710b4a48542f433e3b9782f26f229",
7+
"autorest_core": "3.9.4"
88
}

src/DataMigration/DataMigration.Autorest/how-to.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ To generate documentation, the process is now integrated into the `build-module.
1414
To test the cmdlets, we use [Pester](https://github.com/pester/Pester). Tests scripts (`.ps1`) should be added to the `test` folder. To execute the Pester tests, run the `test-module.ps1` script. This will run all tests in `playback` mode within the `test` folder. To read more about testing cmdlets, look at the [README.md](examples/README.md) in the `examples` folder.
1515

1616
## Packing `Az.DataMigration`
17-
To pack `Az.DataMigration` for distribution, run the `pack-module.ps1` script. This will take the contents of multiple directories and certain root-folder files to create a `.nupkg`. The structure of the `.nupkg` is created so it can be loaded part of a [PSRepository](https://learn.microsoft.com/powershell/module/powershellget/register-psrepository). Additionally, this package is in a format for distribution to the [PSGallery](https://www.powershellgallery.com/). For signing an Azure module, please contact the [Azure PowerShell](https://github.com/Azure/azure-powershell) team.
17+
To pack `Az.DataMigration` for distribution, run the `pack-module.ps1` script. This will take the contents of multiple directories and certain root-folder files to create a `.nupkg`. The structure of the `.nupkg` is created so it can be loaded part of a [PSRepository](https://docs.microsoft.com/powershell/module/powershellget/register-psrepository). Additionally, this package is in a format for distribution to the [PSGallery](https://www.powershellgallery.com/). For signing an Azure module, please contact the [Azure PowerShell](https://github.com/Azure/azure-powershell) team.
1818

1919
## Module Script Details
2020
There are multiple scripts created for performing different actions for developing `Az.DataMigration`.

src/DataMigration/DataMigration.Autorest/internal/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ This directory contains a module to handle *internal only* cmdlets. Cmdlets that
88
- Packaged: yes
99

1010
## Details
11-
The `Az.DataMigration.internal.psm1` file is generated to this folder. This module file handles the hidden cmdlets. These cmdlets will not be exported by `Az.DataMigration`. Instead, this sub-module is imported by the `..\custom\Az.DataMigration.custom.psm1` module, allowing you to use hidden cmdlets in your custom, exposed cmdlets. To call these cmdlets in your custom scripts, simply use [module-qualified calls](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_command_precedence?view=powershell-6#qualified-names). For example, `Az.DataMigration.internal\Get-Example` would call an internal cmdlet named `Get-Example`.
11+
The `Az.DataMigration.internal.psm1` file is generated to this folder. This module file handles the hidden cmdlets. These cmdlets will not be exported by `Az.DataMigration`. Instead, this sub-module is imported by the `..\custom\Az.DataMigration.custom.psm1` module, allowing you to use hidden cmdlets in your custom, exposed cmdlets. To call these cmdlets in your custom scripts, simply use [module-qualified calls](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_command_precedence?view=powershell-6#qualified-names). For example, `Az.DataMigration.internal\Get-Example` would call an internal cmdlet named `Get-Example`.
1212

1313
## Purpose
1414
This allows you to include REST specifications for services that you *do not wish to expose from your module*, but simply want to call within custom cmdlets. For example, if you want to make a custom cmdlet that uses `Storage` services, you could include a simplified `Storage` REST specification that has only the operations you need. When you run the generator and build this module, note the generated `Storage` cmdlets. Then, in your readme configuration, use [cmdlet hiding](https://github.com/Azure/autorest/blob/master/docs/powershell/options.md#cmdlet-hiding-exportation-suppression) on the `Storage` cmdlets and they will *only be exposed to the custom cmdlets* you want to write, and not be exported as part of `Az.DataMigration`.

src/DataMigration/DataMigration/Az.DataMigration.psd1

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
#
44
# Generated by: Microsoft Corporation
55
#
6-
# Generated on: 10/10/2022
6+
# Generated on: 2/6/2023
77
#
88

99
@{
@@ -142,7 +142,8 @@ PrivateData = @{
142142
PSData = @{
143143

144144
# Tags applied to this module. These help with module discovery in online galleries.
145-
Tags = 'Azure','ResourceManager','ARM','Sql','Database','Data','Migration','Service'
145+
Tags = 'Azure', 'ResourceManager', 'ARM', 'Sql', 'Database', 'Data', 'Migration',
146+
'Service'
146147

147148
# A URL to the license for this module.
148149
LicenseUri = 'https://aka.ms/azps-license'
@@ -168,7 +169,7 @@ PrivateData = @{
168169

169170
} # End of PSData hashtable
170171

171-
} # End of PrivateData hashtable
172+
} # End of PrivateData hashtable
172173

173174
# HelpInfo URI of this module
174175
# HelpInfoURI = ''

src/DataMigration/DataMigration/ChangeLog.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@
1818
- Additional information about change #1
1919
-->
2020
## Upcoming Release
21+
* Updated the link of storage account for users to download LoginsMigration.zip file.
2122

2223
## Version 0.12.0
2324
* Added custom cmdlets for LoginsMigration:

0 commit comments

Comments
 (0)