Condividi tramite

Add-AzureEndpoint

  • Riferimento
Modulo:
Azure

Aggiunge un endpoint a una macchina virtuale.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   [-NoProbe]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   [-DefaultProbe]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   -ProbePort <Int32>
   -ProbeProtocol <String>
   [-ProbePath <String>]
   [-ProbeIntervalInSeconds <Int32>]
   [-ProbeTimeoutInSeconds <Int32>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Descrizione

Il cmdlet Add-AzureEndpoint aggiunge un endpoint a un oggetto macchina virtuale di Azure.

Esempio

Esempio 1: Aggiungere un endpoint

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 | Update-AzureVM

Questo comando recupera la configurazione di una macchina virtuale denominata VirtualMachine01 usando il cmdlet Get-AzureVM . Il comando lo passa al cmdlet corrente usando l'operatore pipeline. Questo cmdlet aggiunge un endpoint denominato HttpIn. L'endpoint ha una porta pubblica 80 e la porta locale 8080. Il comando passa l'oggetto macchina virtuale al cmdlet Update-AzureVM , che implementa le modifiche.

Esempio 2: Aggiungere un endpoint appartenente a un gruppo con carico bilanciato

PS C:\> Get-AzureVM -ServiceName "LoadBalancedService" -Name "VirtualMachine12" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 -LBSetName "WebFarm" -ProbePort 80 -ProbeProtocol "http" -ProbePath '/' | Update-AzureVM

Questo comando recupera la configurazione di una macchina virtuale denominata VirtualMachine07. Il cmdlet corrente aggiunge un endpoint denominato HttpIn. L'endpoint ha una porta pubblica 80 e la porta locale 8080. L'endpoint appartiene al gruppo con carico bilanciato condiviso denominato WebFarm. Un probe HTTP sulla porta 80 con un percorso "/" monitora la disponibilità dell'endpoint. Il comando implementa le modifiche.

Esempio 3: Associare un indirizzo IP virtuale a un endpoint

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine25" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -LocalPort 8080 -PublicPort 80 -VirtualIPName "ContosoVip11" | Update-AzureVM

Questo comando recupera la configurazione di una macchina virtuale denominata VirtualMachine25. Il cmdlet corrente aggiunge un endpoint denominato HttpIn. L'endpoint ha una porta pubblica 80 e la porta locale 8080. Questo comando associa un indirizzo IP virtuale all'endpoint. Il comando implementa le modifiche.

Parametri

-ACL

Specifica un oggetto di configurazione dell'elenco di controllo di accesso (ACL) per l'endpoint.

Tipo:NetworkAclObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProbe

Indica che questo cmdlet usa l'impostazione probe predefinita.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DirectServerReturn

Specifica se questo cmdlet abilita la restituzione diretta del server. Specificare $True da abilitare o $False da disabilitare.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IdleTimeoutInMinutes

Specifica il periodo di timeout di inattività TCP, espresso in minuti, per l'endpoint.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationAction

Specifica la modalità di risposta di questo cmdlet a un evento informativo.

I valori validi per questo parametro sono:

  • Continua
  • Ignora
  • Inquire
  • SilentlyContinue
  • Arresta
  • Sospendi
Tipo:ActionPreference
Alias:infa
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationVariable

Specifica una variabile di informazioni.

Tipo:String
Alias:iv
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InternalLoadBalancerName

Specifica il nome del servizio di bilanciamento del carico interno.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LBSetName

Specifica il nome del set di bilanciamento del carico per l'endpoint.

Tipo:String
Alias:LoadBalancedEndpointSetName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LoadBalancerDistribution

Specifica l'algoritmo di distribuzione del servizio di bilanciamento del carico. I valori validi sono:

  • sourceIP. Un'affinità di due tuple: IP di origine, IP di destinazione
  • sourceIPProtocol. Un'affinità di tre tuple: IP di origine, IP di destinazione, protocollo
  • nessuno. Un'affinità di cinque tuple: IP di origine, porta di origine, IP di destinazione, porta di destinazione, protocollo

Il valore predefinito non è nessuno.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LocalPort

Specifica la porta locale, privata e usata dall'endpoint. Le applicazioni all'interno della macchina virtuale sono in ascolto su questa porta per le richieste di input del servizio per questo endpoint.

Tipo:Int32
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica un nome per l'endpoint.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NoProbe

Indica che questo cmdlet usa l'impostazione nessun probe.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProbeIntervalInSeconds

Specifica l'intervallo di polling del probe, espresso in secondi, per l'endpoint.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProbePath

Specifica il percorso relativo del probe HTTP.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProbePort

Specifica la porta utilizzata dall'endpoint.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProbeProtocol

Specifica il protocollo di porta. I valori validi sono:

  • tcp
  • http
Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProbeTimeoutInSeconds

Specifica il periodo di timeout del polling del probe in secondi.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

Tipo:AzureSMProfile
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Protocol

Specifica il protocollo dell'endpoint. I valori validi sono:

  • tcp
  • udp
Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PublicPort

Specifica la porta pubblica usata dall'endpoint. Se non si specifica un valore, Azure assegna una porta disponibile.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VirtualIPName

Specifica il nome di un indirizzo IP virtuale associato da Azure all'endpoint. Il servizio può avere più indirizzi IP virtuali. Per creare indirizzi IP virtuali, usare il cmdlet Add-AzureVirtualIP .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VM

Specifica la macchina virtuale a cui appartiene l'endpoint.

Tipo:IPersistentVM
Alias:InputObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Output

Object