PowerShell Gallery | AksHci.psm1 1.1.66 (2023)

#requires -runasadministrator

usingmodule.\Common.psm1

#region Module Constants

$moduleName="AksHci"
$moduleVersion="1.1.66"
#endregion

#region requires
#Requires -Modules @{ModuleName="Az.Resources"; RequiredVersion="4.4.0"; GUID="48bb344d-4c24-441e-8ea0-589947784700"}
#Requires -Modules @{ModuleName="Az.Accounts"; RequiredVersion="2.6.0"; GUID="17a2feff-488b-47f9-8729-e2cec094624c"}
#Requires -Modules @{ModuleName="AzureAD"; RequiredVersion="2.0.2.137"; GUID="d60c0004-962d-4dfb-8d28-5707572ffd00"}
#endregion

#region Download catalog constants

$catalogName="aks-hci-stable-catalogs-ext"
$ringName="stable"

# Default AksHci product name from catalog
$defaultProductName="aks-hci-releases"

# Major version is checked for compatibilty between PS and product
$supportedProductVersion="1.0.0"

#endregion

#region Aliases

Set-Alias-NameInitialize-AksHciNode-ValueInitialize-MocNode
Set-Alias-NameUpdate-AksHciClusterCertificates-ValueRepair-AksHciClusterCerts
Set-Alias-NameUpdate-AksHciCertificates-ValueRepair-AksHciCerts

#endregion

#region
# Install Event Log
New-ModuleEventLog-moduleName$moduleName

#endregion

#region to capture TraceCmdlet Configmap details

classTraceConfigDetails{
[string]$DeploymentId
[string]$Catalog
[string]$Audience
[string]$AksHciVersion
[string]$ModuleName
[string]$Offer
[string]$ModuleVersion
}

#endregion

#region Private Function

functionInitialize-AksHciConfiguration
{
<#
.DESCRIPTION
Initialize AksHci Configuration
Wipes off any existing cached configuration
#>
if($global:config.ContainsKey($moduleName)){
$global:config.Remove($moduleName)
}

$global:config+=@{
$moduleName=@{
"installationPackageDir"=""
"installState"=[InstallState]::NotInstalled
"manifestCache"=""
"moduleVersion"=$moduleVersion
"skipUpdates"=$false
"stagingShare"=""
"useStagingShare"=$false
"version"=""
"workingDir"=""
"catalog"=""
"ring"=""
"proxyServerCertFile"=""
"proxyServerHTTP"=""
"proxyServerHTTPS"=""
"proxyServerNoProxy"=""
"proxyServerPassword"=""
"proxyServerUsername"=""
"deploymentId"=""
"caCertRotationThreshold"=90
"offlineDownload"=$false
"offsiteTransferCompleted"=$false
"concurrentDownloads"=$global:smallBinConcurrentDownloads
"enableOptionalDiagnosticData"=$false
};
}
}

#endregion

#region global config
Initialize-AksHciConfiguration
#endregion

Import-LocalizedData-BindingVariable"GenericLocMessage"-FileNamecommonLocalizationMessages
Import-LocalizedData-BindingVariable"AksHciLocMessage"-FileNameAksHciLocalizationMessages

#region Exported Functions

