Init for module: ImportExport and ImageBuilder

src/ImageBuilder/Az.ImageBuilder.psd1

@@ -0,0 +1,24 @@
+@{
+  GUID = 'bdedc683-d9b6-41ea-b310-d068b8c72305'
+  RootModule = './Az.ImageBuilder.psm1'
+  ModuleVersion = '0.1.0'
+  CompatiblePSEditions = 'Core', 'Desktop'
+  Author = 'Microsoft Corporation'
+  CompanyName = 'Microsoft Corporation'
+  Copyright = 'Microsoft Corporation. All rights reserved.'
+  Description = 'Microsoft Azure PowerShell: ImageBuilder cmdlets'
+  PowerShellVersion = '5.1'
+  DotNetFrameworkVersion = '4.7.2'
+  RequiredAssemblies = './bin/Az.ImageBuilder.private.dll'
+  FormatsToProcess = './Az.ImageBuilder.format.ps1xml'
+  FunctionsToExport = 'Get-AzImageBuilderRunOutput', 'Get-AzImageBuilderTemplate', 'New-AzImageBuilderCustomizerObject', 'New-AzImageBuilderDistributorObject', 'New-AzImageBuilderSourceObject', 'New-AzImageBuilderTemplate', 'Remove-AzImageBuilderTemplate', 'Start-AzImageBuilderTemplate', 'Stop-AzImageBuilderTemplate', '*'
+  AliasesToExport = '*'
+  PrivateData = @{
+    PSData = @{
+      Tags = 'Azure', 'ResourceManager', 'ARM', 'PSModule', 'ImageBuilder'
+      LicenseUri = 'https://aka.ms/azps-license'
+      ProjectUri = 'https://github.com/Azure/azure-powershell'
+      ReleaseNotes = ''
+    }
+  }
+}

src/ImageBuilder/Az.ImageBuilder.psm1

@@ -0,0 +1,109 @@
+# region Generated 
+  # ----------------------------------------------------------------------------------
+  #
+  # Copyright Microsoft Corporation
+  # Licensed under the Apache License, Version 2.0 (the "License");
+  # you may not use this file except in compliance with the License.
+  # You may obtain a copy of the License at
+  # http://www.apache.org/licenses/LICENSE-2.0
+  # Unless required by applicable law or agreed to in writing, software
+  # distributed under the License is distributed on an "AS IS" BASIS,
+  # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  # See the License for the specific language governing permissions and
+  # limitations under the License.
+  # ----------------------------------------------------------------------------------
+  # Load required Az.Accounts module
+  $accountsName = 'Az.Accounts'
+  $accountsModule = Get-Module -Name $accountsName
+  if(-not $accountsModule) {
+    $localAccountsPath = Join-Path $PSScriptRoot 'generated\modules'
+    if(Test-Path -Path $localAccountsPath) {
+      $localAccounts = Get-ChildItem -Path $localAccountsPath -Recurse -Include 'Az.Accounts.psd1' | Select-Object -Last 1
+      if($localAccounts) {
+        $accountsModule = Import-Module -Name ($localAccounts.FullName) -Scope Global -PassThru
+      }
+    }
+    if(-not $accountsModule) {
+      $hasAdequateVersion = (Get-Module -Name $accountsName -ListAvailable | Where-Object { $_.Version -ge [System.Version]'1.7.4' } | Measure-Object).Count -gt 0
+      if($hasAdequateVersion) {
+        $accountsModule = Import-Module -Name $accountsName -MinimumVersion 1.7.4 -Scope Global -PassThru
+      }
+    }
+  }
+
+  if(-not $accountsModule) {
+    Write-Error "`nThis module requires $accountsName version 1.7.4 or greater. For installation instructions, please see: https://docs.microsoft.com/en-us/powershell/azure/install-az-ps" -ErrorAction Stop
+  } elseif (($accountsModule.Version -lt [System.Version]'1.7.4') -and (-not $localAccounts)) {
+    Write-Error "`nThis module requires $accountsName version 1.7.4 or greater. An earlier version of Az.Accounts is imported in the current PowerShell session. If you are running test, please try to remove '.PSSharedModules' in your home directory. 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
+  }
+  Write-Information "Loaded Module '$($accountsModule.Name)'"
+
+  # Load the private module dll
+  $null = Import-Module -Name (Join-Path $PSScriptRoot './bin/Az.ImageBuilder.private.dll')
+
+  # Get the private module's instance
+  $instance = [Microsoft.Azure.PowerShell.Cmdlets.ImageBuilder.Module]::Instance
+
+  # Ask for the shared functionality table
+  $VTable = Register-AzModule
+
+  # Tweaks the pipeline on module load
+  $instance.OnModuleLoad = $VTable.OnModuleLoad
+
+  # Tweaks the pipeline per call
+  $instance.OnNewRequest = $VTable.OnNewRequest
+
+  # Gets shared parameter values
+  $instance.GetParameterValue = $VTable.GetParameterValue
+
+  # Allows shared module to listen to events from this module
+  $instance.EventListener = $VTable.EventListener
+
+  # Gets shared argument completers
+  $instance.ArgumentCompleter = $VTable.ArgumentCompleter
+
+  # The name of the currently selected Azure profile
+  $instance.ProfileName = $VTable.ProfileName
+
+
+  # Load the custom module
+  $customModulePath = Join-Path $PSScriptRoot './custom/Az.ImageBuilder.custom.psm1'
+  if(Test-Path $customModulePath) {
+    $null = Import-Module -Name $customModulePath
+  }
+
+  # Export nothing to clear implicit exports
+  Export-ModuleMember
+
+  # Export proxy cmdlet scripts
+  $exportsPath = Join-Path $PSScriptRoot './exports'
+  $directories = Get-ChildItem -Directory -Path $exportsPath
+  $profileDirectory = $null
+  if($instance.ProfileName) {
+    if(($directories | ForEach-Object { $_.Name }) -contains $instance.ProfileName) {
+      $profileDirectory = $directories | Where-Object { $_.Name -eq $instance.ProfileName }
+    } else {
+      # Don't export anything if the profile doesn't exist for the module
+      $exportsPath = $null
+      Write-Warning "Selected Azure profile '$($instance.ProfileName)' does not exist for module '$($instance.Name)'. No cmdlets were loaded."
+    }
+  } elseif(($directories | Measure-Object).Count -gt 0) {
+    # Load the last folder if no profile is selected
+    $profileDirectory = $directories | Select-Object -Last 1
+  }
+
+  if($profileDirectory) {
+    Write-Information "Loaded Azure profile '$($profileDirectory.Name)' for module '$($instance.Name)'"
+    $exportsPath = $profileDirectory.FullName
+  }
+
+  if($exportsPath) {
+    Get-ChildItem -Path $exportsPath -Recurse -Include '*.ps1' -File | ForEach-Object { . $_.FullName }
+    $cmdletNames = Get-ScriptCmdlet -ScriptFolder $exportsPath
+    Export-ModuleMember -Function $cmdletNames -Alias (Get-ScriptCmdlet -ScriptFolder $exportsPath -AsAlias)
+  }
+
+  # Finalize initialization of this module
+  $instance.Init();
+  Write-Information "Loaded Module '$($instance.Name)'"
+# endregion

