Connect-AzContainerRegistry
登入 Azure 容器登錄。
語法
WithoutNameAndPasswordParameterSet (預設值)
Connect-AzContainerRegistry
-Name <String>
[-ExposeToken]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
WithNameAndPasswordParameterSet
Connect-AzContainerRegistry
-Name <String>
-UserName <String>
-Password <String>
[-ExposeToken]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
登入 Azure 容器登錄。
範例
範例 1
Connect-AzContainerRegistry -Name $RegistryName
已登入 Azure 帳戶時,無需認證即可登入 ACR。
範例 2
Connect-AzContainerRegistry -Name $RegistryName -UserName $RegistryName -Password $AdminPassWord
啟用管理員使用者時,使用管理員使用者名稱/密碼登入 ACR。
範例 3
Connect-AzContainerRegistry -Name $RegistryName -UserName $ServicePrincipal -Password $ServicePrincipalPassword
使用服務主體應用程式識別碼和密碼登入 ACR。
範例 4
$cred = Connect-AzContainerRegistry -Name $RegistryName -ExposeToken
$token = ($cred.accessToken | ConvertFrom-SecureString -AsPlainText)
$loginServer = $cred.loginServer
docker login $loginServer -u 00000000-0000-0000-0000-000000000000 --password $token
用原生容器化工具登入 ACR。
參數
-DefaultProfile
用於與 Azure 通訊的憑證、帳號、租戶和訂閱。
參數屬性
| 類型: | IAzureContextContainer |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | AzContext, AzureRmContext, AzureCredential |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExposeToken
公開存取權杖,而不是透過 Docker CLI 自動登入。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
Azure Container Registry Name.
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 登錄名稱 |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Password
Password for Azure Container Registry.
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WithNameAndPasswordParameterSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-UserName
User name for Azure Container Registry.
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
WithNameAndPasswordParameterSet
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸入
String
輸出
Boolean
備註
對於純登錄檔名稱,指令會使用 Azure Resource Manager 來偵測登入伺服器,若發現失敗則回退至所提供的名稱與環境後綴。 成功的發現結果會在用戶端的相同登錄檔與上下文中重複使用。
登錄名稱必須包含 5 至 50 個 ASCII 字母或數字。 明確的登入伺服器標籤也可能包含一個連字號,後接非空的 ASCII 字母數字後綴,總長度最多 63 個字元。 字尾不受固定長度或特定值限制。
明確的連字標籤,包括網域名稱標籤(DNL)標籤(如 ) registry-<hash> 以及舊有標籤(如 registry-microsoft),會直接搭配環境後綴使用,無需進行 ARM 發現。 只提供標籤,不要提供 URL 或完整的登入伺服器網域。