functionNew-AksHciNetworkSetting
{
<#
.SYNOPSIS
Create an object for a new virtual network.

.DESCRIPTION
Create a virtual network to set the DHCP or static IP address for the control plane,
load balancer, agent endpoints, and a static IP range for nodes in all Kubernetes
clusters. This cmdlet will return a VirtualNetwork object, which can be used later in
the configuration steps.

.PARAMETER name
The name of the vnet

.PARAMETER vswitchName
The name of the vswitch

.PARAMETER MacPoolName
The name of the mac pool

.PARAMETER vlanID
The VLAN ID for the vnet

.PARAMETER ipaddressprefix
The address prefix to use for static IP assignment

.PARAMETER gateway
The gateway to use when using static IP

.PARAMETER dnsservers
The dnsservers to use when using static IP

.PARAMETER vippoolstart
The starting ip address to use for the vip pool.
The vip pool addresses will be used by the k8s API server and k8s services'

.PARAMETER vippoolend
The ending ip address to use for the vip pool.
The vip pool addresses will be used by the k8s API server and k8s services

.PARAMETER k8snodeippoolstart
The starting ip address to use for VM's in the cluster.

.PARAMETER k8snodeippoolend
The ending ip address to use for VM's in the cluster.

.OUTPUTS
VirtualNetwork object

.EXAMPLE
New-AksHciNetworkSetting -name External -vippoolstart 172.16.0.0 -vippoolend 172.16.0.240

.EXAMPLE
New-AksHciNetworkSetting -name "Defualt Switch" -ipaddressprefix 172.16.0.0/24 -gateway 172.16.0.1 -dnsservers 4.4.4.4, 8.8.8.8 -vippoolstart 172.16.0.0 -vippoolend 172.16.0.240
#>

param(
[Parameter(Mandatory=$true)]
[ValidateScript({Test-ValidNetworkName-Name$_})]
[string]$name,

[Parameter(Mandatory=$true)]
[string]$vswitchName,

[Parameter(Mandatory=$false)]
[String]$MacPoolName=$global:cloudMacPool,

[Parameter(Mandatory=$false)]
[ValidateRange(0,4094)]
[int]$vlanID=$global:defaultVlanID,

[Parameter(Mandatory=$false)]
# [ValidateScript({Test-ValidIPPrefix -ipprefix $_})]
[String]$ipaddressprefix,

[Parameter(Mandatory=$false)]
# [ValidateScript({Test-ValidIpv4Address -ipv4 $_})]
[String]$gateway,

[Parameter(Mandatory=$false)]
# [ValidateScript({Test-ValidDNSServers -dnsservers $_})]
[String[]]$dnsservers,

[Parameter(Mandatory=$false)]
# [ValidateScript({Test-ValidIpv4Address -ipv4 $_})]
[String]$vippoolstart,

[Parameter(Mandatory=$false)]
# [ValidateScript({Test-ValidIpv4Address -ipv4 $_})]
[String]$vippoolend,

[Parameter(Mandatory=$false)]
# [ValidateScript({Test-ValidIpv4Address -ipv4 $_})]
[String]$k8snodeippoolstart,

[Parameter(Mandatory=$false)]
# [ValidateScript({Test-ValidIpv4Address -ipv4 $_})]
[String]$k8snodeippoolend
)

$startCmdletTime=Get-Date

$networkdetailsCmdletParams=@{name=$name;vswitchName=$vswitchName;MacPoolName=$MacPoolName;gateway=$gateway;dnsservers=$dnsservers;vippoolstart=$vippoolstart;vippoolend=$vippoolend;k8snodeippoolstart=$k8snodeippoolstart;k8snodeippoolend=$k8snodeippoolend}

trap
{
Trace-CmdletError-ConfigDetails$(Get-TraceConfigDetails)`
-ErrorMessage$_`
-StartCmdletTime$startCmdletTime`
-CmdletParameters$networkdetailsCmdletParams
throw$_
}

Trace-Cmdlet-ConfigDetails$(Get-TraceConfigDetails)`
-StartCmdletTime$startCmdletTime`
-CmdletParameters$networkdetailsCmdletParams

returnNew-VirtualNetwork-name$name-vswitchName$vswitchName-MacPoolName$MacPoolName-vlanID$vlanID-ipaddressprefix$ipaddressprefix`
-gateway$gateway-dnsservers$dnsservers-vippoolstart$vippoolstart-vippoolend$vippoolend-k8snodeippoolstart$k8snodeippoolstart-k8snodeippoolend$k8snodeippoolend

}

functionNew-AksHciSSHConfiguration
{
<#
.SYNOPSIS
Create an object for a new ssh configuration.

.DESCRIPTION
Create a SSH configuration for AksHci virtual machines to define SSH access.

.PARAMETER name
The name of the sshConfiguration

.PARAMETER sshPublicKey
Path to an SSH public key file. Using this public key, you will be able to log in to any of the VMs created by
the Azure Kubernetes Service on Azure Stack HCI deployment. If you have your own SSH public key, you will pass
its location here. If no key is provided, we will look for one under %systemdrive%\akshci\.ssh\akshci_rsa.pub.
If the file does not exist, an SSH key pair in the above location will be generated and used.

.PARAMETER sshPrivateKey
The path to sshPrivateKey file

.PARAMETER restrictSSHCommands
Restict SSH access to certain commands

.PARAMETER ipAddresses
Restict SSH access to certain ipaddresses

.PARAMETER cidr
Restict SSH access to a CIDR

.OUTPUTS
SSHConfiguration object

.EXAMPLE
New-AksHciSSHConfiguration -name sshConfig -sshPublicKey C:\AksHci\akshci_rsa.pub

.EXAMPLE
New-AksHciSSHConfiguration -name sshConfig -sshPublicKey C:\AksHci\akshci_rsa.pub -cidr 172.16.0.0/24

.EXAMPLE
New-AksHciSSHConfiguration -name sshConfig -sshPublicKey C:\AksHci\akshci_rsa.pub -ipAddresses 4.4.4.4,8.8.8.8

.EXAMPLE
New-AksHciSSHConfiguration -name sshConfig -cidr 172.16.0.0/24

.EXAMPLE
New-AksHciSSHConfiguration -name sshConfig -ipAddresses 4.4.4.4,8.8.8.8

.EXAMPLE
New-AksHciSSHConfiguration -name sshConfig -ipAddresses 4.4.4.4,8.8.8.8 -restrictSSHCommands

#>

[CmdletBinding(DefaultParameterSetName='noip')]
param(
[Parameter(Mandatory=$true)]
[ValidateNotNullOrEmpty()]
[String]$name,

[Parameter(Mandatory=$false)]
[String]$sshPublicKey,

[Parameter(Mandatory=$false)]
[String]$sshPrivateKey,

[Parameter(Mandatory=$false)]
[Switch]$restrictSSHCommands=$false,

[Parameter(Mandatory=$true,ParameterSetName='ipaddresses')]
[String[]]$ipAddresses,

[Parameter(Mandatory=$true,ParameterSetName='cidr')]
[String]$cidr
)

$startCmdletTime=Get-Date

$sshdetailsCmdletParams=@{name=$name;sshPublicKey=$sshPublicKey;sshPrivateKey=$sshPrivateKey;restrictSSHCommands=$restrictSSHCommands;ipAddresses=$ipAddresses;cidr=$cidr}

trap
{
Trace-CmdletError-ConfigDetails$(Get-TraceConfigDetails)`
-ErrorMessage$_`
-StartCmdletTime$startCmdletTime`
-CmdletParameters$sshdetailsCmdletParams
throw$_
}

Trace-Cmdlet-ConfigDetails$(Get-TraceConfigDetails)`
-StartCmdletTime$startCmdletTime`
-CmdletParameters$sshdetailsCmdletParams

if($PSCmdlet.ParameterSetName-ieq"ipaddresses")
{
returnNew-SSHConfiguration-name$name-sshPublicKey$sshPublicKey-sshPrivateKey$sshPrivateKey-ipAddresses$ipaddresses-restrictSSHCommands:$restrictSSHCommands.IsPresent
}

if($PSCmdlet.ParameterSetName-ieq"cidr")
{
returnNew-SSHConfiguration-name$name-sshPublicKey$sshPublicKey-sshPrivateKey$sshPrivateKey-cidr$cidr-restrictSSHCommands:$restrictSSHCommands.IsPresent
}
returnNew-SSHConfiguration-name$name-sshPublicKey$sshPublicKey-sshPrivateKey$sshPrivateKey-restrictSSHCommands:$restrictSSHCommands.IsPresent
}

functionTest-ModuleCompatibility
{
<#
.DESCRIPTION
Tests if the requested product version is compatible with the version(s) understood by
this Powershell module.
.PARAMETER Version
The AKS HCI product version to be tested for compatibility.
#>
param(
[String]$Version
)
$result=Compare-Versions-Version$script:supportedProductVersion-ComparisonVersion$Version
if($result-eq0)
{
return$true
}
$errorMsg=$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_incompatible_version,$Version,$moduleName,$moduleVersion))
if($result-lt0)
{
$errorMsg+=$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_older_version,$moduleName))
}
else
{
$errorMsg+=$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_newer_version,$moduleName))
}
throw$errorMsg
}

functionSet-AksHciOffsiteConfig{
param(
[parameter()]
# [ValidateScript({Test-ValidDirectoryPath -dirPath $_})]
[String]$workingDir=$global:defaultWorkingDir,

[parameter()]
[String]$catalog=$script:catalogName,

[parameter()]
[String]$ring=$script:ringName,

[Parameter(Mandatory=$true)]
[String]$stagingShare=$global:defaultStagingShare,

[parameter()]
[String]$version
)

$startCmdletTime=Get-Date
$configCmdletParams=@{catalog=$catalog;ring=$ring;workingDir=$workingDir;stagingShare=$stagingShare;version=$version}

trap
{
Trace-CmdletError-ErrorMessage$_`
-StartCmdletTime$startCmdletTime`
-CmdletParameters$configCmdletParams
throw$_
}

if([string]::IsNullOrWhiteSpace($stagingShare))
{
throw[CustomException]::new($($GenericLocMessage.generic_staging_share_unspecified),([ErrorTypes]::IsUserErrorFlag))
}

try{
Import-AksHciConfig-activity$activity
}catch{}
$currentState=Get-ConfigurationValue-module$moduleName-type([Type][InstallState])-name"installState"
if($currentState){
switch($currentState){
([InstallState]::NotInstalled){
# Fresh install
break
}
Default{
Write-Status-moduleName$moduleName$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_current_state,$currentState))
throw$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_no_new_config_in_current_state,$moduleName,$currentState))
}
}
}

Set-AksHciConfigValue-name"catalog"-value$catalog
Set-AksHciConfigValue-name"ring"-value$ring
Set-AksHciConfigValue-name"workingDir"-value$workingDir
Set-AksHciConfigValue-name"manifestCache"-value([io.Path]::Combine($workingDir,$("$catalog.json")))
New-Item-ItemTypeDirectory-Force-Path$workingDir|out-null
Set-AksHciConfigValue-name"stagingShare"-value$stagingShare
Set-AksHciConfigValue-name"offlineDownload"-value$true

if(-not$version)
{
$version=Get-ConfigurationValue-Name"version"-module$moduleName
if(-not$version)
{
# If no version is specified, use the latest
$version=Get-AksHciLatestVersion
Set-AksHciConfigValue-name"version"-value$version
}
}
else
{
Get-AksHciLatestVersion|out-null# This clears the cache
Get-ProductRelease-Version$version-module$moduleName|Out-Null
Set-AksHciConfigValue-name"version"-value$version
}

Set-KvaOffsiteConfig-catalog$catalog-ring$ring-workingDir$workingDir-version$version-stagingShare$stagingShare
Set-MocOffsiteConfig-catalog$catalog-ring$ring-workingDir$workingDir-version$version-stagingShare$stagingShare

Trace-Cmdlet-ConfigDetails$(Get-TraceConfigDetails)`
-StartCmdletTime$startCmdletTime`
-CmdletParameters$configCmdletParams
}

functionSet-AksHciConfig
{
<#
.SYNOPSIS
Set or update the configurations settings for the Azure Kubernetes Service host.

.DESCRIPTION
Set the configuration settings for the Azure Kubernetes Service host. If you're deploying
on a 2-4 node Azure Stack HCI cluster or a Windows Server 2019 Datacenter failover cluster,
you must specify the imageDir and cloudConfigLocation parameters. For a single node Windows
Server 2019 Datacenter, all parameters are optional and set to their default values. However,
for optimal performance, we recommend using a 2-4 node Azure Stack HCI cluster deployment.

.PARAMETER workingDir
This is a working directory for the module to use for storing small files. Defaults to %systemdrive%\akshci
for single node deployments. For multi-node deployments, this parameter must be specified. The path must
point to a shared storage path such as c:\ClusterStorage\Volume2\ImageStore or an SMB share such as
\\FileShare\ImageStore.

.PARAMETER imageDir
The path to the directory where Azure Kubernetes Service on Azure Stack HCI will store its VHD images.
Defaults to %systemdrive%\AksHciImageStore for single node deployments. For multi-node deployments,
this parameter must be specified. The path must point to a shared storage path such as
C:\ClusterStorage\Volume2\ImageStore or a SMB share such as \\fileshare\ImageStore.

.PARAMETER version
The version of Azure Kubernetes Service on Azure Stack HCI that you want to deploy. The default is the
latest version. We do not recommend changing the default.

.PARAMETER cloudConfigLocation
The location where the cloud agent will store its configuration. Defaults to %systemdrive%\wssdcloudagent
for single node deployments. The location can be the same as the path of -imageDir. For multi-node
deployments, this parameter must be specified. The path must point to a shared storage path such as
C:\ClusterStorage\Volume2\ImageStore or an SMB share such as \\fileshare\ImageStore. The location needs to
be on a highly available share so that the storage will always be accessible.

.PARAMETER nodeConfigLocation
The location where the node agents will store their configuration. Every node has a node agent, so its
configuration is local to it. This location must be a local path. Defaults to %systemdrive%\programdata\wssdagent
for all deployments.

.PARAMETER cloudLocation
This parameter provides a custom Microsoft Operated Cloud location name. The default name is "MocLocation".
We do not recommend changing the default.

.PARAMETER createAutoConfigContainers
This parameter enables or disables generating auto-config-container- folders for Moc. The default value is $true.

.PARAMETER vnet
A VirtualNetwork object created using the New-AksHciNetworkSetting cmdlet.

.PARAMETER ssh
A SSH Configuration object created using the New-AksHciSSHConfiguration cmdlet.

.PARAMETER controlplaneVmSize
The size of the VM to create for the control plane. To get a list of available VM sizes, use Get-AksHciVmSize.

.PARAMETER kvaName
Kubernetes Virtual Appliance name. We do not recommend changing the default.

.PARAMETER kvaPodCIDR
Configures the Kubernetes POD CIDR. We do not recommend changing the default.

.PARAMETER nodeAgentPort
The TCP/IP port number that node agents should listen on. Defaults to 45000. We do not recommend changing the
default.

.PARAMETER nodeAgentAuthorizerPort
The TCP/IP port number that node agents should use for their authorization port. Defaults to 45001. We do not
recommend changing the default.

.PARAMETER cloudAgentPort
The TCP/IP port number that cloud agent should listen on. Defaults to 55000. We do not recommend changing the
default.

.PARAMETER cloudAgentAuthorizerPort
The TCP/IP port number that cloud agent should use for its authorization port. Defaults to 65000. We do not
recommend changing the default.

.PARAMETER clusterRoleName
This specifies the name to use when creating cloud agent as a generic service within the cluster. This defaults
to a unique name with a prefix of ca- and a guid suffix (for example: "ca-9e6eb299-bc0b-4f00-9fd7-942843820c26").
We do not recommend changing the default.

.PARAMETER cloudServiceIP
This can be used to provide a static IP address to be assigned to the MOC CloudAgent service. This value
should be provided using the standard IPv4 format. (Example: 192.168.1.2). The cloudServiceIP address
should also be carved out of one of the ClusterAndClient networks in the underlying Failover cluster.
You can run Get-ClusterNetwork command in an elevated powershell mode to find the network role.
You may want to specify this to ensure that anything important on the network is always
accessible because the IP address will not change. Please note that you can also provide a
cloudServiceCidr IP/netowrk address prefix. (Example: 192.168.1.2/16). We do not recommend using cloudServiceCidr.
Default is none.

.PARAMETER proxySettings
A ProxySettings object created using the New-AksHciProxySetting cmdlet.

.PARAMETER sshPublicKey
Path to an SSH public key file. Using this public key, you will be able to log in to any of the VMs created by
the Azure Kubernetes Service on Azure Stack HCI deployment. If you have your own SSH public key, you will pass
its location here. If no key is provided, we will look for one under %systemdrive%\akshci\.ssh\akshci_rsa.pub.
If the file does not exist, an SSH key pair in the above location will be generated and used.

.PARAMETER skipHostLimitChecks
Requests the script to skip any checks it does to confirm memory and disk space is available before allowing the
deployment to proceed. We do not recommend using this setting.

.PARAMETER skipRemotingChecks
Requests the script to skip any checks it does to confirm remoting capabilities to both local and remote nodes.
We do not recommend using this setting.

.PARAMETER insecure
Deploys Azure Kubernetes Service on Azure Stack HCI components such as cloud agent and node agent(s) in insecure
mode (no TLS secured connections). We do not recommend using insecure mode in production environments.

.PARAMETER forceDnsReplication
DNS replication can take up to an hour on some systems. This will cause the deployment to be slow. To bypass this
issue, try to use this flag. The -forceDnsReplication flag is not a guaranteed fix. If the logic behind the flag
fails, the error will be hidden, and the command will carry on as if the flag was not provided.

.PARAMETER macPoolStart
This is used to specify the start of the MAC address of the MAC pool that you wish to use for the Azure Kubernetes
Service host VM. The syntax for the MAC address requires that the least significant bit of the first byte should
always be 0, and the first byte should always be an even number (that is, 00, 02, 04, 06...). A typical MAC address
can look like: 02:1E:2B:78:00:00. Use MAC pools for long-lived deployments so that MAC addresses assigned are
consistent. This is useful if you have a requirement that the VMs have specific MAC addresses. Default is none.

.PARAMETER macPoolEnd
This is used to specify the end of the MAC address of the MAC pool that you wish to use for the Azure Kubernetes
Service host VM. The syntax for the MAC address requires that the least significant bit of the first byte should
always be 0, and the first byte should always be an even number (that is, 00, 02, 04, 06...). The first byte of
the address passed as the -macPoolEnd should be the same as the first byte of the address passed as the
-macPoolStart. Use MAC pools for long-lived deployments so that MAC addresses assigned are consistent. This is
useful if you have a requirement that the VMs have specific MAC addresses. Default is none.

.PARAMETER useStagingShare
Reserved for internal use. We do not recommend using this parameter.

.PARAMETER containerRegistry
Reserved for internal use. We do not recommend using this parameter.

.PARAMETER catalog
Reserved for internal use. We do not recommend using this parameter.

.PARAMETER ring
Reserved for internal use. We do not recommend using this parameter.

.PARAMETER deploymentId
Reserved for internal use. We do not recommend using this parameter.

.PARAMETER skipUpdates
Reserved for internal use. We do not recommend using this parameter.

.PARAMETER stagingShare
Reserved for internal use. We do not recommend using this parameter.

.PARAMETER kvaSkipWaitForBootstrap
Reserved for internal use. We do not recommend using this parameter.

.PARAMETER deploymentType
Reserved for internal use. We do not recommend using this parameter.

.PARAMETER activity
Reserved for internal use. We do not recommend using this parameter.

.PARAMETER enablePreview
Enable AKS HCI Early Access Preview feature on Azure.

.PARAMETER skipCleanOnFailure
Skip auto cleanup on installation failure

.PARAMETER caCertRotationThreshold
Threshold days on certificate expiry on when cloudagent CA certificte should be rotated

.PARAMETER concurrentDownloads
How many parts to segment content downloads into (causes concurrent connections to the hosting server) for the big binaries.

.PARAMETER vipPool
The global vipPool to use.

.PARAMETER offlineDownload
For setting to offline download scenario.

.PARAMETER offsiteTransferCompleted
For offline download offsite scenario to use the offline downloaded artifacts.

.PARAMETER enableOptionalDiagnosticData
Send information about how you use features, plus additional information about service health, activity, and enhanced error reporting.
Diagnostic data is used to help keep the service secure and up to date, troubleshoot problems, and make product improvements.
Required diagnostic data will always be included when you choose to send Optional diagnostic data.
Regardless of your choice, the service will be equally secure and operate normally.

.PARAMETER skipValidationCheck
Skips running validation checks if the flag is passed
#>

[CmdletBinding(DefaultParametersetName='None')]
param(
[parameter(DontShow)]
[String]$activity=$MyInvocation.MyCommand.Name,

[parameter()]
# [ValidateScript({Test-ValidDirectoryPath -dirPath $_})]
[String]$workingDir=$global:defaultWorkingDir,

[parameter()]
# [ValidateScript({Test-ValidDirectoryPath -dirPath $_})]
[String]$imageDir,

[parameter()]
# [ValidateScript({Test-ValidVersionNumber -VersionNumber $_})]
[String]$version,

[parameter()]
[String]$stagingShare=$global:defaultStagingShare,

[parameter()]
# [ValidateScript({Test-ValidDirectoryPath -dirPath $_})]
[String]$cloudConfigLocation=$global:defaultCloudConfigLocation,

[parameter()]
# [ValidateScript({Test-ValidDirectoryPath -dirPath $_})]
[String]$nodeConfigLocation=$global:defaultNodeConfigLocation,

[parameter()]
[String]$cloudLocation=$global:defaultCloudLocation,

[parameter()]
[ValidateSet($true,$false)]
[bool]$createAutoConfigContainers=$global:defaultCreateAutoConfigContainers,

[Parameter(Mandatory=$true)]
[VirtualNetwork]$vnet,

[parameter()]
[SSHConfiguration]$ssh,

[parameter()]
[VmSize]$controlplaneVmSize=$global:defaultMgmtControlPlaneVmSize,

[parameter(DontShow)]
[String]$kvaName=(New-Guid).Guid,

[parameter()]
[String]$kvaPodCIDR=$global:defaultPodCidr,

[parameter(DontShow)]
[Switch]$kvaSkipWaitForBootstrap,

[parameter()]
[ValidateRange(1,65535)]
[int]$nodeAgentPort=$global:defaultNodeAgentPort,

[parameter()]
[ValidateRange(1,65535)]
[int]$nodeAgentAuthorizerPort=$global:defaultNodeAuthorizerPort,

[parameter()]
[ValidateRange(1,65535)]
[int]$cloudAgentPort=$global:defaultCloudAgentPort,

[parameter()]
[ValidateRange(1,65535)]
[int]$cloudAgentAuthorizerPort=$global:defaultCloudAuthorizerPort,

[parameter()]
# [ValidateScript({Test-ValidClusterName -name $_})]
[String]$clusterRoleName,

[parameter()]
# [ValidateScript({
# $isValidIpv4 = Validate-IPV4Address -ip $_
# if (!$isValidIpv4 -and (-not ($_ -cmatch $regexPatternCidrFormat))){
# throw $([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture, $GenericLocMessage.comm_invalid_ipv4_address, $_))
# }
# return $true
# })]
[Alias("cloudServiceCidr")]
[String]$cloudServiceIP="",

[parameter()]
[ProxySettings]$proxySettings=$null,

[parameter()]
[String]$sshPublicKey,

[parameter(DontShow)]
[Switch]$skipUpdates,

[parameter(DontShow)]
[Switch]$skipHostLimitChecks,

[parameter(DontShow)]
[Switch]$skipRemotingChecks,

[parameter(DontShow)]
[Switch]$insecure,

[parameter(DontShow)]
[Switch]$forceDnsReplication,

[parameter()]
# [ValidateScript({Test-ValidMacPoolAddress -macPoolAddress $_})]
[String]$macPoolStart,

[parameter()]
# [ValidateScript({Test-ValidMacPoolAddress -macPoolAddress $_})]
[String]$macPoolEnd,

[parameter(DontShow)]
[switch]$useStagingShare,

[parameter(DontShow)]
[ContainerRegistry]$containerRegistry=$null,

[parameter(DontShow)]
[String]$catalog=$script:catalogName,

[parameter(DontShow)]
[String]$ring=$script:ringName,

[parameter(DontShow)]
[String]$deploymentId=[Guid]::NewGuid().ToString(),

[parameter(DontShow)]
[int]$operatorTokenValidity=$global:operatorTokenValidity,

[parameter(DontShow)]
[int]$addonTokenValidity=$global:addonTokenValidity,

[parameter(DontShow)]
[float]$certificateValidityFactor=$global:certificateValidityFactor,

[Parameter(Mandatory=$true,ParameterSetName='networkcontroller')]
[Switch]$useNetworkController,

[Parameter(Mandatory=$true,ParameterSetName='networkcontroller')]
[string]$networkControllerFqdnOrIpAddress,

[Parameter(Mandatory=$false,ParameterSetName='networkcontroller')]
[string]$networkControllerClientCertificateName,

[Parameter(Mandatory=$true,ParameterSetName='networkcontroller')]
[string]$networkControllerLbSubnetRef,

[Parameter(Mandatory=$true,ParameterSetName='networkcontroller')]
[string]$networkControllerLnetRef,

[parameter(DontShow)]
[float]$caCertificateValidityFactor=$global:caCertificateValidityFactor,

[parameter(DontShow)]
[Switch]$enablePreview,

[parameter(DontShow)]
[Switch]$skipCleanOnFailure,

[parameter(DontShow)]
[float]$nodeCertificateValidityFactor=$global:nodeCertificateValidityFactor,

[parameter(DontShow)]
[int]$caCertRotationThreshold=$global:caCertRotationThreshold,

[Parameter(Mandatory=$false)]
[Int]$concurrentDownloads=10,

[Parameter(Mandatory=$false)]
[VipPoolSettings]$vipPool,

[Parameter()]
[ValidateSet($true,$false)]
[bool]$offlineDownload=$false,

[Parameter()]
[bool]$offsiteTransferCompleted=$false,

[Parameter()]
[Switch]$skipValidationCheck
)

$startCmdletTime=Get-Date

$configCmdletParams=@{version=$version;proxySettings=$proxySettings;catalog=$catalog;ring=$ring;moduleName=$moduleName;kvaName=$kvaName;enablePreview=$enablePreview;offlineDownload=$offlineDownload}

trap
{
$tc=Get-DefaultTraceConfigDetails-catalog$catalog-ring$ring-deploymentId$deploymentId
Trace-CmdletError-ErrorMessage$_`
-ConfigDetails$tc`
-StartCmdletTime$startCmdletTime`
-CmdletParameters$configCmdletParams
throw$_
}

Confirm-Configuration`
-useStagingShare:$useStagingShare.IsPresent-stagingShare$stagingShare-vnet$vnet-vipPool$vipPool-useNetworkController:$useNetworkController.IsPresent

Set-ProxyConfiguration-proxySettings$proxySettings-moduleName$moduleName

if($enablePreview.IsPresent)
{
$catalog="aks-hci-stable-catalogs-ext"
$ring="earlyaccesspreview"
}

if($sshPublicKey)
{
throw$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$GenericLocMessage.akshci_depricated_parameter_please_use,"sshPublicKey","ssh"))
}

# Optional diagnostic data is forced off until we meed privacy requirements to allow post-install changes to consent
$diagnosticConfigValue=$false
Set-AksHciConfigValue-name"enableOptionalDiagnosticData"-value$diagnosticConfigValue

# Normalizing directory path
$workingDir=Update-DirectoryPath-directoryPath$workingDir
$imageDir=Update-DirectoryPath-directoryPath$imageDir
$stagingShare=Update-DirectoryPath-directoryPath$stagingShare
$cloudConfigLocation=Update-DirectoryPath-directoryPath$cloudConfigLocation
$nodeConfigLocation=Update-DirectoryPath-directoryPath$nodeConfigLocation

try{
$currentMocState=Get-InstallState-module$global:MocModule
if($currentMocState-eq[InstallState]::NotInstalled){
Set-MocConfig-activity$activity-workingDir$workingDir-imageDir$imageDir-stagingShare$stagingShare`
-cloudConfigLocation$cloudConfigLocation-nodeConfigLocation$nodeConfigLocation`
-vnet$vnet-cloudLocation$cloudLocation`
-nodeAgentPort$nodeAgentPort-nodeAgentAuthorizerPort$nodeAgentAuthorizerPort`
-cloudAgentPort$cloudAgentPort-cloudAgentAuthorizerPort$cloudAgentAuthorizerPort-version$version`
-clusterRoleName$clusterRoleName-cloudServiceIP$cloudServiceIP-skipUpdates:$skipUpdates.IsPresent`
-skipHostLimitChecks:$skipHostLimitChecks.IsPresent-insecure:$insecure.IsPresent`
-forceDnsReplication:$forceDnsReplication.IsPresent`
-useStagingShare:$useStagingShare.IsPresent-macPoolStart$macPoolStart-macPoolEnd$macPoolEnd`
-sshPublicKey$sshPublicKey-ssh$ssh-skipRemotingChecks:$skipRemotingChecks.IsPresent`
-proxySettings$proxySettings-catalog$catalog-ring$ring-createAutoConfigContainers$createAutoConfigContainers`
-deploymentId$deploymentId-certificateValidityFactor$certificateValidityFactor`
-nodeCertificateValidityFactor$nodeCertificateValidityFactor-caCertificateValidityFactor$caCertificateValidityFactor`
-useNetWorkController:$useNetWorkController.IsPresent`
-networkControllerFqdnOrIpAddress$networkControllerFqdnOrIpAddress`
-networkControllerLbSubnetRef$networkControllerLbSubnetRef`
-networkControllerLnetRef$networkControllerLnetRef`
-networkControllerClientCertificateName$networkControllerClientCertificateName`
-vipPool$vipPool-skipValidationCheck:$skipValidationCheck.IsPresent`
-offlineDownload$offlineDownload-offsiteTransferCompleted$offsiteTransferCompleted

# Install pre-requisites
# Incase of offline download, download the bits here. Bits are needed to install moc
if($offlineDownload){
Write-Host$AksHciLocMessage.akshci_wait_for_offline_download
Set-AksHciConfigValue-name"manifestCache"-value([io.Path]::Combine($workingDir,$("$catalog.json")))
Set-AksHciConfigValue-name"stagingShare"-value$stagingShare
Set-AksHciConfigValue-name"catalog"-value$catalog
Set-AksHciConfigValue-name"ring"-value$ring
Set-AKsHciConfigValue-name"offlineDownload"-value$offlineDownload

if(-not$version)
{
$version=Get-ConfigurationValue-Name"version"-module$moduleName
if(-not$version)
{
# If no version is specified, use the latest
$version=Get-AksHciLatestVersion
Set-AksHciConfigValue-name"version"-value$version
}
}
else
{
Get-AksHciLatestVersion|out-null# This clears the cache
Get-ProductRelease-Version$version-module$moduleName|Out-Null
Set-AksHciConfigValue-name"version"-value$version
}
try{
Get-AksHciRelease
$offsiteTransferCompleted=$true
}catch{
Write-SubStatus-moduleName$moduleName-msg$_.Exception.Message.ToString()
throw$_
}
}

Write-Host$AksHciLocMessage.akshci_wait_for_prerequisites
$installingMoc=$true
Install-Moc-activity$activity
}

Set-KvaConfig-activity$activity-workingDir$workingDir-imageDir$imageDir-stagingShare$stagingShare`
-kvaName$kvaName-kvaPodCIDR$kvaPodCIDR-kvaSkipWaitForBootstrap:$kvaSkipWaitForBootstrap.IsPresent`
-controlplaneVmSize$controlplaneVmSize`
-vnet$vnet-cloudLocation$cloudLocation`
-skipUpdates:$skipUpdates.IsPresent-insecure:$insecure.IsPresent`
-useStagingShare:$useStagingShare.IsPresent-version$version-macPoolStart$macPoolStart-macPoolEnd$macPoolEnd`
-proxySettings$proxySettings-containerRegistry:$containerRegistry`
-catalog$catalog-ring$ring`
-cloudAgentPort$cloudAgentPort-cloudAgentAuthorizerPort$cloudAgentAuthorizerPort`
-deploymentId$deploymentId-operatorTokenValidity$operatorTokenValidity-addonTokenValidity$addonTokenValidity`
-concurrentDownloads$concurrentDownloads`
-offlineDownload$offlineDownload-offsiteTransferCompleted$offsiteTransferCompleted-skipValidationCheck:$skipValidationCheck.IsPresent`
-enableOptionalDiagnosticData$diagnosticConfigValue

Write-StatusWithProgress-activity$activity-moduleName$moduleName-status$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_creating_config,$moduleName))

