New-AzContainerRegistry

Module:

Az.ContainerRegistry

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