共用方式為

New-AzureRmContainerServiceConfig

  • 參考
模組:
AzureRM.Compute

建立容器服務的本機組態物件。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。

語法

New-AzureRmContainerServiceConfig
   [[-Location] <String>]
   [[-Tag] <Hashtable>]
   [[-OrchestratorType] <ContainerServiceOrchestratorTypes>]
   [[-MasterCount] <Int32>]
   [[-MasterDnsPrefix] <String>]
   [[-AgentPoolProfile] <ContainerServiceAgentPoolProfile[]>]
   [[-WindowsProfileAdminUsername] <String>]
   [[-WindowsProfileAdminPassword] <String>]
   [[-AdminUsername] <String>]
   [[-SshPublicKey] <String[]>]
   [[-VmDiagnosticsEnabled] <Boolean>]
   [-CustomProfileOrchestrator <String>]
   [-ServicePrincipalProfileClientId <String>]
   [-ServicePrincipalProfileSecret <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzureRmContainerServiceConfig Cmdlet 會建立容器服務的本機設定物件。 將此物件提供給 New-AzureRmContainerService Cmdlet，以建立容器服務。

範例

範例 1：建立容器服務組態

PS C:\> $Container = New-AzureRmContainerServiceConfig -Location "Australia Southeast" -OrchestratorType "DCOS" -MasterDnsPrefix "MasterResourceGroup17" -AdminUsername "AcsLinuxAdmin" -SshPublicKey "<ssh-key>"
PS C:\> $Container | Add-AzureRmContainerServiceAgentPoolProfile -Name "AgentPool01" -VmSize "Standard_A1" -DnsPrefix "APResourceGroup17"

此命令會建立容器，然後將它儲存在 $Container 變數中。 命令會指定容器服務組態的各種設定。 此命令會使用管線運算符，將組態對象傳遞至 Add-AzureRmContainerServiceAgentPoolProfile Cmdlet。 該 Cmdlet 會新增代理程式集區配置檔。 針對 New-AzureRmContainerService 的 ContainerService 參數，在 $Container 中指定 物件。

參數

-AdminUsername

指定要用於 Linux 型容器服務的系統管理員帳戶名稱。

類型:String
Position:8
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-AgentPoolProfile

指定容器服務的代理程式集區配置檔物件數位。 使用 Add-AzureRmContainerServiceAgentPoolProfile Cmdlet 新增配置檔。

類型:Microsoft.Azure.Management.Compute.Models.ContainerServiceAgentPoolProfile[]
Position:5
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CustomProfileOrchestrator

指定自訂配置檔協調器。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Location

指定要在其中建立容器服務的位置。

類型:String
Position:0
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-MasterCount

指定要建立的主要虛擬機數目。

類型:Int32
Position:3
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-MasterDnsPrefix

指定主要虛擬機的 DNS 前置詞。

類型:String
Position:4
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-OrchestratorType

指定容器服務的協調器類型。 此參數可接受的值為：DCOS 和 Swarm。

類型:Nullable<T>[Microsoft.Azure.Management.Compute.Models.ContainerServiceOrchestratorTypes]
接受的值:Swarm, DCOS, Custom, Kubernetes
Position:2
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ServicePrincipalProfileClientId

指定主體設定檔用戶端識別碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ServicePrincipalProfileSecret

指定主體配置檔秘密。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-SshPublicKey

指定以Linux為基礎的容器服務的SSH 公鑰。

類型:String[]
Position:9
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Tag

哈希表形式的索引鍵/值組。 例如：@{key0=“value0”;key1=$null;key2=“value2”}

類型:Hashtable
Position:1
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-VmDiagnosticsEnabled

指出此組態是否啟用容器服務虛擬機的診斷。

類型:Boolean
Position:10
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WindowsProfileAdminPassword

指定使用 Windows 作業系統之容器服務的系統管理員密碼。

類型:String
Position:7
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-WindowsProfileAdminUsername

指定使用 Windows 作業系統之容器服務的系統管理員用戶名稱。

類型:String
Position:6
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸入

String

Hashtable

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.ContainerServiceOrchestratorTypes, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Int32

Microsoft.Azure.Management.Compute.Models.ContainerServiceAgentPoolProfile[]

String[]

Boolean

輸出

PSContainerService