Set-AksHciConfigValue-name"workingDir"-value$workingDir
Set-AksHciConfigValue-name"manifestCache"-value([io.Path]::Combine($workingDir,$("$catalog.json")))
New-Item-ItemTypeDirectory-Force-Path$workingDir|out-null

Set-AksHciConfigValue-name"moduleVersion"-value$moduleVersion
Set-AksHciConfigValue-name"installState"-value([InstallState]::NotInstalled)
Set-AksHciConfigValue-name"stagingShare"-value$stagingShare
Set-AksHciConfigValue-name"skipUpdates"-value$skipUpdates.IsPresent
Set-AksHciConfigValue-name"useStagingShare"-value$useStagingShare.IsPresent
Set-AksHciConfigValue-name"catalog"-value$catalog
Set-AksHciConfigValue-name"ring"-value$ring
Set-AKsHciConfigValue-name"deploymentId"-value$deploymentId
Set-AksHciConfigValue-name"skipCleanOnFailure"-value$skipCleanOnFailure.IsPresent
Set-AKsHciConfigValue-name"caCertRotationThreshold"-value$caCertRotationThreshold
Set-AKsHciConfigValue-name"offlineDownload"-value$offlineDownload
Set-AksHciConfigValue-name"offsiteTransferCompleted"-value$offsiteTransferCompleted

