Set-ASInstanceManagement

Set-ASInstanceManagement

Abilita la gestione delle istanze del flusso di lavoro e/o imposta il gruppo Windows autorizzato a gestire le istanze di servizio del flusso di lavoro sull'ambito specificato.

Sintassi

Parameter Set: SiteNameAndVirtualPath
Set-ASInstanceManagement [-SiteName] <String> [[-VirtualPath] <String> ] [-AuthorizedWindowsGroup <String> ] [-EnableNetPipeProtocol] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ApplicationObject
Set-ASInstanceManagement -ApplicationObject <ApplicationInfo> [-AuthorizedWindowsGroup <String> ] [-EnableNetPipeProtocol] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: RootConfig
Set-ASInstanceManagement [-AuthorizedWindowsGroup <String> ] [-EnableNetPipeProtocol] [-Root] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ServiceObject
Set-ASInstanceManagement -ServiceObject <ServiceInfo> [-AuthorizedWindowsGroup <String> ] [-EnableNetPipeProtocol] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Uri
Set-ASInstanceManagement [-Uri] <Uri> [-AuthorizedWindowsGroup <String> ] [-EnableNetPipeProtocol] [-UseInherited] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descrizione dettagliata

Il cmdlet aggiunge l'elemento workflowInstanceManagement se questo non esiste già, quindi imposta il valore dell'attributo authorizedWindowsGroup.

Quando si utilizza il parametro -UseInherited, il cmdlet rimuove l'elemento <workflowInstanceManagement> o l'elemento <remove name=”workflowInstanceManagement”> dal file di configurazione in modo che le impostazioni del comportamento workflowInstanceManagement siano ereditate dai livelli superiori.

Parametri

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

-AuthorizedWindowsGroup<String>

Gruppo Windows autorizzato a gestire le istanze di servizio del flusso di lavoro.

-EnableNetPipeProtocol

Abilita il protocollo net.pipe per un sito Web o per un'applicazione. Se si utilizza questo parametro con un comando che viene eseguito su un servizio, il cmdlet abilita il protocollo sull'applicazione che contiene il servizio.

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

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

-UseInherited

Utilizzare questo parametro per utilizzare le impostazioni ereditate dall'ambito superiore. Quando viene utilizzato questo parametro, il cmdlet rimuove qualsiasi comportamento workflowInstanceManagement definito al livello specificato. Il cmdlet rimuove inoltre qualsiasi elemento <remove name=”workflowInstanceManagement”> dal file di configurazione.

-VirtualPath<String>

Percorso virtuale per un'applicazione, una directory o un servizio, come definito nel riquadro Connessioni di Gestione IIS, nel quale viene specificato 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 è inclusa 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.ps_virtualpath

-Confirm

Richiede la conferma prima dell'esecuzione del comando.

-WhatIf

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

<CommonParameters>

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

Esempi

Esempio 1

Il comando riportato di seguito annulla le impostazioni di gestione delle istanze del flusso di lavoro a livello di radice.

Set-ASInstanceManagement –root –AuthorizedWindowsGroup AS_Administrators

Esempio 2

Il comando riportato di seguito configura le impostazioni di gestione delle istanze del flusso di lavoro a livello di sito Web.

Set-ASInstanceManagement –SiteName “Default Web Site” –AuthorizedWindowsGroup AS_Administrators

Esempio 3

Il comando riportato di seguito annulla le impostazioni di gestione delle istanze del flusso di lavoro a livello di applicazione.

Set-ASInstanceManagement –SiteName “Default Web Site” –virtualpath “/SampleApplication” –AuthorizedWindowsGroup AS_Administrators

Esempio 4

Il comando riportato di seguito annulla le impostazioni di gestione delle istanze del flusso di lavoro a livello di servizio.

Set-ASInstanceManagement –SiteName “Default Web Site” –virtualpath “/SampleApp/SampleService.xamlx” –AuthorizedWindowsGroup AS_Administrators
Get-ASApplicationService –SiteName “Default Web Site” –VirtualPath “/SampleApp/SampleService.xamlx” | Set-ASInstanceManagement –AuthorizedWindowsGroup AS_Administrators

Esempio 5

I comandi riportati di seguito annullano le impostazioni di gestione delle istanze del flusso di lavoro a livello determinato dal valore del parametro Uri.

Set-ASAppInstanceManagement –Uri https://localhost –AuthorizedWindowsGroup AS_Administrators
Set-ASAppInstanceManagement –Uri https://localhost/SampleApp –AuthorizedWindowsGroup AS_Administrators
Set-ASAppInstanceManagement –Uri https://localhost/SampleApp/SampleService.xamlx –AuthorizedWindowsGroup AS_Administrators