Set-AzureTrafficManagerEndpoint
Atualiza as propriedades de um ponto de extremidade em um perfil do Gerenciador de Tráfego.
Observação
Os cmdlets mencionados 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, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
Set-AzureTrafficManagerEndpoint
-DomainName <String>
[-Location <String>]
[-Type <String>]
[-Status <String>]
[-Weight <Int32>]
[-MinChildEndpoints <Int32>]
-TrafficManagerProfile <IProfileWithDefinition>
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
O cmdlet Set-AzureTrafficManagerEndpoint atualiza as propriedades de um ponto de extremidade em um perfil do Gerenciador de Tráfego do Microsoft Azure. Se o ponto de extremidade não existir no perfil atual, esse cmdlet o criará. Depois de adicionar um ponto de extremidade, passe o resultado para o cmdlet Set-AzureTrafficManagerProfile usando o operador de pipeline. Esse cmdlet se conecta ao Azure para salvar suas alterações.
Exemplos
Exemplo 1: Atualizar um ponto de extremidade para um perfil
PS C:\>$TrafficManagerProfile = Get-AzureTrafficManagerProfile -Name "ContosoProfile"
PS C:\> Set-AzureTrafficManagerEndpoint -TrafficManagerProfile $TrafficManagerProfile -DomainName "ContosoApp02.cloudapp.net" -Status "Enabled" -Type "CloudService" -Weight 2 -Location myLocation | Set-AzureTrafficManagerProfile
O primeiro comando usa o cmdlet Get-AzureTrafficManagerProfile para obter o perfil chamado ContosoProfile e o armazena na variável $TrafficManagerProfile.
O segundo comando atualiza o ponto de extremidade no perfil do Gerenciador de Tráfego armazenado no $TrafficManagerProfile. O ponto de extremidade tem o nome de domínio ContosoApp02.cloudapp.net. O comando também especifica o status, o tipo, a espessura e o local do ponto de extremidade. O comando passa o perfil modificado para o cmdlet Set-AzureTrafficManagerProfile para se conectar ao Azure e salvar suas alterações.
Parâmetros
-DomainName
Especifica o nome de domínio do ponto de extremidade a ser modificado.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Location
Especifica o local do ponto de extremidade adicionado pelo cmdlet. Esse deve ser um local do Azure.
Esse parâmetro deve conter um valor para pontos de extremidade do tipo "Any" ou do tipo "TrafficManager" em um perfil que tenha o método de balanceamento de carga definido como "Performance".
Os valores possíveis são os nomes de região do Azure, conforme listado em https://azure.microsoft.com/regions/https://azure.microsoft.com/regions/
.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MinChildEndpoints
Especifica o número mínimo de pontos de extremidade que o perfil aninhado deve ter online para que esse ponto de extremidade seja considerado online.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do 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 |
-Status
Especifica o status do ponto de extremidade de monitoramento. Os valores válidos são:
- Enabled
- Desabilitado
Se você especificar um valor de Habilitado, o Gerenciador de Tráfego monitorará o ponto de extremidade e o método de balanceamento de carga o considerará ao gerenciar o tráfego.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-TrafficManagerProfile
Especifica o objeto de perfil do Gerenciador de Tráfego para o qual modificar o ponto de extremidade.
Tipo: | IProfileWithDefinition |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Type
Especifica o tipo de ponto de extremidade. Os valores válidos são:
CloudService
AzureWebsite
TrafficManager
Qualquer
Se houver mais de um ponto de extremidade do AzureWebsite, os pontos de extremidade deverão estar em datacenters diferentes.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Weight
Especifica o peso do ponto de extremidade adicionado pelo cmdlet. O intervalo de valores válido para esse parâmetro é [1.1000].
Esse parâmetro é usado apenas para políticas de balanceamento de carga RoundRobin.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
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, que contém informações sobre o perfil atualizado.