if(-not$version)
{
$version=Get-ConfigurationValue-Name"version"-module$moduleName
if(-not$version)
{
# If no version is specified, use the latest
$version=Get-AksHciLatestVersion
Set-AksHciConfigValue-name"version"-value$version
}
}
else
{
Get-AksHciLatestVersion|out-null# This clears the cache
Get-ProductRelease-Version$version-module$moduleName|Out-Null
Set-AksHciConfigValue-name"version"-value$version
}

$commands=Get-ConfigurationValue-Name"commands"-module$moduleName
if(-not$commands)
{
# If no commands are found, initialize with current command
$currentCommand=[Command]::new($activity,[System.Diagnostics.Process]::GetCurrentProcess().Id,$(hostname),$(get-date))
$commands=@($currentCommand)
Set-AksHciConfigValue-name"commands"-value$commands
}

Test-ModuleCompatibility-Version$version|Out-Null

#Failing the call if Currently Installed PS module Version is less than Minimum supported PS version
$productRelease=Get-ProductRelease-version$version-module$moduleName
if($productRelease.CustomData.MinSupportedPSVersion){
$MinPSVersion=$productRelease.CustomData.MinSupportedPSVersion
if([version]$moduleVersion-lt[version]$MinPSVersion){
throw[CustomException]::new(($([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_incompatible_PS_module_version,$MinPSVersion))),([ErrorTypes]::IsUserErrorFlag))
}
}

