New-AzContainerRegistry

參考

模組:: Az.ContainerRegistry

使用指定的參數建立容器登錄。

Syntax

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

Description

使用指定的參數建立容器登錄。

範例

範例 1：使用新的記憶體帳戶建立容器登錄。

New-AzContainerRegistry -ResourceGroupName "MyResourceGroup" -Name "RegistryExample" -Sku "Basic" -Location "west us"

Name             SkuName LoginServer                 CreationDate         ProvisioningState AdminUserEnabled
----             ------- -----------                 ------------         ----------------- ----------------
RegistryExample Basic   registryexample.azurecr.io 1/19/2023 6:10:49 AM Succeeded         False

使用新的記憶體帳戶建立容器登錄。

範例 2：建立已啟用系統管理員使用者的容器登錄。

New-AzContainerRegistry -ResourceGroupName "MyResourceGroup" -Name "RegistryExample" -Sku "Basic" -Location "west us" -EnableAdminUser

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

建立已啟用系統管理員使用者的容器登錄。

參數

-AnonymousPullEnabled

從未經驗證的用戶端啟用全登錄提取。

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

-AsJob

以作業身分執行命令

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

-AzureAdAuthenticationAsArmPolicyStatus

值，指出是否啟用原則。

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

-DataEndpointEnabled

為每個區域啟用單一資料端點來提供數據。

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

-EnableAdminUser

值，指出是否啟用系統管理員使用者。

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

-EncryptionStatus

指出容器登錄是否啟用加密。

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

-ExportPolicyStatus

值，指出是否啟用原則。

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

-IdentityPrincipalId

資源識別的主要標識碼。

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

-IdentityTenantId

資源的租用戶標識碼。

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

-IdentityType

識別類型。

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

-IdentityUserAssignedIdentity

與資源相關聯的使用者身分識別清單。使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/ providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。

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

-KeyVaultPropertyIdentity

將用來存取金鑰保存庫之身分識別的用戶端識別碼。

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

-KeyVaultPropertyKeyIdentifier

用來存取加密金鑰的金鑰保存庫 URI。

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

-Location

資源的位置。建立資源之後，就無法變更此專案。

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

-Name

容器登錄的名稱。

Type:	String
Aliases:	RegistryName, ResourceName, ContainerRegistryName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NetworkRuleBypassOption

是否允許受信任的 Azure 服務存取受網路限制的登錄。

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

-NetworkRuleSetDefaultAction

當沒有其他規則相符時，允許或拒絕的默認動作。

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

-NetworkRuleSetIPRule

IP ACL 規則。若要建構，請參閱 NETWORKRULESETIPRULE 屬性和建立哈希表的 NOTES 一節。

Type:	IIPRule[]
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

-PublicNetworkAccess

容器登錄是否允許公用網路存取。

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

-QuarantinePolicyStatus

值，指出是否啟用原則。

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

-RetentionPolicyDay

要保留未標記指令清單的天數，之後會加以清除。

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

-RetentionPolicyStatus

值，指出是否啟用原則。

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

-Sku

容器登錄的 SKU 名稱。建立登錄時需要。

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

-SoftDeletePolicyRetentionDay

虛刪除專案永久刪除後的天數。

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

-SoftDeletePolicyStatus

值，指出是否啟用原則。

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

-Tag

資源的標記。

Type:	Hashtable
Aliases:	Tags
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustPolicyStatus

值，指出是否啟用原則。

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

-TrustPolicyType

信任原則的類型。

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

-ZoneRedundancy

是否為此容器登錄啟用區域備援

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

輸出

IRegistry

備註

別名

COMPLEX PARAMETER PROPERTIES

若要建立以下所述的參數，請建構包含適當屬性的哈希表。如需哈希表的相關信息，請執行 Get-Help about_Hash_Tables。

NETWORKRULESETIPRULE <IIPRule[]>：IP ACL 規則。

IPAddressOrRange <String>：以 CIDR 格式指定 IP 或 IP 範圍。只允許 IPV4 位址。
[Action <Action?>]：IP ACL 規則的動作。

New-AzContainerRegistry

Syntax

Description

範例

範例 1：使用新的記憶體帳戶建立容器登錄。

範例 2：建立已啟用系統管理員使用者的容器登錄。

參數

-AnonymousPullEnabled

-AsJob

-AzureAdAuthenticationAsArmPolicyStatus

-Confirm

-DataEndpointEnabled

-DefaultProfile

-EnableAdminUser

-EncryptionStatus

-ExportPolicyStatus

-IdentityPrincipalId

-IdentityTenantId

-IdentityType

-IdentityUserAssignedIdentity

-KeyVaultPropertyIdentity

-KeyVaultPropertyKeyIdentifier

-Location

-Name

-NetworkRuleBypassOption

-NetworkRuleSetDefaultAction

-NetworkRuleSetIPRule

-NoWait

-PublicNetworkAccess

-QuarantinePolicyStatus

-ResourceGroupName

-RetentionPolicyDay

-RetentionPolicyStatus

-Sku

-SoftDeletePolicyRetentionDay

-SoftDeletePolicyStatus

-SubscriptionId

-Tag

-TrustPolicyStatus

-TrustPolicyType

-WhatIf

-ZoneRedundancy

輸出

備註

其他資源