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

New-AzureRmContainerServiceConfig

为容器服务创建本地配置对象。

警告

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

说明

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

指定主体配置文件客户端 ID。

类型: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