$installationPackageDir=[io.Path]::Combine($workingDir,$version)
Set-AksHciConfigValue-name"installationPackageDir"-value$installationPackageDir
New-Item-ItemTypeDirectory-Force-Path$installationPackageDir|Out-Null
Save-ConfigurationDirectory-moduleName$moduleName-WorkingDir$workingDir
Save-Configuration-moduleName$moduleName
Write-SubStatus-moduleName$moduleName$($AksHciLocMessage.akshci_saved_config)

# Pushing the configuration to telemetry
$configCmdletParams+=@{
config=Get-AksHciConfig;
}

Uninitialize-AksHciEnvironment-activity$activity

Trace-Cmdlet-ConfigDetails$(Get-TraceConfigDetails)`
-StartCmdletTime$startCmdletTime`
-CmdletParameters$configCmdletParams
}
catch{
Write-SubStatus-moduleName$moduleName-msg$_.Exception.Message.ToString()
if($installingMoc){
Uninstall-Moc-activity$activity
}
throw$_
}
}

functionSet-AksHciConfigValue
{
<#
.DESCRIPTION
Persists a configuration value to the registry

.PARAMETER name
Name of the configuration value

.PARAMETER value
Value to be persisted
#>

param(
[String]$name,
[Object]$value
)

Set-ConfigurationValue-name$name-value$value-module$moduleName
}

