Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
New-AzContainerRegistry
- Module:
- Az.ContainerRegistry Module
Create a container registry with the specified parameters.
Syntax
CreateExpanded (Default)
New-AzContainerRegistry
-Name <String>
-ResourceGroupName <String>
-Location <String>
-Sku <String>
[-SubscriptionId <String>]
[-AnonymousPullEnabled]
[-AzureAdAuthenticationAsArmPolicyStatus <String>]
[-DataEndpointEnabled]
[-EnableAdminUser]
[-EnableSystemAssignedIdentity]
[-EncryptionStatus <String>]
[-ExportPolicyStatus <String>]
[-IdentityPrincipalId <String>]
[-IdentityTenantId <String>]
[-KeyVaultPropertyIdentity <String>]
[-KeyVaultPropertyKeyIdentifier <String>]
[-NetworkRuleBypassOption <String>]
[-NetworkRuleSetDefaultAction <String>]
[-NetworkRuleSetIPRule <IIPRule[]>]
[-PublicNetworkAccess <String>]
[-QuarantinePolicyStatus <String>]
[-RetentionPolicyDay <Int32>]
[-RetentionPolicyStatus <String>]
[-SoftDeletePolicyRetentionDay <Int32>]
[-SoftDeletePolicyStatus <String>]
[-Tag <Hashtable>]
[-TrustPolicyStatus <String>]
[-TrustPolicyType <String>]
[-UserAssignedIdentity <String[]>]
[-ZoneRedundancy <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonFilePath
New-AzContainerRegistry
-Name <String>
-ResourceGroupName <String>
-JsonFilePath <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaJsonString
New-AzContainerRegistry
-Name <String>
-ResourceGroupName <String>
-JsonString <String>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Create a container registry with the specified parameters.
Examples
Example 1: Create a container registry with a new storage account.
New-AzContainerRegistry -ResourceGroupName "MyResourceGroup" -Name "RegistryExample" -Sku "Basic" -Location "west us"
Name SkuName LoginServer CreationDate ProvisioningState AdminUserEnabled
---- ------- ----------- ------------ ----------------- ----------------
RegistryExample Basic registryexample.azurecr.io 1/19/2023 6:10:49 AM Succeeded False
Create a container registry with a new storage account.
Example 2: Create a container registry with admin user enabled.
New-AzContainerRegistry -ResourceGroupName "MyResourceGroup" -Name "RegistryExample" -Sku "Basic" -Location "west us" -EnableAdminUser
Name SkuName LoginServer CreationDate ProvisioningState AdminUserEnabled
---- ------- ----------- ------------ ----------------- ----------------
RegistryExample Basic registryexample.azurecr.io 1/19/2023 6:10:49 AM Succeeded True
Create a container registry with admin user enabled.
Parameters
-AnonymousPullEnabled
Enables registry-wide pull from unauthenticated clients.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AsJob
Run the command as a job
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-AzureAdAuthenticationAsArmPolicyStatus
The value that indicates whether the policy is enabled or not.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
-DataEndpointEnabled
Enable a single data endpoint per region for serving data.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-DefaultProfile
The DefaultProfile parameter is not functional. Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.
Parameter properties
| Type: | PSObject |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | AzureRMContext, AzureCredential |
Parameter sets
-EnableAdminUser
The value that indicates whether the admin user is enabled.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EnableSystemAssignedIdentity
Determines whether to enable a system-assigned identity for the resource.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-EncryptionStatus
Indicates whether or not the encryption is enabled for container registry.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ExportPolicyStatus
The value that indicates whether the policy is enabled or not.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-IdentityPrincipalId
The principal ID of resource identity.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-IdentityTenantId
The tenant ID of resource.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-JsonFilePath
Path of Json file supplied to the Create operation
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-JsonString
Json string supplied to the Create operation
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-KeyVaultPropertyIdentity
The client id of the identity which will be used to access key vault.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-KeyVaultPropertyKeyIdentifier
Key vault uri to access the encryption key.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Location
The location of the resource. This cannot be changed after the resource is created.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Name
The name of the container registry.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | RegistryName, ResourceName, ContainerRegistryName |
Parameter sets
-NetworkRuleBypassOption
Whether to allow trusted Azure services to access a network restricted registry.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NetworkRuleSetDefaultAction
The default action of allow or deny when no other rules match.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NetworkRuleSetIPRule
The IP ACL rules.
Parameter properties
| Type: | IIPRule[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NoWait
Run the command asynchronously
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PublicNetworkAccess
Whether or not public network access is allowed for the container registry.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-QuarantinePolicyStatus
The value that indicates whether the policy is enabled or not.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ResourceGroupName
The name of the resource group. The name is case insensitive.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-RetentionPolicyDay
The number of days to retain an untagged manifest after which it gets purged.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-RetentionPolicyStatus
The value that indicates whether the policy is enabled or not.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Sku
The SKU name of the container registry. Required for registry creation.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SoftDeletePolicyRetentionDay
The number of days after which a soft-deleted item is permanently deleted.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SoftDeletePolicyStatus
The value that indicates whether the policy is enabled or not.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-SubscriptionId
The ID of the target subscription. The value must be an UUID.
Parameter properties
| Type: | String |
| Default value: | (Get-AzContext).Subscription.Id |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Tag
The tags of the resource.
Parameter properties
| Type: | Hashtable |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Tags |
Parameter sets
-TrustPolicyStatus
The value that indicates whether the policy is enabled or not.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-TrustPolicyType
The type of trust policy.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-UserAssignedIdentity
The array of user assigned identities associated with the resource. The elements in array will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.'
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
-ZoneRedundancy
Whether or not zone redundancy is enabled for this container registry
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Outputs
IRegistry
Azure PowerShell
Feedback
Was this page helpful?