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

Import-AzContainerRegistryImage

  • 参考
模块:
Az.ContainerRegistry

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

语法

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

以作业身份运行命令

Type:SwitchParameter
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

-DefaultProfile

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

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

-Mode

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

Type:ImportMode
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

-Parameter

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

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

-PassThru

当命令成功时返回 true

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

-Password

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

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

-RegistryName

容器注册表的名称。

Type:String
Position:Named
Default value:None
Required:True
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

-SourceImage

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

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

-SourceRegistryUri

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

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

-SourceResourceId

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

Type:String
Aliases:SourceRegistryResourceId
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

-TargetTag

表单存储库[：tag] 的字符串列表。 当省略标记时，将使用源（如果也省略源标记），则使用“latest”。

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

-UntaggedTargetRepository

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

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

-Username

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

Type:String
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

输入

IImportImageParameters

输出

Boolean

备注

别名

复杂参数属性

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

PARAMETER <IImportImageParameters>: .

  • SourceImage <String>：源映像的存储库名称。 按存储库（“hello-world”）指定映像。 这将使用“latest”标记。 按标记指定图像（“hello-world：latest”）。 按基于 sha256 的清单摘要（“hello-world@sha256：abc123”）指定映像。
  • [CredentialsPassword <String>]：用于向源注册表进行身份验证的密码。
  • [CredentialsUsername <String>]：用于向源注册表进行身份验证的用户名。
  • [Mode <ImportMode?>]：强制时，将覆盖任何现有目标标记。 当 NoForce 时，任何现有目标标记都将在开始任何复制之前失败操作。
  • [SourceRegistryUri <String>]：源注册表（例如“mcr.microsoft.com”）的地址。
  • [SourceResourceId <String>]：源Azure 容器注册表的资源标识符。
  • [TargetTag <String[]>]：表单存储库[：tag] 的字符串列表。 当省略标记时，将使用源（如果也省略源标记），则使用“latest”。
  • [UntaggedTargetRepository <String[]>]：用于仅执行清单复制的存储库名称字符串列表。 不会创建任何标记。