functionGet-AksHciConfigValue
{
<#
.DESCRIPTION
Persists a configuration value to the registry

.PARAMETER name
Name of the configuration value
#>

param(
[String]$name
)

returnGet-ConfigurationValue-name$name-module$moduleName
}

functionGet-AksHciConfig
{
<#
.SYNOPSIS
List the current configuration settings for the Azure Kubernetes Service host.

.DESCRIPTION
List the current configuration settings for the Azure Kubernetes Service host.

.PARAMETER activity
Activity name to use when updating progress
#>

[CmdletBinding()]
param(
[parameter(DontShow)]
[String]$activity=$MyInvocation.MyCommand.Name
)

$startCmdletTime=Get-Date
trap
{
Trace-CmdletError-ErrorMessage$_`
-CmdletParameters$PSBoundParameters`
-StartCmdletTime$startCmdletTime
throw$_
}

Import-AksHciConfig-activity$activity

Write-Status-moduleName$moduleName$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_get_config,$moduleName))
$global:config[$modulename]["installState"]=Get-InstallState-module$moduleName

Trace-Cmdlet-ConfigDetails$(Get-TraceConfigDetails)-StartCmdletTime$startCmdletTime
return$global:config
}

functionImport-AksHciConfig
{
<#
.DESCRIPTION
Loads a configuration from persisted storage. If no configuration is present
then a default configuration can be optionally generated and persisted.

.PARAMETER activity
Activity name to use when updating progress
#>

[CmdletBinding()]
param(
[parameter()]
[Switch]$createIfNotPresent,

[parameter(DontShow)]
[String]$activity=$MyInvocation.MyCommand.Name
)

Write-StatusWithProgress-activity$activity-module$moduleName-status$($AksHciLocMessage.akshci_import_config)

# Check if configuration exists
if(Test-Configuration-moduleName$moduleName)
{
# 1. Trigger an import of the dependent configurations
Get-MocConfig|Out-Null
Get-KvaConfig|Out-Null

Import-Configuration-moduleName$moduleName
}
else
{
throw[CustomException]::new(($([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$GenericLocMessage.generic_cannot_deploy,$moduleName))),([ErrorTypes]::IsUserErrorFlag))
}
Write-StatusWithProgress-activity$activity-module$moduleName-status$($AksHciLocMessage.akshci_import_config_complete)
}

functionInstall-AksHci
{
<#
.SYNOPSIS
Install the Azure Kubernetes Service on Azure Stack HCI agents/services and host.

.DESCRIPTION
Install the Azure Kubernetes Service on Azure Stack HCI agents/services and host.

.PARAMETER AsJob
Execute asynchronously as a background job

.PARAMETER activity
Activity name to use when updating progress
#>

[CmdletBinding()]
param(
[Parameter()]
[Switch]$AsJob,

[parameter(DontShow)]
[String]$activity=$MyInvocation.MyCommand.Name
)

$activity=$MyInvocation.MyCommand.Name
$startCmdletTime=Get-Date
trap
{
Write-ModuleEventLog-moduleName$moduleName-entryTypeError-eventId100-message"$activity - $_"
Trace-CmdletError-ConfigDetails$(Get-TraceConfigDetails)`
-StartCmdletTime$startCmdletTime`
-ErrorMessage$_
Uninitialize-AksHciEnvironment-activity$activity
if($ErrorActionPreference-ne[System.Management.Automation.ActionPreference]::SilentlyContinue){
throw$_
}
}

if($AsJob)
{
returnNew-BackgroundJob-name$activity-cmdletName$MyInvocation.MyCommand.Name-argDictionary$PSBoundParameters
}

Initialize-AksHciEnvironment-createConfigIfNotPresent-skipMgmtKubeConfig-skipInstallationCheck-activity$activity

Test-KvaAzureConnection

Install-AksHciInternal-activity$activity

Write-StatusWithProgress-activity$activity-moduleName$moduleName-status$($GenericLocMessage.generic_done)-completed

Uninitialize-AksHciEnvironment-activity$activity

Trace-Cmdlet-ConfigDetails$(Get-TraceConfigDetails)-StartCmdletTime$startCmdletTime
}

