Partilhar via


New-AzureRmContainerServiceConfig

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

Aviso

O módulo AzureRM do PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação 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"

Este comando cria um contêiner e, em seguida, armazena-o 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
Position:8
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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[]
Position:5
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CustomProfileOrchestrator

Especifica o orquestrador de perfil personalizado.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Location

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

Tipo:String
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-MasterCount

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

Tipo:Int32
Position:3
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-MasterDnsPrefix

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

Tipo:String
Position:4
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-OrchestratorType

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

Tipo:Nullable<T>[Microsoft.Azure.Management.Compute.Models.ContainerServiceOrchestratorTypes]
Valores aceites:Swarm, DCOS, Custom, Kubernetes
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ServicePrincipalProfileClientId

Especifica a ID do cliente do perfil principal.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ServicePrincipalProfileSecret

Especifica o segredo do perfil principal.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SshPublicKey

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

Tipo:String[]
Position:9
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Tag

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

Tipo:Hashtable
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VmDiagnosticsEnabled

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

Tipo:Boolean
Position:10
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WindowsProfileAdminPassword

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

Tipo:String
Position:7
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Position:6
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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