New-AzContainerRegistry

Creates a container registry with the specified parameters.

Syntax

New-AzContainerRegistry
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -Sku <SkuName>
   [-AnonymousPullEnabled]
   [-AzureAdAuthenticationAsArmPolicyStatus <AzureAdAuthenticationAsArmPolicyStatus>]
   [-DataEndpointEnabled]
   [-EnableAdminUser]
   [-EncryptionStatus <EncryptionStatus>]
   [-ExportPolicyStatus <ExportPolicyStatus>]
   [-IdentityPrincipalId <String>]
   [-IdentityTenantId <String>]
   [-IdentityType <ResourceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-KeyVaultPropertyIdentity <String>]
   [-KeyVaultPropertyKeyIdentifier <String>]
   [-NetworkRuleBypassOption <NetworkRuleBypassOptions>]
   [-NetworkRuleSetDefaultAction <DefaultAction>]
   [-NetworkRuleSetIPRule <IIPRule[]>]
   [-PublicNetworkAccess <PublicNetworkAccess>]
   [-QuarantinePolicyStatus <PolicyStatus>]
   [-RetentionPolicyDay <Int32>]
   [-RetentionPolicyStatus <PolicyStatus>]
   [-SoftDeletePolicyRetentionDay <Int32>]
   [-SoftDeletePolicyStatus <PolicyStatus>]
   [-Tag <Hashtable>]
   [-TrustPolicyStatus <PolicyStatus>]
   [-TrustPolicyType <TrustPolicyType>]
   [-ZoneRedundancy <ZoneRedundancy>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Creates 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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AsJob

Run the command as a job

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AzureAdAuthenticationAsArmPolicyStatus

The value that indicates whether the policy is enabled or not.

Type:AzureAdAuthenticationAsArmPolicyStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DataEndpointEnabled

Enable a single data endpoint per region for serving data.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

The DefaultProfile parameter is not functional. Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableAdminUser

The value that indicates whether the admin user is enabled.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionStatus

Indicates whether or not the encryption is enabled for container registry.

Type:EncryptionStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExportPolicyStatus

The value that indicates whether the policy is enabled or not.

Type:ExportPolicyStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityPrincipalId

The principal ID of resource identity.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityTenantId

The tenant ID of resource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityType

The identity type.

Type:ResourceIdentityType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityUserAssignedIdentity

The list of user identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyVaultPropertyIdentity

The client id of the identity which will be used to access key vault.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyVaultPropertyKeyIdentifier

Key vault uri to access the encryption key.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

The location of the resource. This cannot be changed after the resource is created.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

The name of the container registry.

Type:String
Aliases:RegistryName, ResourceName, ContainerRegistryName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NetworkRuleBypassOption

Whether to allow trusted Azure services to access a network restricted registry.

Type:NetworkRuleBypassOptions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NetworkRuleSetDefaultAction

The default action of allow or deny when no other rules match.

Type:DefaultAction
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NetworkRuleSetIPRule

The IP ACL rules. To construct, see NOTES section for NETWORKRULESETIPRULE properties and create a hash table.

Type:IIPRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

Run the command asynchronously

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicNetworkAccess

Whether or not public network access is allowed for the container registry.

Type:PublicNetworkAccess
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-QuarantinePolicyStatus

The value that indicates whether the policy is enabled or not.

Type:PolicyStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

The name of the resource group. The name is case insensitive.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RetentionPolicyDay

The number of days to retain an untagged manifest after which it gets purged.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RetentionPolicyStatus

The value that indicates whether the policy is enabled or not.

Type:PolicyStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Sku

The SKU name of the container registry. Required for registry creation.

Type:SkuName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SoftDeletePolicyRetentionDay

The number of days after which a soft-deleted item is permanently deleted.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SoftDeletePolicyStatus

The value that indicates whether the policy is enabled or not.

Type:PolicyStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

The ID of the target subscription. The value must be an UUID.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

The tags of the resource.

Type:Hashtable
Aliases:Tags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TrustPolicyStatus

The value that indicates whether the policy is enabled or not.

Type:PolicyStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TrustPolicyType

The type of trust policy.

Type:TrustPolicyType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ZoneRedundancy

Whether or not zone redundancy is enabled for this container registry

Type:ZoneRedundancy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

IRegistry

Notes

ALIASES

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

NETWORKRULESETIPRULE <IIPRule[]>: The IP ACL rules.

  • IPAddressOrRange <String>: Specifies the IP or IP range in CIDR format. Only IPV4 address is allowed.
  • [Action <Action?>]: The action of IP ACL rule.