functionEnable-AksHciPreview
{
<#
.SYNOPSIS
Enable AKSHCI catalog and ring configuration to expose early access preview builds.

.DESCRIPTION
Enable AKSHCI catalog and ring configuration to expose early access preview builds.

.PARAMETER activity
Activity name to use when updating progress

.PARAMETER catalog
Release catalog for AKS HCI. Reserved for internal use. We do not recommend using this parameter.

.PARAMETER ring
Audience (aka ring) type of each catalog. Reserved for internal use. We do not recommend using this parameter.
#>

[CmdletBinding()]
param(
[parameter(DontShow)]
[String]$activity=$MyInvocation.MyCommand.Name,

[parameter(DontShow)]
[String]$catalog="aks-hci-stable-catalogs-ext",

[parameter(DontShow)]
[String]$ring="earlyaccesspreview"

)

$activity=$MyInvocation.MyCommand.Name
$startCmdletTime=Get-Date
trap
{
Write-ModuleEventLog-moduleName$moduleName-entryTypeError-eventId100-message"$activity - $_"
Trace-CmdletError-ConfigDetails$(Get-TraceConfigDetails)`
-ErrorMessage$_`
-StartCmdletTime$startCmdletTime`
-CmdletParameters$PSBoundParameters
Uninitialize-AksHciEnvironment-activity$activity
if($ErrorActionPreference-ne[System.Management.Automation.ActionPreference]::SilentlyContinue){throw$_}
}

Initialize-AksHciEnvironment-activity$activity

#Set MocConfig for early access preview
Enable-MocPreview-catalog$catalog-ring$ring

#Set KvaConfig for early access preview
Enable-KvaPreview-catalog$catalog-ring$ring

#Set AksHCiConfig for early access preview
Write-StatusWithProgress-activity$activity-moduleName$moduleName-status$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_enable_preview,$moduleName))

Set-AksHciConfigValue-name"catalog"-value$catalog
Set-AksHciConfigValue-name"ring"-value$ring
Write-SubStatus-moduleName$moduleName$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_preview_config,$moduleName))
Write-StatusWithProgress-activity$activity-status$($GenericLocMessage.generic_done)-completed-moduleName$moduleName

Write-Warning$($AksHciLocMessage.akshci_preview_warning)

Uninitialize-AksHciEnvironment-activity$activity

Trace-Cmdlet-ConfigDetails$(Get-TraceConfigDetails)-CmdletParameters$PSBoundParameters-StartCmdletTime$startCmdletTime
}

functionDisable-AksHciPreview
{

<#
.SYNOPSIS
Disable AKSHCI catalog and ring configuration which exposes early access preview builds and revert to a stable build.

.DESCRIPTION
Disable AKSHCI catalog and ring configuration which exposes early access preview builds and revert to a stable build.

.PARAMETER activity
Activity name to use when updating progress.

.PARAMETER catalog
Release catalog for AKS HCI. Reserved for internal use. We do not recommend using this parameter.

.PARAMETER ring
Audience (aka ring) type of each catalog. Reserved for internal use. We do not recommend using this parameter.
#>

[CmdletBinding()]
param(
[parameter(DontShow)]
[String]$activity=$MyInvocation.MyCommand.Name,

[parameter(DontShow)]
[String]$catalog="aks-hci-stable-catalogs-ext",

[parameter(DontShow)]
[String]$ring="stable"
)

$activity=$MyInvocation.MyCommand.Name
$startCmdletTime=Get-Date
trap
{
Write-ModuleEventLog-moduleName$moduleName-entryTypeError-eventId100-message"$activity - $_"
Trace-CmdletError-ConfigDetails$(Get-TraceConfigDetails)`
-ErrorMessage$_`
-StartCmdletTime$startCmdletTime`
-CmdletParameters$PSBoundParameters
Uninitialize-AksHciEnvironment-activity$activity
if($ErrorActionPreference-ne[System.Management.Automation.ActionPreference]::SilentlyContinue){throw$_}
}

Initialize-AksHciEnvironment-activity$activity

#Set MocConfig
Disable-MocPreview-catalog$catalog-ring$ring

#Set KvaConfig
Disable-KvaPreview-catalog$catalog-ring$ring

#Set AksHCiConfig
Write-StatusWithProgress-activity$activity-moduleName$moduleName-status$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_preview_disable,$moduleName))
Set-AksHciConfigValue-name"catalog"-value$catalog
Set-AksHciConfigValue-name"ring"-value$ring
Write-SubStatus-moduleName$moduleName$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_config_update,$moduleName))
Write-StatusWithProgress-activity$activity-status$($GenericLocMessage.generic_done)-completed-moduleName$moduleName

Uninitialize-AksHciEnvironment-activity$activity

Trace-Cmdlet-ConfigDetails$(Get-TraceConfigDetails)-CmdletParameters$PSBoundParameters-StartCmdletTime$startCmdletTime

}

functionRestart-AksHci
{
<#
.SYNOPSIS
Restart Azure Kubernetes Service on Azure Stack HCI and remove all deployed Kubernetes clusters.

.DESCRIPTION
Restarting Azure Kubernetes Service on Azure Stack HCI will remove all of your Kubernetes clusters
if any, and the Azure Kubernetes Service host. It will also uninstall the Azure Kubernetes Service on
Azure Stack HCI agents and services from the nodes. It will then go back through the original install
process steps until the host is recreated. The Azure Kubernetes Service on Azure Stack HCI configuration
that you configured via Set-AksHciConfig and the downloaded VHDX images are preserved.

.PARAMETER activity
Activity name to use when updating progress
#>

[CmdletBinding(PositionalBinding=$False,SupportsShouldProcess,ConfirmImpact='High')]
param(
[parameter(DontShow)]
[String]$activity=$MyInvocation.MyCommand.Name
)

Write-Warning$($AksHciLocMessage.akshci_restart_userprompt_warning)
$startCmdletTime=Get-Date

trap
{
Write-ModuleEventLog-moduleName$moduleName-entryTypeError-eventId100-message"$activity - $_"
Trace-CmdletError-ConfigDetails$(Get-TraceConfigDetails)`
-StartCmdletTime$startCmdletTime`
-ErrorMessage$_
Uninitialize-AksHciEnvironment-activity$activity
if($ErrorActionPreference-ne[System.Management.Automation.ActionPreference]::SilentlyContinue){
throw$_
}
}

if(-not$PSCmdlet.ShouldProcess("Azure Stack HCI deployment","Restart-AksHci"))
{
Write-Warning$($AksHciLocMessage.akshci_restart_abort_warning)
return
}

Initialize-AksHciEnvironment-skipMgmtKubeConfig-activity$activity-skipInstallationCheck

Uninstall-AksHci-SkipConfigCleanup-activity$activity

Install-Moc-activity$activity

Install-AksHciInternal-activity$activity

Uninitialize-AksHciEnvironment-activity$activity

Write-StatusWithProgress-activity$activity-moduleName$moduleName-status$($GenericLocMessage.generic_done)-completed

Trace-Cmdlet-ConfigDetails$(Get-TraceConfigDetails)-StartCmdletTime$startCmdletTime
}

