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
Azure PowerShell