Set-ASInstanceExceptionPolicy

Set-ASInstanceExceptionPolicy

Definisce le impostazioni del criterio di eccezione dell'istanza nell'ambito specificato.

Sintassi

Parameter Set: SiteNameAndVirtualPath
Set-ASInstanceExceptionPolicy [-SiteName] <String> [[-VirtualPath] <String> ] [-Action {<Abbandona> | <Abbandona e sospendi> | <Annulla> | <Termina>} ] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ApplicationObject
Set-ASInstanceExceptionPolicy -ApplicationObject <ApplicationInfo> [-Action {<Abbandona> | <Abbandona e sospendi> | <Annulla> | <Termina>} ] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: RootConfig
Set-ASInstanceExceptionPolicy [-Action {<Abbandona> | <Abbandona e sospendi> | <Annulla> | <Termina>} ] [-Root] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ServiceObject
Set-ASInstanceExceptionPolicy -ServiceObject <ServiceInfo> [-Action {<Abbandona> | <Abbandona e sospendi> | <Annulla> | <Termina>} ] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Uri
Set-ASInstanceExceptionPolicy [-Uri] <Uri> [-Action {<Abbandona> | <Abbandona e sospendi> | <Annulla> | <Termina>} ] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descrizione dettagliata

Questo cmdlet aggiunge l'elemento workflowUnhandledException se non esiste già nel file di configurazione associato all'ambito specificato e imposta il valore dell'attributo Action dell'elemento workflowUnhandledException.

L'attributo Action specifica l'azione che l'host del flusso di lavoro deve intraprendere quando si verifica un'eccezione non gestita per un'istanza. Sono consentiti i seguenti valori: Abbandona, Abbandona e sospendi, Termina e Annulla. Il valore predefinito è Abbandona.

Quando si utilizza il parametro –UseInherited con questo cmdlet, il cmdlet rimuove l'elemento workflowUnhandledException o l'elemento <remove name="workflowUnhandledException"> dal file di configurazione in modo che le impostazioni del criterio di eccezione dell'istanza vengano ereditate da un ambito superiore.

Parametri

-Action<WorkflowUnhandledExceptionAction>

Utilizzare il parametro Action per specificare l'azione che l'host del flusso di lavoro deve intraprendere quando si verifica un'eccezione non gestita per un'istanza. Sono consentiti i seguenti valori:

I valori accettabili per questo parametro sono:

Abbandona

Abbandona e sospendi

Annulla

Termina

Alias

nessuno

Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

false

Accettare caratteri jolly?

-ApplicationObject<ApplicationInfo>

Nome di ApplicationObject, che specifica che il cmdlet opererà sull'applicazione indicata. Questo parametro viene utilizzato per il piping dell'output del cmdlet Get-ASApplication a un cmdlet contenente il parametro ApplicationObject.

Alias

nessuno

Necessario?

true

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

true (ByValue)

Accettare caratteri jolly?

-Root

Nome dell'applicazione radice, che specifica che il cmdlet opererà nell'ambito specificato. Se si utilizza il parametro Root, non utilizzare il parametro SiteName, VirtualPath o Uri.

Alias

nessuno

Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

false

Accettare caratteri jolly?

-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.

Alias

nessuno

Necessario?

true

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

true (ByValue)

Accettare caratteri jolly?

-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 l'Uri parametro.ps_nomesito

Alias

nessuno

Necessario?

true

Posizione?

1

Valore predefinito

nessuno

Accettare input pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

-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.

Alias

nessuno

Necessario?

true

Posizione?

1

Valore predefinito

nessuno

Accettare input pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

-UseInherited

Utilizzare questo parametro per utilizzare le impostazioni ereditate dall'ambito superiore. Quando si utilizza questo parametro, il cmdlet rimuove l'elemento anyworkflowUnhandledExceptionbehavior definito al livello specificato. Il cmdlet rimuove anche qualsiasi elemento <remove name="workflowUnhandledException"> dal file di configurazione.

Alias

nessuno

Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

false

Accettare caratteri jolly?

-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, utilizzando 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.

Alias

nessuno

Necessario?

false

Posizione?

2

Valore predefinito

nessuno

Accettare input pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

-Confirm

Richiede la conferma prima dell'esecuzione del comando.

Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

false

Accettare caratteri jolly?

false

-WhatIf

Descrive cosa accadrebbe se venisse eseguito il comando senza eseguirlo effettivamente.

Necessario?

false

Posizione?

named

Valore predefinito

nessuno

Accettare input pipeline?

false

Accettare caratteri jolly?

false

<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.

  • ApplicationInfo o ServiceInfo

Esempi

Esempio 1

Il seguente comando imposta il criterio di eccezione dell'istanza a livello di radice.

Questo comando imposta il criterio di eccezione dell'istanza a livello di radice.

Set-ASInstanceExceptionPolicy –Root –Action AbandonAndSuspend

Esempio 2

Questo comando imposta il criterio di eccezione dell'istanza a livello di sito Web.

Set-ASInstanceExceptionPolicy –SiteName “Default Web Site” –Action Terminate

Esempio 3

Questi comandi impostano il criterio di eccezione dell'istanza a livello di applicazione.

Set-ASInstanceExceptionPolicy –SiteName “Default Web Site” –VirtualPath “/SampleService” –Action Abandon
Get-ASApplication –SiteName “Default Web Site” –VirtualPath “/SampleService” | Set-ASInstanceExceptionPolicy –Action Abandon

Esempio 4

Questi comandi impostano il criterio di eccezione dell'istanza a livello di servizio.

Set-ASInstanceExceptionPolicy –SiteName “Default Web Site” –VirtualPath “/SampleService/SampleService.xamlx” –Action Abandon
Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleService/SampleService.xamlx” | Set-ASInstanceExceptionPolicy –Action Abandon

Esempio 5

Questi comandi impostano il criterio di eccezione dell'istanza al livello determinato utilizzando l'URI.

Set-ASInstanceExceptionPolicy –Uri https://localhost -Action Abandon
Set-ASInstanceExceptionPolicy –Uri https://localhost/sampleservice/ -Action Abandon
Set-ASInstanceExceptionPolicy –Uri https://localhost/sampleservice/sampleservice.xamlx -Action Abandon

Esempio 6

Questo comando definisce le impostazioni del criterio di eccezione dell'istanza per tutti i servizi di un'applicazione.

Get-ASAppService –SiteName “Default Web Site” –VirtualPath “/SampleApp” | Set-ASInstanceExceptionPolicy –Action Abandon

Esempio 7

Questo comando configura un'applicazione in modo che erediti le impostazioni del criterio di eccezione dell'istanza da un ambito superiore.

Set-ASInstanceExceptionPolicy –SiteName “Default Web Site” –VirtualPath “/SampleApp” -UseInherited