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

Update-AzContainerRegistry

使用指定的参数更新容器注册表。

语法

UpdateExpanded (默认值)

Update-AzContainerRegistry
    -Name <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-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>]
    [-Sku <SkuName>]
    [-SoftDeletePolicyRetentionDay <Int32>]
    [-SoftDeletePolicyStatus <PolicyStatus>]
    [-Tag <Hashtable>]
    [-TrustPolicyStatus <PolicyStatus>]
    [-TrustPolicyType <TrustPolicyType>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpanded

Update-AzContainerRegistry
    -InputObject <IContainerRegistryIdentity>
    [-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>]
    [-Sku <SkuName>]
    [-SoftDeletePolicyRetentionDay <Int32>]
    [-SoftDeletePolicyStatus <PolicyStatus>]
    [-Tag <Hashtable>]
    [-TrustPolicyStatus <PolicyStatus>]
    [-TrustPolicyType <TrustPolicyType>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

使用指定的参数更新容器注册表。

示例

示例 1:为指定的容器注册表启用管理员用户

Update-AzContainerRegistry -ResourceGroupName "MyResourceGroup" -Name "RegistryExample" -EnableAdminUser
Name             SkuName  LoginServer                 CreationDate         ProvisioningState AdminUserEnabled
----             -------  -----------                 ------------         ----------------- ----------------
RegistryExample  Basic    registryexample.azurecr.io  1/19/2023 6:10:49 AM Succeeded         True

此命令为指定的容器注册表启用管理员用户。

参数

-AnonymousPullEnabled

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AsJob

以作业身份运行命令

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AzureAdAuthenticationAsArmPolicyStatus

指示是否启用策略的值。

参数属性

类型:AzureAdAuthenticationAsArmPolicyStatus
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DataEndpointEnabled

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

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

参数属性

类型:PSObject
默认值:None
支持通配符:False
不显示:False
别名:AzureRMContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EnableAdminUser

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EncryptionStatus

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

参数属性

类型:EncryptionStatus
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ExportPolicyStatus

指示是否启用策略的值。

参数属性

类型:ExportPolicyStatus
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IdentityPrincipalId

资源标识的主体 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IdentityTenantId

资源的租户 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IdentityType

标识类型。

参数属性

类型:ResourceIdentityType
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IdentityUserAssignedIdentity

与资源关联的用户标识列表。 用户标识字典密钥引用的格式为 ARM 资源 ID:“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InputObject

要构造的标识参数,请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

参数属性

类型:IContainerRegistryIdentity
默认值:None
支持通配符:False
不显示:False

参数集

UpdateViaIdentityExpanded
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-KeyVaultPropertyIdentity

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-KeyVaultPropertyKeyIdentifier

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

容器注册表的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:RegistryName, 资源名称, ContainerRegistryName

参数集

UpdateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NetworkRuleBypassOption

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

参数属性

类型:NetworkRuleBypassOptions
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NetworkRuleSetDefaultAction

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

参数属性

类型:DefaultAction
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NetworkRuleSetIPRule

IP ACL 规则。 若要构造,请参阅 NETWORKRULESETIPRULE 属性的 NOTES 部分并创建哈希表。

参数属性

类型:

IIPRule[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NoWait

异步运行命令

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PublicNetworkAccess

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

参数属性

类型:PublicNetworkAccess
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-QuarantinePolicyStatus

指示是否启用策略的值。

参数属性

类型:PolicyStatus
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceGroupName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UpdateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RetentionPolicyDay

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RetentionPolicyStatus

指示是否启用策略的值。

参数属性

类型:PolicyStatus
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Sku

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

参数属性

类型:SkuName
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SoftDeletePolicyRetentionDay

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SoftDeletePolicyStatus

指示是否启用策略的值。

参数属性

类型:PolicyStatus
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SubscriptionId

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

参数属性

类型:String
默认值:(Get-AzContext).Subscription.Id
支持通配符:False
不显示:False

参数集

UpdateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Tag

容器注册表的标记。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False
别名:标记

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TrustPolicyStatus

指示是否启用策略的值。

参数属性

类型:PolicyStatus
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TrustPolicyType

信任策略的类型。

参数属性

类型:TrustPolicyType
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

IContainerRegistryIdentity

输出

IRegistry