New-AzAppConfigurationStore
Creates a configuration store with the specified parameters.
Note
This is the previous version of our documentation. Please consult the most recent version for up-to-date information.
Syntax
New-AzAppConfigurationStore
-Name <String>
-ResourceGroupName <String>
-Location <String>
-Sku <String>
[-SubscriptionId <String>]
[-IdentityType <IdentityType>]
[-Tag <Hashtable>]
[-UserAssignedIdentity <String[]>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-Confirm]
[-WhatIf]
[<CommonParameters>] Description
Creates a configuration store with the specified parameters.
Examples
Example 1: Create an app configuration store
PS C:\> New-AzAppConfigurationStore -Name appconfig-test03 -ResourceGroupName azpwsh-manual-test -Location eastus -Sku free
Location Name Type
-------- ---- ----
eastus appconfig-test03 Microsoft.AppConfiguration/configurationStoresThis command creates an app configuration store.
Example 2: Create an app configuration with the IdentityType set to "UserAssigned"
PS C:\> $assignedIdentity = New-AzUserAssignedIdentity -ResourceGroupName azpwsh-manual-test -Name assignedIdentity
PS C:\> New-AzAppConfigurationStore -Name appconfig-test10 -ResourceGroupName azpwsh-manual-test -Location eastus -Sku standard -IdentityType "UserAssigned" -UserAssignedIdentity $assignedIdentity.Id
Location Name Type
-------- ---- ----
eastus appconfig-test03 Microsoft.AppConfiguration/configurationStoresThis command creates an app configuration and assign a user-assigned managed identity to it.
See the example of Update-AzAppConfigurationStore for the following steps to enable CMK (cusomer managed key).
Example 3: Create an app configuration with the IdentityType set to "SystemAssigned"
PS C:\> New-AzAppConfigurationStore -Name appconfig-test11 -ResourceGroupName azpwsh-manual-test -Location eastus -Sku standard -IdentityType "SystemAssigned"
Location Name Type
-------- ---- ----
eastus appconfig-test11 Microsoft.AppConfiguration/configurationStoresThis command creates an app configuration and enables the system-assigned managed identity associated with the resource.
See the example of Update-AzAppConfigurationStore for the following steps to enable CMK (cusomer managed key).
Example 4: Create an app configuration with the IdentityType set to "SystemAssigned, UserAssigned"
PS C:\> $assignedIdentity = New-AzUserAssignedIdentity -ResourceGroupName azpwsh-manual-test -Name assignedIdentity
PS C:\> New-AzAppConfigurationStore -Name appconfig-test10 -ResourceGroupName azpwsh-manual-test -Location eastus -Sku standard -IdentityType "SystemAssigned, UserAssigned" -UserAssignedIdentity $assignedIdentity.Id
Location Name Type
-------- ---- ----
eastus appconfig-test10 Microsoft.AppConfiguration/configurationStoresYou can enable system-assigned managed identity and give user-assigned identities at the same time.
See the example of Update-AzAppConfigurationStore for the following steps to enable CMK (cusomer managed key).
Parameters
Run the command as a job
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The credentials, account, tenant, and subscription used for communication with Azure.
| Type: | PSObject |
| Aliases: | AzureRMContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The type of managed identity used. The type 'SystemAssignedAndUserAssigned' includes both an implicitly created identity and a set of user-assigned identities. The type 'None' will remove any identities.
| Type: | IdentityType |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The location of the resource. This cannot be changed after the resource is created.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The name of the configuration store.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Run the command asynchronously
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The name of the resource group to which the container registry belongs.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The SKU name of the configuration store.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The Microsoft Azure subscription ID.
| Type: | String |
| Position: | Named |
| Default value: | (Get-AzContext).Subscription.Id |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The tags of the resource.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The list of user-assigned identities associated with the resource. The user-assigned identity dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Outputs
Notes
ALIASES