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

Import-AzContainerRegistryImage

从指定的容器注册表将映像复制到此容器注册表。

语法

ImportExpanded (默认值)

Import-AzContainerRegistryImage
    -RegistryName <String>
    -ResourceGroupName <String>
    -SourceImage <String>
    [-SubscriptionId <String>]
    [-Mode <ImportMode>]
    [-Password <String>]
    [-SourceRegistryUri <String>]
    [-SourceResourceId <String>]
    [-TargetTag <String[]>]
    [-UntaggedTargetRepository <String[]>]
    [-Username <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Import

Import-AzContainerRegistryImage
    -RegistryName <String>
    -ResourceGroupName <String>
    -Parameter <IImportImageParameters>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

从指定的容器注册表将映像复制到此容器注册表。

示例

示例 1:将映像从公共/azure 注册表导入 Azure 容器注册表。

Import-AzContainerRegistryImage -SourceImage library/busybox:latest -ResourceGroupName $resourceGroupName -RegistryName $RegistryName -SourceRegistryUri docker.io -TargetTag busybox:latest

将 busybox 导入 ACR。 注意:“库/”需要在源映像之前添加。 “busybox:latest” => “library/busybox:latest” 如果源注册表不公开可用的 SourceRegistryResourceId 或 SourceRegistryUri 需要此 cmdlet,则需要凭据

参数

-AsJob

以作业身份运行命令

参数属性

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

参数集

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

-Confirm

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

参数属性

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

参数集

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

-DefaultProfile

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

参数属性

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

参数集

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

-Mode

强制时,将覆盖任何现有目标标记。 当 NoForce 时,任何现有目标标记都将在开始任何复制之前失败作。

参数属性

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

参数集

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

-NoWait

异步运行命令

参数属性

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

参数集

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

-Parameter

. 若要构造,请参阅 PARAMETER 属性的 NOTES 部分并创建哈希表。

参数属性

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

参数集

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

-PassThru

当命令成功时返回 true

参数属性

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

参数集

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

-Password

用于向源注册表进行身份验证的密码。

参数属性

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

参数集

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

-RegistryName

容器注册表的名称。

参数属性

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

参数集

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

-ResourceGroupName

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

参数属性

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

参数集

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

-SourceImage

源映像的存储库名称。按存储库(“hello-world”)指定映像。 这将使用“latest”标记。按标记指定图像(“hello-world:latest”)。按基于 sha256 的清单摘要(“hello-world@sha256:abc123”)指定映像。

参数属性

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

参数集

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

-SourceRegistryUri

源注册表(例如“mcr.microsoft.com”)的地址。

参数属性

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

参数集

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

-SourceResourceId

源 Azure 容器注册表的资源标识符。

参数属性

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

参数集

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

-SubscriptionId

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

参数属性

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

参数集

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

-TargetTag

表单存储库[:tag] 的字符串列表。 当省略标记时,将使用源(如果也省略源标记),则使用“latest”。

参数属性

类型:

String[]

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

参数集

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

-UntaggedTargetRepository

要执行清单复制的存储库名称字符串列表。 不会创建任何标记。

参数属性

类型:

String[]

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

参数集

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

-Username

使用源注册表进行身份验证的用户名。

参数属性

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

参数集

ImportExpanded
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

输入

IImportImageParameters

输出

Boolean