Import-AzContainerRegistryImage

  • 參考
模組:
Az.ContainerRegistry

從指定的容器登錄將映像複製到這個容器登錄。

Syntax

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

Description

從指定的容器登錄將映像複製到這個容器登錄。

範例

範例 1：將映射從公用/azure 登錄匯入至 Azure Container Registry。

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

將 busybox 匯入至 ACR。 注意：來源映像之前，必須新增「連結庫/」。 如果來源登錄未公開提供 SourceRegistryResourceId 或 SourceRegistryUri，則需要 “busybox：latest” => “library/busybox：latest” 認證

參數

-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

當 Force 時，將會覆寫任何現有的目標標記。 當 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 Container Registry 的資源標識碼。

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

-SubscriptionId

目標訂用帳戶的標識碼。 此值必須是 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

備註

別名

COMPLEX PARAMETER PROPERTIES

若要建立以下所述的參數，請建構包含適當屬性的哈希表。 如需哈希表的相關信息，請執行 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?>]：當 Force 時，將會覆寫任何現有的目標標記。 當 NoForce 時，任何現有的目標標籤都會在作業開始之前失敗。
  • [SourceRegistryUri <String>]：來源登錄的位址（例如 'mcr.microsoft.com'）。
  • [SourceResourceId <String>]：來源 Azure Container Registry 的資源標識符。
  • [TargetTag <String[]>]：表單存放庫[：tag] 的字串清單。 當省略標籤時，將會使用來源 （如果同時省略來源標籤則為 'latest'）。
  • [UntaggedTargetRepository <String[]>]：僅執行指令清單複製之存放庫名稱的字串清單。 將不會建立標記。