你当前正在访问 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 |
输入
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.ContainerServiceOrchestratorTypes, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
Microsoft.Azure.Management.Compute.Models.ContainerServiceAgentPoolProfile[]
String[]