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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour