Compartilhar via

New-AzureRmContainerServiceConfig

  • Referência
Módulo:
AzureRM.Compute

Cria um objeto de configuração local para um serviço de contêiner.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

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

O cmdlet New-AzureRmContainerServiceConfig cria um objeto de configuração local para um serviço de contêiner. Forneça esse objeto ao cmdlet New-AzureRmContainerService para criar um serviço de contêiner.

Exemplos

Exemplo 1: Criar uma configuração de serviço de contêiner

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"

Esse comando cria um contêiner e o armazena na variável $Container. O comando especifica várias configurações para a configuração do serviço de contêiner. O comando passa o objeto de configuração para o cmdlet Add-AzureRmContainerServiceAgentPoolProfile usando o operador de pipeline. Esse cmdlet adiciona um perfil de pool de agentes. Especifique o objeto em $Container para o parâmetro ContainerService de New-AzureRmContainerService.

Parâmetros

-AdminUsername

Especifica o nome da conta de administrador a ser usado para um serviço de contêiner baseado em Linux.

Tipo:String
Cargo:8
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-AgentPoolProfile

Especifica uma matriz de objetos de perfil do pool de agentes para o serviço de contêiner. Adicione um perfil usando o cmdlet Add-AzureRmContainerServiceAgentPoolProfile.

Tipo:Microsoft.Azure.Management.Compute.Models.ContainerServiceAgentPoolProfile[]
Cargo:5
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CustomProfileOrchestrator

Especifica o orquestrador de perfil personalizado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

Especifica o local no qual criar o serviço de contêiner.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MasterCount

Especifica o número de máquinas virtuais mestras a serem criadas.

Tipo:Int32
Cargo:3
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MasterDnsPrefix

Especifica o prefixo DNS para a máquina virtual mestre.

Tipo:String
Cargo:4
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-OrchestratorType

Especifica o tipo de orquestrador para o serviço de contêiner. Os valores aceitáveis para esse parâmetro são: DCOS e Swarm.

Tipo:Nullable<T>[Microsoft.Azure.Management.Compute.Models.ContainerServiceOrchestratorTypes]
Valores aceitos:Swarm, DCOS, Custom, Kubernetes
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServicePrincipalProfileClientId

Especifica a ID do cliente do perfil principal.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServicePrincipalProfileSecret

Especifica o segredo do perfil principal.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SshPublicKey

Especifica a chave pública SSH para um serviço de contêiner baseado em Linux.

Tipo:String[]
Cargo:9
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Tag

Pares de chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; chave1=$null; chave2="valor2"}

Tipo:Hashtable
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VmDiagnosticsEnabled

Indica se essa configuração habilita o diagnóstico para a máquina virtual do serviço de contêiner.

Tipo:Boolean
Cargo:10
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WindowsProfileAdminPassword

Especifica a senha do administrador para um serviço de contêiner que usa o sistema operacional Windows.

Tipo:String
Cargo:7
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WindowsProfileAdminUsername

Especifica o nome de usuário do administrador para um serviço de contêiner que usa o sistema operacional Windows.

Tipo:String
Cargo:6
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

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

Saídas

PSContainerService