This is the AutoRest configuration and documentation file for Az.AppConfiguration PowerShell module.
Use of the beta version of autorest.powershell
generator requires the following:
- NodeJS LTS (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 or NVM - Node Version Manager is recommended.
- AutoRest v3 beta
npm install -g autorest@beta
- PowerShell 6.0 or greater
- If you don't have it installed, you can use the cross-platform npm package
npm install -g pwsh
- If you don't have it installed, you can use the cross-platform npm package
- .NET Core SDK 2.0 or greater
- If you don't have it installed, you can use the cross-platform npm package
npm install -g dotnet-sdk-2.2
- If you don't have it installed, you can use the cross-platform npm package
- Az.Accounts module, version 1.4.0 or greater
In this directory, run AutoRest:
autorest
To compile and run the module, use:
./AppConfiguration/build-module.ps1 -Run
Creating isolated process...
Cleaning build folders...
Compiling module...
Module DLL Loaded [C:\..\AppConfiguration\bin\Az.AppConfiguration.private.dll]
Custom PSM1 Loaded [C:\..\AppConfiguration\custom\Az.AppConfiguration.custom.psm1]
-------------Done-------------
Creating isolated process...
Loaded Module 'Az.Accounts'
Loaded Module 'Az.AppConfiguration'
PS C:\...\AppConfiguration [Az.AppConfiguration]>
To examine the cmdlets, use:
Get-Command -Module Az.AppConfiguration
CommandType Name Version Source
----------- ---- ------- ------
Function Get-AzAppConfigurationStore 0.1.0 Az.AppConfiguration
Function Get-AzAppConfigurationStoreKey 0.1.0 Az.AppConfiguration
Function New-AzAppConfigurationStore 0.1.0 Az.AppConfiguration
Function New-AzAppConfigurationStoreKey 0.1.0 Az.AppConfiguration
Function Remove-AzAppConfigurationStore 0.1.0 Az.AppConfiguration
Function Test-AzAppConfigurationStoreNameAvailability 0.1.0 Az.AppConfiguration
Running a cmdlet:
Get-AzAppConfigurationStore
Name Type Id
---- ---- --
elkconfigtest Microsoft.AppConfiguration/configurationStores /subscriptions/9e223dbe-3399-4e19-88eb-0975f02ac87f/resourceGroup...
AutoRest doesn't add authentication code into the generated client. This is handled in Az.Accounts. The module class alters the HTTP payload before it is sent.
These are the settings for generating the cmdlets for an API with AutoRest.
require: readme.azure.md
input-file: AppConfiguration.json
service-name: AppConfiguration
module-version: 0.1.2
skip-model-cmdlets: true
directive:
- where:
parameter-name: ConfigStoreName
set:
parameter-name: Name
- where:
verb: Update
subject: ConfigurationStore
set:
hidden: true
- where:
verb: Get
variant: (.*)SkipToken$
set:
hidden: true
- where:
verb: New
subject: ConfigurationStore
variant: ResourceGroupNameConfigStoreNameLocationTagsProperties
set:
hidden: true
- where:
verb: New
subject: ConfigurationStore
variant: SubscriptionIdResourceGroupNameConfigStoreNameLocationTagsProperties
set:
hidden: true
- where:
verb: New
subject: ConfigurationStoreKey
variant: KeyResourceGroupNameConfigStoreNameId
set:
hidden: true
- where:
verb: New
subject: ConfigurationStoreKey
variant: KeySubscriptionIdResourceGroupNameConfigStoreNameId
set:
hidden: true
- where:
verb: Test
subject: ConfigurationStoreNameAvailability
variant: NameAvailabilityNameType
set:
hidden: true
- where:
verb: Test
subject: ConfigurationStoreNameAvailability
variant: NameAvailabilitySubscriptionIdNameType
set:
hidden: true
This configuration block uses the powershell generator automatically.
use:
- "@microsoft.azure/autorest.powershell@beta"