Get-ASAppServiceEndpoint

Get-ASAppServiceEndpoint

Ottiene informazioni sugli endpoint esposti dal servizio specificato.

Sintassi

Parameter Set: SiteNameAndVirtualPath
Get-ASAppServiceEndpoint [-SiteName] <String> [-VirtualPath] <String> [ <CommonParameters>]

Parameter Set: ServiceObject
Get-ASAppServiceEndpoint -ServiceObject <ServiceInfo> [ <CommonParameters>]

Parameter Set: Uri
Get-ASAppServiceEndpoint [-Uri] <Uri> [ <CommonParameters>]

Descrizione dettagliata

Il cmdlet restituisce gli endpoint di sistema, gli endpoint predefiniti dell'applicazione e gli endpoint dell'applicazione definiti in un file Web.config. Un endpoint di sistema è un endpoint aggiunto automaticamente al servizio dal sistema AppFabric. Un endpoint predefinito dell'applicazione è l'endpoint aggiunto all'applicazione in base ai protocolli supportati nell'applicazione stessa. Un endpoint di applicazione è l'endpoint definito in un file Web.config. Tutti gli altri endpoint che vengono creati in modo dinamico durante l'esecuzione mediante il codice non vengono restituiti.

I tipi di endpoint di sistema vengono definiti nella sezione endpointExtensions del file machine.config (ad esempio, discoveryEndpoint). Esiste, tuttavia, un'eccezione a questa regola per workflowControlEndpoint e serviceMetadataEndpoint. Il primo endpoint viene aggiunto al servizio quando si abilita il controllo dell'istanza mediante il cmdlet Set-ASInstanceManagement o dalla scheda Gestione host flusso di lavoro della finestra di dialogo Configura servizio. Il secondo endpoint viene aggiunto quando si abilita l'accesso ai metadati su HTTP dalla finestra di dialogo Configura servizio.

.NET Framework 4.0 aggiunge un endpoint predefinito dell'applicazione per tutti i servizi senza tag di un'applicazione Web per ciascun protocollo abilitato nell'applicazione. Se, ad esempio, è abilitato il protocollo HTTP per un'applicazione, al servizio viene aggiunto un endpoint con basicHttpBinding e se è abilitato il protocollo net.pipe per un'applicazione, al servizio viene aggiunto un endpoint con netNamedPipeBinding. Nella sezione protocolMapping di Machine.config è inoltre possibile configurare il mapping binding a protocollo. Per visualizzare i protocolli abilitati per un'applicazione, fare clic con il pulsante destro del mouse sul nome dell'applicazione nella visualizzazione albero Gestione IIS, scegliere Gestisci applicazione, quindi Impostazioni avanzate.

Questo cmdlet non consente di configurare gli endpoint di sistema e gli endpoint di applicazione predefiniti, ma permette di configurare gli endpoint di applicazione specificati in un file Web.config.

Il controllo Tipo di endpoint nell'output di questo cmdlet visualizza Sistema per gli endpoint di sistema, Predefinito per gli endpoint predefiniti dell'applicazione e Configurato per gli endpoint dell'applicazione configurati in un file di configurazione.

Parametri

-ServiceObject<ServiceInfo>

Nome di ServiceObject, che specifica che il cmdlet opererà sul servizio indicato. Questo parametro viene utilizzato per il piping dell'output del cmdlet Get-ASAppService a un cmdlet contenente il parametro ServiceObject.

-SiteName<String>

Nome di un sito Web, come definito nel riquadro Connessioni IIS, che specifica che il cmdlet opererà nell'ambito di quel sito o nell'ambito di un'applicazione, di una directory virtuale o di un servizio contenuto all'interno di quel sito. È necessario aggiungere al parametro SiteName il parametro VirtualPath, che identifica un'applicazione, una directory o un servizio incluso nel sito.

Il percorso virtuale di un'applicazione o di una directory virtuale include il nome dell'applicazione come definito in IIS. Il percorso virtuale per un servizio include il nome dell'applicazione, una barra e il nome del file SVC o del file XAMLX per il servizio. Il parametro VirtualPath non è necessario per l'ambito del sito. Il carattere "/" all'inizio del percorso virtuale è facoltativo. Se si utilizza il parametro SiteName, non utilizzare il parametro Uri.

-Uri<Uri>

URI per un sito IIS, un'applicazione, una directory virtuale o un servizio che specifica che il cmdlet opererà nell'ambito specificato. Se si utilizza il parametro Uri, non utilizzare il parametro SiteName oppure il set di parametri SiteName e VirtualPath.

-VirtualPath<String>

Percorso virtuale per un'applicazione, una directory o un servizio, come definito nel riquadro Connessioni di Gestione IIS, che specifica che il cmdlet opererà nell'ambito dell'applicazione, della directory virtuale o del servizio. È necessario aggiungere il parametro VirtualPath al parametro SiteName, tramite SiteName per identificare il sito in cui è contenuta l'applicazione, la directory o il servizio. Il carattere "/" all'inizio del percorso virtuale è facoltativo.

Il percorso virtuale di un'applicazione include il nome dell'applicazione come definito in IIS. Il percorso virtuale per un servizio include il nome dell'applicazione, una barra e il nome del file SVC o del file XAMLX per il servizio. Se si utilizza il set di parametri SiteName e VirtualName, non utilizzare il parametro Uri.

<CommonParameters>

Questo cmdlet supporta i parametri comuni: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_CommonParameters

Input

Il tipo di input corrisponde al tipo di oggetti che è possibile inviare al cmdlet.

• ServiceInfo

Output

Il tipo di output corrisponde al tipo di oggetti emesso dal cmdlet.

• None.

Esempi

Esempio 1

Questo comando ottiene gli endpoint per un servizio denominato MyWFService.

get-asappserviceendpoint -sitename "Default Web Site" -virtualpath /MyWFService/Service1.xamlx
//
//sample output
Name :
Address :
Binding : basicHttpBinding
Contract : *
Kind :
BindingConfiguration :
EndpointConfiguration :
SiteName : Default Web Site
ServiceVirtualPath : /MyWFService/Service1.xamlx
IsLocal : False
IsBindingConfigurationLocal :
EndpointType : Default
//
//
Name :
Address :
Binding : serviceMetadataHttpGetBinding
Contract : serviceMetadataHttpGetContract
Kind :
BindingConfiguration :
EndpointConfiguration :
SiteName : Default Web Site
ServiceVirtualPath : /MyWFService/Service1.xamlx
IsLocal : True
IsBindingConfigurationLocal :
EndpointType : System
//
//
Name :
Address :
Binding : netNamedPipeBinding
Contract : System.ServiceModel.Activities.IWorkflowInstanceManagement
Kind :
BindingConfiguration :
EndpointConfiguration :
SiteName : Default Web Site
ServiceVirtualPath : /MyWFService/Service1.xamlx
IsLocal : False
IsBindingConfigurationLocal :
EndpointType : System