你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzContainerRegistry

参考

模块:: Az.ContainerRegistry

使用指定的参数创建容器注册表。

语法

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>]

说明

使用指定的参数创建容器注册表。

示例

示例 1：使用新的存储帐户创建容器注册表。

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

使用新的存储帐户创建容器注册表。

示例 2：创建启用了管理员用户的容器注册表。

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

创建启用了管理员用户的容器注册表。

参数

-AnonymousPullEnabled

启用从未经身份验证的客户端进行注册表范围的拉取。

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

-AsJob

以作业身份运行命令

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

-AzureAdAuthenticationAsArmPolicyStatus

指示是否启用策略的值。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DataEndpointEnabled

为每个区域启用单个数据终结点来提供数据。

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

-DefaultProfile

DefaultProfile 参数不起作用。如果对其他订阅执行 cmdlet，请使用 SubscriptionId 参数。

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

-EnableAdminUser

指示是否启用管理员用户的值。

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

-EncryptionStatus

指示是否为容器注册表启用加密。

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

-ExportPolicyStatus

指示是否启用策略的值。

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

-IdentityPrincipalId

资源标识的主体 ID。

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

-IdentityTenantId

资源的租户 ID。

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

-IdentityType

标识类型。

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

-IdentityUserAssignedIdentity

与资源关联的用户标识列表。用户标识字典密钥引用的格式为 ARM 资源 ID：“/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

将用于访问密钥保管库的标识的客户端 ID。

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

-KeyVaultPropertyKeyIdentifier

用于访问加密密钥的密钥保管库 URI。

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

-Location

资源的位置。创建资源后，无法更改此更改。

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

-Name

容器注册表的名称。

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

-NetworkRuleBypassOption

是否允许受信任的 Azure 服务访问网络受限注册表。

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

-NetworkRuleSetDefaultAction

如果没有其他规则匹配，则允许或拒绝的默认操作。

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

-NetworkRuleSetIPRule

IP ACL 规则。若要构造，请参阅 NETWORKRULE 的 NOTES 部分标准版TIPRULE 属性并创建哈希表。

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

-NoWait

异步运行命令

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

-PublicNetworkAccess

是否允许对容器注册表进行公用网络访问。

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

-QuarantinePolicyStatus

指示是否启用策略的值。

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

-ResourceGroupName

资源组的名称。此名称不区分大小写。

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

-RetentionPolicyDay

要保留未标记清单的天数，之后它将被清除。

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

-RetentionPolicyStatus

指示是否启用策略的值。

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

-Sku

容器注册表的 SKU 名称。创建注册表时需要。

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

-SoftDeletePolicyRetentionDay

软删除项永久删除的天数。

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

-SoftDeletePolicyStatus

指示是否启用策略的值。

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

-SubscriptionId

目标订阅的 ID。该值必须是 UUID。

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

-Tag

资源的标记。

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

-TrustPolicyStatus

指示是否启用策略的值。

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

-TrustPolicyType

信任策略的类型。

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

-ZoneRedundancy

是否为此容器注册表启用了区域冗余

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

输出

IRegistry

备注

别名

复杂参数属性

若要创建下面所述的参数，请构造一个包含相应属性的哈希表。有关哈希表的信息，请运行 Get-Help about_Hash_Tables。

NETWORKRULESETIPRULE <IIPRule[]>：IP ACL 规则。

IPAddressOrRange <String>：以 CIDR 格式指定 IP 或 IP 范围。仅允许 IPV4 地址。
[Action <Action?>]：IP ACL 规则的操作。

New-AzContainerRegistry

语法

说明

示例

示例 1：使用新的存储帐户创建容器注册表。

示例 2：创建启用了管理员用户的容器注册表。

参数

-AnonymousPullEnabled

-AsJob

-AzureAdAuthenticationAsArmPolicyStatus

-Confirm

-DataEndpointEnabled

-DefaultProfile

-EnableAdminUser

-EncryptionStatus

-ExportPolicyStatus

-IdentityPrincipalId

-IdentityTenantId

-IdentityType

-IdentityUserAssignedIdentity

-KeyVaultPropertyIdentity

-KeyVaultPropertyKeyIdentifier

-Location

-Name

-NetworkRuleBypassOption

-NetworkRuleSetDefaultAction

-NetworkRuleSetIPRule

-NoWait

-PublicNetworkAccess

-QuarantinePolicyStatus

-ResourceGroupName

-RetentionPolicyDay

-RetentionPolicyStatus

-Sku

-SoftDeletePolicyRetentionDay

-SoftDeletePolicyStatus

-SubscriptionId

-Tag

-TrustPolicyStatus

-TrustPolicyType

-WhatIf

-ZoneRedundancy

输出

备注

反馈

其他资源