src/ImageBuilder/build-module.ps1

@@ -0,0 +1,153 @@
+# ----------------------------------------------------------------------------------
+#
+# Copyright Microsoft Corporation
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ----------------------------------------------------------------------------------
+param([switch]$Isolated, [switch]$Run, [switch]$Test, [switch]$Docs, [switch]$Pack, [switch]$Code, [switch]$Release, [switch]$Debugger, [switch]$NoDocs)
+$ErrorActionPreference = 'Stop'
+
+if($PSEdition -ne 'Core') {
+  Write-Error 'This script requires PowerShell Core to execute. [Note] Generated cmdlets will work in both PowerShell Core or Windows PowerShell.'
+}
+
+if(-not $Isolated -and -not $Debugger) {
+  Write-Host -ForegroundColor Green 'Creating isolated process...'
+  $pwsh = [System.Diagnostics.Process]::GetCurrentProcess().Path
+  & "$pwsh" -NonInteractive -NoLogo -NoProfile -File $MyInvocation.MyCommand.Path @PSBoundParameters -Isolated
+
+  if($LastExitCode -ne 0) {
+    # Build failed. Don't attempt to run the module.
+    return
+  }
+
+  if($Test) {
+    . (Join-Path $PSScriptRoot 'test-module.ps1')
+    if($LastExitCode -ne 0) {
+      # Tests failed. Don't attempt to run the module.
+      return
+    }
+  }
+
+  if($Docs) {
+    . (Join-Path $PSScriptRoot 'generate-help.ps1')
+    if($LastExitCode -ne 0) {
+      # Docs generation failed. Don't attempt to run the module.
+      return
+    }
+  }
+
+  if($Pack) {
+    . (Join-Path $PSScriptRoot 'pack-module.ps1')
+    if($LastExitCode -ne 0) {
+      # Packing failed. Don't attempt to run the module.
+      return
+    }
+  }
+
+  $runModulePath = Join-Path $PSScriptRoot 'run-module.ps1'
+  if($Code) {
+    . $runModulePath -Code
+  } elseif($Run) {
+    . $runModulePath
+  } else {
+    Write-Host -ForegroundColor Cyan "To run this module in an isolated PowerShell session, run the 'run-module.ps1' script or provide the '-Run' parameter to this script."
+  }
+  return
+}
+
+$binFolder = Join-Path $PSScriptRoot 'bin'
+$objFolder = Join-Path $PSScriptRoot 'obj'
+
+if(-not $Debugger) {
+  Write-Host -ForegroundColor Green 'Cleaning build folders...'
+  $null = Remove-Item -Recurse -ErrorAction SilentlyContinue -Path $binFolder, $objFolder
+
+  if((Test-Path $binFolder) -or (Test-Path $objFolder)) {
+    Write-Host -ForegroundColor Cyan 'Did you forget to exit your isolated module session before rebuilding?'
+    Write-Error 'Unable to clean ''bin'' or ''obj'' folder. A process may have an open handle.'
+  }
+
+  Write-Host -ForegroundColor Green 'Compiling module...'
+  $buildConfig = 'Debug'
+  if($Release) {
+    $buildConfig = 'Release'
+  }
+  dotnet publish $PSScriptRoot --verbosity quiet --configuration $buildConfig /nologo
+  if($LastExitCode -ne 0) {
+    Write-Error 'Compilation failed.'
+  }
+
+  $null = Remove-Item -Recurse -ErrorAction SilentlyContinue -Path (Join-Path $binFolder 'Debug'), (Join-Path $binFolder 'Release')
+}
+
+$dll = Join-Path $PSScriptRoot 'bin\Az.ImageBuilder.private.dll'
+if(-not (Test-Path $dll)) {
+  Write-Error "Unable to find output assembly in '$binFolder'."
+}
+
+# Load DLL to use build-time cmdlets
+$null = Import-Module -Name $dll
+
+$modulePaths = $dll
+$customPsm1 = Join-Path $PSScriptRoot 'custom\Az.ImageBuilder.custom.psm1'
+if(Test-Path $customPsm1) {
+  $modulePaths = @($dll, $customPsm1)
+}
+
+$exportsFolder = Join-Path $PSScriptRoot 'exports'
+if(Test-Path $exportsFolder) {
+  $null = Get-ChildItem -Path $exportsFolder -Recurse -Exclude 'readme.md' | Remove-Item -Recurse -ErrorAction SilentlyContinue
+}
+$null = New-Item -ItemType Directory -Force -Path $exportsFolder
+
+$internalFolder = Join-Path $PSScriptRoot 'internal'
+if(Test-Path $internalFolder) {
+  $null = Get-ChildItem -Path $internalFolder -Recurse -Exclude '*.psm1', 'readme.md' | Remove-Item -Recurse -ErrorAction SilentlyContinue
+}
+$null = New-Item -ItemType Directory -Force -Path $internalFolder
+
+$psd1 = Join-Path $PSScriptRoot './Az.ImageBuilder.psd1'
+$guid = Get-ModuleGuid -Psd1Path $psd1
+$moduleName = 'Az.ImageBuilder'
+$examplesFolder = Join-Path $PSScriptRoot 'examples'
+$null = New-Item -ItemType Directory -Force -Path $examplesFolder
+
+if($NoDocs) {
+  Write-Host -ForegroundColor Green 'Creating exports...'
+  Export-ProxyCmdlet -ModuleName $moduleName -ModulePath $modulePaths -ExportsFolder $exportsFolder -InternalFolder $internalFolder -ExcludeDocs
+} else {
+  Write-Host -ForegroundColor Green 'Creating exports and docs...'
+  $moduleDescription = 'Microsoft Azure PowerShell: ImageBuilder cmdlets'
+  $docsFolder = Join-Path $PSScriptRoot 'docs'
+  if(Test-Path $docsFolder) {
+    $null = Get-ChildItem -Path $docsFolder -Recurse -Exclude 'readme.md' | Remove-Item -Recurse -ErrorAction SilentlyContinue
+  }
+  $null = New-Item -ItemType Directory -Force -Path $docsFolder
+  Export-ProxyCmdlet -ModuleName $moduleName -ModulePath $modulePaths -ExportsFolder $exportsFolder -InternalFolder $internalFolder -ModuleDescription $moduleDescription -DocsFolder $docsFolder -ExamplesFolder $examplesFolder -ModuleGuid $guid
+}
+
+Write-Host -ForegroundColor Green 'Creating format.ps1xml...'
+$formatPs1xml = Join-Path $PSScriptRoot './Az.ImageBuilder.format.ps1xml'
+Export-FormatPs1xml -FilePath $formatPs1xml
+
+Write-Host -ForegroundColor Green 'Creating psd1...'
+$customFolder = Join-Path $PSScriptRoot 'custom'
+Export-Psd1 -ExportsFolder $exportsFolder -CustomFolder $customFolder -Psd1Path $psd1 -ModuleGuid $guid
+
+Write-Host -ForegroundColor Green 'Creating test stubs...'
+$testFolder = Join-Path $PSScriptRoot 'test'
+$null = New-Item -ItemType Directory -Force -Path $testFolder
+Export-TestStub -ModuleName $moduleName -ExportsFolder $exportsFolder -OutputFolder $testFolder
+
+Write-Host -ForegroundColor Green 'Creating example stubs...'
+Export-ExampleStub -ExportsFolder $exportsFolder -OutputFolder $examplesFolder
+
+Write-Host -ForegroundColor Green '-------------Done-------------'

