Azurestack Aks admin commands

src/Azs.ContainerService.Admin/docs/Azs.ContainerService.Admin.md

@@ -0,0 +1,19 @@
+---
+Module Name: Azs.ContainerService.Admin
+Module Guid: ceb3fb10-8099-4398-b7a0-1b613eb62bc2
+Download Help Link: https://docs.microsoft.com/en-us/powershell/module/azs.containerservice.admin
+Help Version: 1.0.0.0
+Locale: en-US
+---
+
+# Azs.ContainerService.Admin Module
+## Description
+Microsoft AzureStack PowerShell: ContainerService Admin cmdlets
+
+## Azs.ContainerService.Admin Cmdlets
+### [Get-AzsContainerService](Get-AzsContainerService.md)
+Returns a list of managed clusters present in all tenant location.
+
+### [Get-AzsContainerServiceQuota](Get-AzsContainerServiceQuota.md)
+Returns a list of container service quotas at the given location.
+

src/Azs.ContainerService.Admin/docs/Get-AzsContainerService.md

@@ -0,0 +1,119 @@
+---
+external help file:
+Module Name: Azs.ContainerService.Admin
+online version: https://docs.microsoft.com/en-us/powershell/module/azs.containerservice.admin/get-azscontainerservice
+schema: 2.0.0
+---
+
+# Get-AzsContainerService
+
+## SYNOPSIS
+Returns a list of managed clusters present in all tenant location.
+
+## SYNTAX
+
+```
+Get-AzsContainerService [-Location <String>] [-SubscriptionId <String[]>] [-DefaultProfile <PSObject>]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+Returns a list of managed clusters present in all tenant location.
+
+## EXAMPLES
+
+### Example 1: Get list of managed clusters
+```powershell
+PS C:\> Get-AzsContainerService -Location "redmond" | ConvertTo-Json
+[
+  {
+    "CreationDate": "2021-08-24T21:33:46Z",
+    "Id": "/subscriptions/f9712d12-aa4d-4d37-8f46-fabf3c07c836/providers/Microsoft.ContainerService.Admin/locations/redmond/managedclusters/testaksux",
+    "Location": "redmond",
+    "Name": "redmond/testaksux",
+    "OrchestratorVersion": "1.19.11",
+    "PropertiesId": "/subscriptions/16661f04-6eca-4ccb-acef-3624fc128005/resourcegroups/testaksuxrg/providers/Microsoft.ContainerService/managedClusters/testaksux",
+    "PropertiesName": "testaksux",
+    "ProvisioningState": "Succeeded",
+    "SubscriptionId": "16661f04-6eca-4ccb-acef-3624fc128005",
+    "Type": "Microsoft.ContainerService.Admin/locations/managedclusters"
+  },
+  {
+    "CreationDate": "2021-08-25T20:02:38Z",
+    "Id": "/subscriptions/f9712d12-aa4d-4d37-8f46-fabf3c07c836/providers/Microsoft.ContainerService.Admin/locations/redmond/managedclusters/testaksaddon",
+    "Location": "redmond",
+    "Name": "redmond/testaksaddon",
+    "OrchestratorVersion": "1.19.11",
+    "PropertiesId": "/subscriptions/a174daa5-4b9c-4745-8d80-ca8a6c1e2279/resourcegroups/testaksaddonrg/providers/Microsoft.ContainerService/managedClusters/testaksaddon",
+    "PropertiesName": "testaksaddon",
+    "ProvisioningState": "Succeeded",
+    "SubscriptionId": "a174daa5-4b9c-4745-8d80-ca8a6c1e2279",
+    "Type": "Microsoft.ContainerService.Admin/locations/managedclusters"
+  }
+]
+```
+
+Returns a list of all tenant container service clusters.
+
+## PARAMETERS
+
+### -DefaultProfile
+The credentials, account, tenant, and subscription used for communication with Azure.
+
+```yaml
+Type: System.Management.Automation.PSObject
+Parameter Sets: (All)
+Aliases: AzureRMContext, AzureCredential
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Location
+The name of Azure region.
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: (Get-AzLocation)[0].Location
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SubscriptionId
+The ID of the target subscription.
+
+```yaml
+Type: System.String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: (Get-AzContext).Subscription.Id
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Microsoft.Azure.PowerShell.Cmdlets.ContainerServiceAdmin.Models.Api20191101.IContainerServicesListValueItem
+
+## NOTES
+
+ALIASES
+
+## RELATED LINKS
+

src/Azs.ContainerService.Admin/docs/Get-AzsContainerServiceQuota.md

@@ -0,0 +1,99 @@
+---
+external help file:
+Module Name: Azs.ContainerService.Admin
+online version: https://docs.microsoft.com/en-us/powershell/module/azs.containerservice.admin/get-azscontainerservicequota
+schema: 2.0.0
+---
+
+# Get-AzsContainerServiceQuota
+
+## SYNOPSIS
+Returns a list of container service quotas at the given location.
+
+## SYNTAX
+
+```
+Get-AzsContainerServiceQuota [-Location <String>] [-SubscriptionId <String[]>] [-DefaultProfile <PSObject>]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+Returns a list of container service quotas at the given location.
+
+## EXAMPLES
+
+### Example 1: Get Quota for Container Service
+```powershell
+PS C:\> Get-AzsContainerServiceQuota -Location "redmond" | ConvertTo-Json
+{
+  "Id": "/subscriptions/f9712d12-aa4d-4d37-8f46-fabf3c07c836/providers/Microsoft.ContainerService.Admin/locations/redmond/quotas/Unlimited",
+  "Name": "redmond/Unlimited",
+  "PropertiesName": "Unlimited",
+  "Type": "Microsoft.ContainerService.Admin/locations/quotas"
+}
+```
+
+Returns a quota for container service.
+
+## PARAMETERS
+
+### -DefaultProfile
+The credentials, account, tenant, and subscription used for communication with Azure.
+
+```yaml
+Type: System.Management.Automation.PSObject
+Parameter Sets: (All)
+Aliases: AzureRMContext, AzureCredential
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Location
+The name of Azure region.
+
+```yaml
+Type: System.String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: (Get-AzLocation)[0].Location
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SubscriptionId
+The ID of the target subscription.
+
+```yaml
+Type: System.String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: (Get-AzContext).Subscription.Id
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+## OUTPUTS
+
+### Microsoft.Azure.PowerShell.Cmdlets.ContainerServiceAdmin.Models.Api20191101.IContainerServiceQuotaListValueItem
+
+## NOTES
+
+ALIASES
+
+## RELATED LINKS
+

src/Azs.ContainerService.Admin/docs/readme.md

@@ -0,0 +1,11 @@
+# Docs
+This directory contains the documentation of the cmdlets for the `Azs.ContainerService.Admin` module. To run documentation generation, use the `generate-help.ps1` script at the root module folder. Files in this folder will *always be overriden on regeneration*. To update documentation examples, please use the `..\examples` folder.
+
+## Info
+- Modifiable: no
+- Generated: all
+- Committed: yes
+- Packaged: yes
+
+## Details
+The process of documentation generation loads `Azs.ContainerService.Admin` and analyzes the exported cmdlets from the module. It recognizes the [help comments](https://docs.microsoft.com/en-us/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/Azs.ContainerService.Admin/examples/Get-AzsContainerService.md

@@ -0,0 +1,32 @@
+### Example 1: Get list of managed clusters
+```powershell
+PS C:\> Get-AzsContainerService -Location "redmond" | ConvertTo-Json
+[
+  {
+    "CreationDate": "2021-08-24T21:33:46Z",
+    "Id": "/subscriptions/f9712d12-aa4d-4d37-8f46-fabf3c07c836/providers/Microsoft.ContainerService.Admin/locations/redmond/managedclusters/testaksux",
+    "Location": "redmond",
+    "Name": "redmond/testaksux",
+    "OrchestratorVersion": "1.19.11",
+    "PropertiesId": "/subscriptions/16661f04-6eca-4ccb-acef-3624fc128005/resourcegroups/testaksuxrg/providers/Microsoft.ContainerService/managedClusters/testaksux",
+    "PropertiesName": "testaksux",
+    "ProvisioningState": "Succeeded",
+    "SubscriptionId": "16661f04-6eca-4ccb-acef-3624fc128005",
+    "Type": "Microsoft.ContainerService.Admin/locations/managedclusters"
+  },
+  {
+    "CreationDate": "2021-08-25T20:02:38Z",
+    "Id": "/subscriptions/f9712d12-aa4d-4d37-8f46-fabf3c07c836/providers/Microsoft.ContainerService.Admin/locations/redmond/managedclusters/testaksaddon",
+    "Location": "redmond",
+    "Name": "redmond/testaksaddon",
+    "OrchestratorVersion": "1.19.11",
+    "PropertiesId": "/subscriptions/a174daa5-4b9c-4745-8d80-ca8a6c1e2279/resourcegroups/testaksaddonrg/providers/Microsoft.ContainerService/managedClusters/testaksaddon",
+    "PropertiesName": "testaksaddon",
+    "ProvisioningState": "Succeeded",
+    "SubscriptionId": "a174daa5-4b9c-4745-8d80-ca8a6c1e2279",
+    "Type": "Microsoft.ContainerService.Admin/locations/managedclusters"
+  }
+]
+```
+
+Returns a list of all tenant container service clusters

src/Azs.ContainerService.Admin/examples/Get-AzsContainerServiceQuota.md

@@ -0,0 +1,12 @@
+### Example 1: Get Quota for Container Service
+```powershell
+PS C:\> Get-AzsContainerServiceQuota -Location "redmond" | ConvertTo-Json
+{
+  "Id": "/subscriptions/f9712d12-aa4d-4d37-8f46-fabf3c07c836/providers/Microsoft.ContainerService.Admin/locations/redmond/quotas/Unlimited",
+  "Name": "redmond/Unlimited",
+  "PropertiesName": "Unlimited",
+  "Type": "Microsoft.ContainerService.Admin/locations/quotas"
+}
+```
+
+Returns a quota for container service

src/Azs.ContainerService.Admin/readme.md

@@ -0,0 +1,92 @@
+<!-- region Generated -->
+# Azs.ContainerService.Admin
+This directory contains the PowerShell module for the ContainerServiceAdmin service.
+
+---
+## Status
+[![Azs.ContainerService.Admin](https://img.shields.io/powershellgallery/v/Azs.ContainerService.Admin.svg?style=flat-square&label=Azs.ContainerService.Admin "Azs.ContainerService.Admin")](https://www.powershellgallery.com/packages/Azs.ContainerService.Admin/)
+
+## Info
+- Modifiable: yes
+- Generated: all
+- Committed: yes
+- Packaged: yes
+
+---
+## Detail
+This module was primarily generated via [AutoRest](https://github.com/Azure/autorest) using the [PowerShell](https://github.com/Azure/autorest.powershell) extension.
+
+## Module Requirements
+- [Az.Accounts module](https://www.powershellgallery.com/packages/Az.Accounts/), version 2.2.3 or greater
+
+## Authentication
+AutoRest does not generate authentication code for the module. Authentication is handled via Az.Accounts by altering the HTTP payload before it is sent.
+
+## Development
+For information on how to develop for `Azs.ContainerService.Admin`, see [how-to.md](how-to.md).
+<!-- endregion -->
+
+## Generation Requirements
+Use of the beta version of `autorest.powershell` generator requires the following:
+- [NodeJS LTS](https://nodejs.org) (10.15.x LTS preferred)
+  - **Note**: It *will not work* with Node < 10.x. Using 11.x builds may cause issues as they may introduce instability or breaking changes.
+> If you want an easy way to install and update Node, [NVS - Node Version Switcher](../nodejs/installing-via-nvs.md) or [NVM - Node Version Manager](../nodejs/installing-via-nvm.md) is recommended.
+- [AutoRest](https://aka.ms/autorest) v3 beta <br>`npm install -g autorest@beta`<br>&nbsp;
+- PowerShell 6.0 or greater
+  - If you don't have it installed, you can use the cross-platform npm package <br>`npm install -g pwsh`<br>&nbsp;
+- .NET Core SDK 2.0 or greater
+  - If you don't have it installed, you can use the cross-platform npm package <br>`npm install -g dotnet-sdk-2.2`<br>&nbsp;
+
+## Run Generation
+In this directory, run AutoRest:
+> `autorest`
+
+---
+### AutoRest Configuration
+> see https://aka.ms/autorest
+
+``` yaml
+require:
+  - $(this-folder)/../readme.azurestack.md
+  - $(repo)/specification/azsadmin/resource-manager/containerservice/readme.azsautogen.md
+
+metadata:
+  description: 'Microsoft AzureStack PowerShell: ContainerService Admin cmdlets'
+
+### PSD1 metadata changes
+subject-prefix: ''
+module-version: 0.1.0
+service-name: ContainerServiceAdmin
+
+### File Renames
+### IMPORTANT - Note that the following settings are case sensitive ###
+module-name: Azs.ContainerService.Admin
+csproj: Azs.ContainerService.Admin.csproj
+psd1: Azs.ContainerService.Admin.psd1
+psm1: Azs.ContainerService.Admin.psm1
+```
+
+### Parameter default values
+``` yaml
+directive:
+
+# Add release notes
+  - from: Azs.ContainerService.Admin.nuspec
+    where: $
+    transform: $ = $.replace('<releaseNotes></releaseNotes>', '<releaseNotes>AzureStack Hub Admin module generated with https://github.com/Azure/autorest.powershell.</releaseNotes>');
+
+# Add Az.Accounts/Az.Resources as dependencies
+  - from: Azs.ContainerService.Admin.nuspec
+    where: $
+    transform: $ = $.replace('<dependency id=\"Az.Accounts\" version=\"1.6.0\" />', '<dependency id="Az.Accounts" version="2.2.8" />\n      <dependency id="Az.Resources" version="[0.11.0]" />');
+
+# PSD1 changes for RequiredModules
+  - from: source-file-csharp
+    where: $
+    transform: $ = $.replace('sb.AppendLine\(\$@\"\{Indent\}RequiredAssemblies = \'\{\"./bin/Azs.ContainerService.Admin.private.dll\"\}\'\"\);', 'sb.AppendLine\(\$@\"\{Indent\}RequiredAssemblies = \'\{\"./bin/Azs.ContainerService.Admin.private.dll\"\}\'\"\);\n      sb.AppendLine\(\$@\"\{Indent\}RequiredModules = @\(@\{\{ModuleName = \'Az.Accounts\'; ModuleVersion = \'2.2.8\'; \}\}, @\{\{ModuleName = \'Az.Resources\'; RequiredVersion = \'0.11.0\'; \}\}\)\"\);');
+
+# PSD1 changes for ReleaseNotes
+  - from: source-file-csharp
+    where: $
+    transform: $ = $.replace('sb.AppendLine\(\$@\"\{Indent\}\{Indent\}\{Indent\}ReleaseNotes = \'\'\"\);', 'sb.AppendLine\(\$@\"\{Indent\}\{Indent\}\{Indent\}ReleaseNotes = \'AzureStack Hub Admin module generated with https://github.com/Azure/autorest.powershell\'\"\);' );
+```