< Back

Add-AzureRmContainerServiceAgentPoolProfile

Tue Jan 29, 2019 9:36 pm

NAME Add-AzureRmContainerServiceAgentPoolProfile



SYNOPSIS

Adds a container service agent pool profile.





SYNTAX

Add-AzureRmContainerServiceAgentPoolProfile [-ContainerService] <PSContainerService> [[-Name] <String>] [[-Count] <Int32>] [[-VmSize] <String>]

[[-DnsPrefix] <String>] [-DefaultProfile <IAzureContextContainer>] [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

The Add-AzureRmContainerServiceAgentPoolProfile cmdlet adds a container service agent pool profile to a local container service object.





PARAMETERS

-ContainerService <PSContainerService>

Specifies the container service object to which this cmdlet adds an agent pool profile. To obtain a ContainerService object, use the

New-AzureRmContainerServiceConfig (./New-AzureRmContainerServiceConfig.md)cmdlet.



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName, ByValue)

Accept wildcard characters? false



-Count <Int32>

Specifies the number of agents that host containers. The acceptable values for this parameter are: integers from 1 to 100. The default value

is 1.



Required? false

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DnsPrefix <String>

Specifies the DNS prefix that this cmdlet uses to create the fully qualified domain name for this agent pool.



Required? false

Position? 4

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Name <String>

Specifies the name of the agent pool profile. This value must be unique in the context of the subscription and resource group.



Required? false

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-VmSize <String>

Specifies the size of the virtual machines for the agents.



Required? false

Position? 3

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Shows what would happen if the cmdlet runs. The cmdlet is not run.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

ContainerService

Parameter 'ContainerService' accepts value of type 'ContainerService' from the pipeline





OUTPUTS

Microsoft.Azure.Commands.Compute.Automation.Models.PSContainerService







NOTES









Example 1: Add a profile



PS C:\\> Add-AzureRmContainerServiceAgentPoolProfile -Name "AgentPool01" -VmSize "Standard_A1" -DnsPrefix "APResourceGroup17"



This command adds a container service agent pool profile to the local container service object.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... oolprofile

New-AzureRmContainerServiceConfig

Remove-AzureRmContainerServiceAgentPoolProfile