functionUninstall-AksHci
{
<#
.SYNOPSIS
Removes Azure Kubernetes Service on Azure Stack HCI.

.DESCRIPTION
Removes Azure Kubernetes Service on Azure Stack HCI. If PowerShell commands are run on a cluster
where Windows Admin Center was previously used to deploy, the PowerShell module checks the existence
of the Windows Admin Center configuration file. Windows Admin Center places the Windows Admin Center configuration file across all nodes.

.PARAMETER SkipConfigCleanup
skips removal of the configurations after uninstall.
After Uninstall, you have to Set-AksHciConfig to install again.

.PARAMETER activity
Activity name to use when updating progress
#>

[CmdletBinding(PositionalBinding=$False,SupportsShouldProcess,ConfirmImpact='High')]
param(
[Parameter()]
[Switch]$SkipConfigCleanup,

[parameter(DontShow)]
[String]$activity=$MyInvocation.MyCommand.Name
)

Write-Warning$($AksHciLocMessage.akshci_uninstall_userprompt_warning)
$startCmdletTime=Get-Date

trap
{
Trace-CmdletError-ConfigDetails$(Get-TraceConfigDetails)`
-StartCmdletTime$startCmdletTime`
-ErrorMessage$_
Uninitialize-AksHciEnvironment-activity$activity
throw$_
}

if(-not$PSCmdlet.ShouldProcess("Azure Stack HCI deployment","Uninstall-AksHci"))
{
Write-Warning$($AksHciLocMessage.akshci_uninstall_abort_warning)
return
}

$isAksHciInstalling=$false
try
{
Initialize-AksHciEnvironment-skipMgmtKubeConfig-activity$activity

$installAksHciCommand="Install-AksHci"
$isAksHciInstalling=Test-Command-Runnable-currentCommand$activity`
-cannotRunWithInstallStateInstalling`
-cannotRunWithCommand$installAksHciCommand
if($isAksHciInstalling){
throw[CustomException]::new($([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$GenericLocMessage.generic_install_in_progress,$moduleName)),([ErrorTypes]::IsUserErrorFlag))
}

$configDetails=Get-TraceConfigDetails

$aksHciRegistration=Get-AksHciRegistration
if(-not[string]::IsNullOrWhiteSpace($aksHciRegistration.azureResourceGroup))
{
try
{
Test-KvaAzureConnection
}
catch[Exception]
{
Write-SubStatus-moduleName$moduleName$($AksHciLocMessage.akshci_azure_connection_warning)
}
}

Set-AksHciConfigValue-name"installState"-value([InstallState]::Uninstalling)
try
{
$clusters=Get-AksHciCluster
foreach($clusterin$clusters)
{
try
{
Remove-AksHciCluster-Name$cluster.Name-Confirm:$false
}
catch[Exception]
{
Write-Status-moduleName$moduleName-msg$($GenericLocMessage.generic_exception)
Write-SubStatus-moduleName$moduleName-msg$_.Exception.Message.ToString()
Write-SubStatus-moduleName$moduleName-msg$([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$AksHciLocMessage.akshci_cannot_delete_target_cluster,$moduleName))
}
}
}
catch[Exception]
{
Write-ModuleEventLog-moduleName$moduleName-entryTypeError-eventId100-message"$activity - $_"
}
}
catch[Exception]
{
if($isAksHciInstalling){
throw[CustomException]::new($([System.String]::Format([System.Globalization.CultureInfo]::InvariantCulture,$GenericLocMessage.generic_install_in_progress,$moduleName)),([ErrorTypes]::IsUserErrorFlag))
}
# If AksHci is not installed, you would reach here
Write-ModuleEventLog-moduleName$moduleName-entryTypeWarning-eventId2-message"$activity - $_"
}

try
{
Uninstall-Kva-SkipConfigCleanup:$SkipConfigCleanup.IsPresent-activity$activity
}
catch[Exception]
{
Write-ModuleEventLog-moduleName$moduleName-entryTypeError-eventId100-message"$activity - $_"
}
#ConfigMap details are not available after kva is uninstalled

try
{
Uninstall-Moc-SkipConfigCleanup:$SkipConfigCleanup.IsPresent-activity$activity
}
catch[Exception]
{
Write-ModuleEventLog-moduleName$moduleName-entryTypeError-eventId100-message"$activity - $_"
}

Trace-Cmdlet-ConfigDetails$configDetails-StartCmdletTime$startCmdletTime

Set-AksHciConfigValue-name"installState"-value([InstallState]::NotInstalled)
Uninitialize-AksHciEnvironment-activity$activity

if(!$SkipConfigCleanup.IsPresent)
{
Reset-Configuration-moduleName$moduleName
}
Write-StatusWithProgress-activity$activity-moduleName$moduleName-status$($GenericLocMessage.generic_done)-completed
}

functionGet-AksHciKubernetesVersion
{
<#
.SYNOPSIS
List the available versions for creating a managed Kubernetes cluster.

.DESCRIPTION
List the available versions for creating a managed Kubernetes cluster.

.PARAMETER activity
Activity name to use when updating progress
#>

[CmdletBinding()]
param(
[parameter(DontShow)]
[String]$activity=$MyInvocation.MyCommand.Name
)

$startCmdletTime=Get-Date
trap
{
Write-ModuleEventLog-moduleName$moduleName-entryTypeError-eventId100-message"$activity - $_"
Trace-CmdletError-ConfigDetails$(Get-TraceConfigDetails)`
-StartCmdletTime$startCmdletTime`
-ErrorMessage$_
if($ErrorActionPreference-ne[System.Management.Automation.ActionPreference]::SilentlyContinue){
throw$_
}
}

Write-StatusWithProgress-activity$activity-moduleName$moduleName-status$($AksHciLocMessage.akshci_kube_versions)

Get-AvailableKubernetesVersions-moduleName$moduleName

Write-StatusWithProgress-activity$activity-status$($GenericLocMessage.generic_done)-completed-moduleName$moduleName
Trace-Cmdlet-ConfigDetails$(Get-TraceConfigDetails)-StartCmdletTime$startCmdletTime
}

functionGet-AksHciVmSize
{
<#
.SYNOPSIS
Get the current Kubernetes version of Azure Kubernetes Service on Azure Stack HCI.

.DESCRIPTION
Get the current Kubernetes version of Azure Kubernetes Service on Azure Stack HCI.

.PARAMETER activity
Activity name to use when updating progress
#>

[CmdletBinding()]
param(
[parameter(DontShow)]
[String]$activity=$MyInvocation.MyCommand.Name
)

$startCmdletTime=Get-Date

trap
{
Write-ModuleEventLog-moduleName$moduleName-entryTypeError-eventId100-message"$activity - $_"
Trace-CmdletError-ConfigDetails$(Get-TraceConfigDetails)`
-CmdletParameters$PSBoundParameters`
-StartCmdletTime$startCmdletTime`
-ErrorMessage$_
if($ErrorActionPreference-ne[System.Management.Automation.ActionPreference]::SilentlyContinue){
throw$_}
}

Write-StatusWithProgress-activity$activity-moduleName$moduleName-status$($AksHciLocMessage.akshci_vm_size)

$result=@()

foreach($definitionin$global:vmSizeDefinitions)
{
$size=[ordered]@{'VmSize'=$definition[0];'CPU'=$definition[1];'MemoryGB'=$definition[2]}
$result+=New-Object-TypeNamePsObject-Property$size
}