src/ImageBuilder/check-dependencies.ps1

@@ -0,0 +1,62 @@
+# ----------------------------------------------------------------------------------
+#
+# Copyright Microsoft Corporation
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ----------------------------------------------------------------------------------
+param([switch]$Isolated, [switch]$Accounts, [switch]$Pester, [switch]$Resources)
+$ErrorActionPreference = 'Stop'
+
+if(-not $Isolated) {
+  Write-Host -ForegroundColor Green 'Creating isolated process...'
+  $pwsh = [System.Diagnostics.Process]::GetCurrentProcess().Path
+  & "$pwsh" -NoExit -NoLogo -NoProfile -File $MyInvocation.MyCommand.Path @PSBoundParameters -Isolated
+  return
+}
+
+function DownloadModule ([bool]$predicate, [string]$path, [string]$moduleName, [string]$versionMinimum) {
+  if($predicate) {
+    $module = Get-Module -ListAvailable -Name $moduleName
+    if((-not $module) -or ($versionMinimum -and ($module | ForEach-Object { $_.Version } | Where-Object { $_ -ge [System.Version]$versionMinimum } | Measure-Object).Count -eq 0)) {
+      $null = New-Item -ItemType Directory -Force -Path $path
+      Write-Host -ForegroundColor Green "Installing local $moduleName module into '$path'..."
+      if($versionMinimum) {
+        Find-Module -Name $moduleName -MinimumVersion $versionMinimum -Repository PSGallery | Save-Module -Path $path
+      } else {
+        Find-Module -Name $moduleName -Repository PSGallery | Save-Module -Path $path
+      }
+    }
+  }
+}
+
+$ProgressPreference = 'SilentlyContinue'
+$all = (@($Accounts.IsPresent, $Pester.IsPresent) | Select-Object -Unique | Measure-Object).Count -eq 1
+
+$localModulesPath = Join-Path $PSScriptRoot 'generated\modules'
+if(Test-Path -Path $localModulesPath) {
+  $env:PSModulePath = "$localModulesPath$([IO.Path]::PathSeparator)$env:PSModulePath"
+}
+
+DownloadModule -predicate ($all -or $Accounts) -path $localModulesPath -moduleName 'Az.Accounts' -versionMinimum '1.7.4'
+DownloadModule -predicate ($all -or $Pester) -path $localModulesPath -moduleName 'Pester' -versionMinimum ''
+
+$tools = Join-Path $PSScriptRoot 'tools'
+$resourceDir = Join-Path $tools 'Resources'
+$resourceModule = Join-Path $HOME '.PSSharedModules\Resources\Az.Resources.TestSupport.psm1'
+
+if ($Resources.IsPresent -and (-not (Test-Path -Path $resourceModule))) {
+  Write-Host -ForegroundColor Green "Building local Resource module used for test..."
+  Set-Location $resourceDir
+  $null = autorest-beta .\readme.md --output-folder=$HOME/.PSSharedModules/Resources
+  $null = Copy-Item custom/* $HOME/.PSSharedModules/Resources/custom/
+  Set-Location $HOME/.PSSharedModules/Resources
+  $null = .\build-module.ps1
+  Set-Location $PSScriptRoot
+}

src/ImageBuilder/custom/Az.ImageBuilder.custom.psm1

@@ -0,0 +1,17 @@
+# region Generated 
+  # Load the private module dll
+  $null = Import-Module -PassThru -Name (Join-Path $PSScriptRoot '..\bin\Az.ImageBuilder.private.dll')
+
+  # Load the internal module
+  $internalModulePath = Join-Path $PSScriptRoot '..\internal\Az.ImageBuilder.internal.psm1'
+  if(Test-Path $internalModulePath) {
+    $null = Import-Module -Name $internalModulePath
+  }
+
+  # Export nothing to clear implicit exports
+  Export-ModuleMember
+
+  # Export script cmdlets
+  Get-ChildItem -Path $PSScriptRoot -Recurse -Include '*.ps1' -File | ForEach-Object { . $_.FullName }
+  Export-ModuleMember -Function (Get-ScriptCmdlet -ScriptFolder $PSScriptRoot) -Alias (Get-ScriptCmdlet -ScriptFolder $PSScriptRoot -AsAlias)
+# endregion