Set-AzureEndpoint

  • Riferimento
Modulo:
Azure

Modifica un endpoint assegnato 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

Set-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>]

Descrizione

Il cmdlet Set-AzureEndpoint modifica un endpoint assegnato a una macchina virtuale di Azure. È possibile specificare le modifiche apportate a un endpoint che non è con carico bilanciato.

Esempio

Esempio 1: Modificare un endpoint per l'ascolto su una porta

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Set-AzureEndpoint -Name "Web" -PublicPort 443 -LocalPort 443 -Protocol tcp | 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 modifica l'endpoint denominato Web per l'ascolto sulla porta 443. Il comando passa l'oggetto macchina virtuale al cmdlet Update-AzureVM , che implementa le modifiche.

Parametri

-ACL

Specifica un oggetto di configurazione dell'elenco di controllo di accesso (ACL) applicato all'endpoint.

Tipo:NetworkAclObject
Posizione:Named
Valore predefinito:None
Necessario:False
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

-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:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome dell'endpoint.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
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:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PublicPort

Specifica la porta pubblica usata dall'endpoint.

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