New-AzureTrafficManagerProfile
Cria um perfil do Gerenciador de Tráfego.
Observação
Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.
O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
New-AzureTrafficManagerProfile
-Name <String>
-DomainName <String>
-LoadBalancingMethod <String>
-MonitorPort <Int32>
-MonitorProtocol <String>
-MonitorRelativePath <String>
-Ttl <Int32>
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
O cmdlet New-AzureTrafficManagerProfile cria um perfil do Gerenciador de Tráfego do Microsoft Azure.
Depois de criar um perfil em que você define o valor LoadBalancingMethod como "Failover", você pode determinar a ordem de failover dos pontos de extremidade adicionados ao seu perfil com o cmdlet Add-AzureTrafficManagerEndpoint. Para obter mais informações, consulte o Exemplo 2 abaixo.
Exemplos
Exemplo 1: Criar um perfil do Gerenciador de Tráfego
PS C:\>New-AzureTrafficManagerProfile -Name "MyProfile" -DomainName "My.profile.trafficmanager.net" -LoadBalancingMethod "RoundRobin" -Ttl 30 -MonitorProtocol "Http" -MonitorPort 80 -MonitorRelativePath "/"
Esse comando cria um perfil do Gerenciador de Tráfego chamado MyProfile no domínio do Gerenciador de Tráfego especificado com um método de balanceamento de carga Round Robin, um TTL de 30 segundos, protocolo de monitoramento HTTP, porta de monitoramento 80 e com o caminho especificado.
Exemplo 2: Reordenar os pontos de extremidade para a ordem de failover desejada
PS C:\>$Profile = Get-AzureTrafficManagerProfile -Name "MyProfile"
PS C:\> $Profile.Endpoints[0],$Profile.Endpoints[1] = $Profile.Endpoints[1],$Profile.Endpoints[0]
PS C:\> $Profile = Set-AzureTrafficManagerProfile
Este exemplo reordena os pontos de extremidade adicionados ao MyProfile para a ordem de failover desejada.
O primeiro comando obtém o objeto de perfil do Gerenciador de Tráfego chamado MyProfile e armazena o objeto na variável $Profile.
O segundo comando reordena os pontos de extremidade da matriz de pontos de extremidade para a ordem em que o failover deve ocorrer.
O último comando atualiza o perfil do Gerenciador de Tráfego armazenado no $Profile com a nova ordem do ponto de extremidade.
Parâmetros
-DomainName
Especifica o nome de domínio do perfil do Gerenciador de Tráfego. Este deve ser um subdomínio de trafficmanager.net.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-LoadBalancingMethod
Especifica o método de balanceamento de carga a ser usado para distribuir a conexão. Os valores válidos são:
- Desempenho
- Failover
- RoundRobin
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MonitorPort
Especifica a porta usada para monitorar a integridade do ponto de extremidade. Os valores válidos são valores inteiros maiores que 0 e menores ou iguais a 65.535.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MonitorProtocol
Especifica o protocolo a ser usado para monitorar a integridade do ponto de extremidade. Os valores válidos são:
Http
Https
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MonitorRelativePath
Especifica o caminho relativo ao nome de domínio do ponto de extremidade para investigar o estado de integridade. O caminho deve atender às seguintes restrições:
O caminho deve ter de 1 a 1000 caracteres.
Ele deve começar com uma barra, /.
Ele não deve conter elementos XML, <>.
Ele não deve conter barras duplas, //.
Ele não deve conter caracteres de escape HTML inválidos. Por exemplo, %XY.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Name
Especifica o nome do perfil do Gerenciador de Tráfego a ser criado.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Profile
Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.
Tipo: | AzureSMProfile |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Ttl
Especifica o tempo de vida (TTL) do DNS que informa aos resolvedores de DNS local por quanto tempo armazenar em cache as entradas de DNS. Os valores válidos são inteiros de 30 a 999.999.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Saídas
Microsoft.WindowsAzure.Commands.Utilities.TrafficManager.Models.IProfileWithDefinition
Esse cmdlet gera um objeto de perfil do Gerenciador de Tráfego.