Set-SPWordConversionServiceApplication

Imposta le proprietà di un'applicazione Word Automation Services.

Sintassi

Set-SPWordConversionServiceApplication
   [-Identity] <WordServiceApplicationPipeBind>
   [-ActiveProcesses <Int32>]
   [-AddSupportedFormats <String[]>]
   [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-ClearSupportedFormats]
   [-Confirm]
   [-ConversionsPerInstance <Int32>]
   [-ConversionTimeout <Int32>]
   [-DatabaseCredential <PSCredential>]
   [-DatabaseName <String>]
   [-DatabaseServer <String>]
   [-DisableBinaryFileScan]
   [-DisableEmbeddedFonts]
   [-KeepAliveTimeout <Int32>]
   [-MaximumConversionAttempts <Int32>]
   [-MaximumConversionTime <Int32>]
   [-MaximumMemoryUsage <Int32>]
   [-RecycleProcessThreshold <Int32>]
   [-RemoveSupportedFormats <String[]>]
   [-TimerJobFrequency <Int32>]
   [-WhatIf]
   [-MaximumGroupSize <Int32>]
   [-MaximumSyncConversionRequests <Int32>]
   [<CommonParameters>]

Descrizione

Il Set-SPWordConversionServiceApplication cmdlet imposta le proprietà globali di un'applicazione Word Automation Services.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

-----------ESEMPIO-----------------

Get-SPServiceApplication -Name WordServices1 | Set-SPWordConversionServiceApplication -TimerJobFrequency 30

In questo esempio viene impostata la frequenza del processo timer per l'applicazione WordServices1 su 30 minuti.

Parametri

-ActiveProcesses

Specifica il numero di processi di conversione in ogni computer in cui viene eseguita l'applicazione di servizio. Questo valore è equivalente al numero di conversioni simultanee. Il valore predefinito è 8.

Il tipo deve essere un numero intero valido compreso tra 1 e 1000.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AddSupportedFormats

Specifica un set di formati di file di cui è abilitato l'utilizzo da parte dell'applicazione di servizio.

Il valore deve essere un elenco di uno o più dei formati seguenti delimitati da virgole: docx, doc, mht, rtf, xml.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ApplicationPool

Specifica il pool di applicazioni gestito da IIS esistente in cui viene eseguita questa istanza di Word Automation Services.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un pool di applicazioni (ad esempio NomePoolApp1) oppure un'istanza di un oggetto IISWebServiceApplicationPool valido.

Type:SPIisWebServiceApplicationPoolPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ClearSupportedFormats

Specifica che tutti i formati di file devono essere disabilitati per l'utilizzo dall'applicazione di servizio.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConversionsPerInstance

Specifica il numero di elementi inviati a ogni processo di conversione (vedere la descrizione del parametro ActiveProcesses riportata in precedenza in questa tabella) ogni volta che viene eseguito il processo timer. Il valore predefinito è 12.

Il tipo deve essere un numero intero valido.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConversionTimeout

Specifica il tempo, espresso in minuti, dopo il quale viene confermata l'esecuzione di una conversione contrassegnata in InProgress ogni volta che viene eseguito il processo timer e, se necessario, la conversione viene riavviata. Il valore predefinito è 5.

Il tipo deve essere un numero intero valido compreso tra 1 e 60.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseCredential

Specifica le credenziali da utilizzare per la connessione al database per l'applicazione Word Automation Services. Utilizzare questo parametro solo se viene utilizzata l'autenticazione SQL per l'accesso al database dell'applicazione di servizio.

Quando è specificato il parametro DatabaseCredential, i parametri DatabaseName e DatabaseServer sono obbligatori.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseName

Specifica il nome del database da utilizzare per l'istanza dell'applicazione Word Automation Services.

Il tipo deve essere il nome valido di un database SQL, ad esempio DBMetadati1.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseServer

Specifica il nome del server host per il database di Word Automation Services.

Il tipo deve essere un nome host di server di database SQL valido, ad esempio SQLServerHost1.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DisableBinaryFileScan

Specifica se vengono eseguiti controlli aggiuntivi durante l'elaborazione dei documenti di Word. Disattivare questa impostazione solo se tutti i documenti elaborati dal servizio sono attendibili.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DisableEmbeddedFonts

Specifica se i tipi di caratteri incorporati vengono ignorati, se presenti nei documenti di input.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Specifica l'applicazione Word Automation Services da aggiornare.

Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh, il nome valido di un'applicazione Word Automation Services, ad esempio WordSvcApp1, oppure un'istanza di un oggetto SPServiceApplication valido.

Type:WordServiceApplicationPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-KeepAliveTimeout

Specifica il periodo di tempo, espresso in secondi, trascorso il quale una conversione che non risponde viene terminata. Il valore predefinito è 30.

Il tipo deve essere un numero intero valido compreso tra 10 e 60.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumConversionAttempts

Il numero massimo di tentativi di conversione prima che una conversione venga contrassegnata con lo stato Non riuscita. Il valore predefinito è 2.

Il tipo deve essere un numero intero valido compreso tra 1 e 10.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumConversionTime

Specifica il periodo di tempo massimo, espresso in secondi, trascorso il quale una conversione in esecuzione viene terminata. Il valore predefinito è 300.

Il tipo deve essere un numero intero valido compreso tra 60 e MaxInt.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumGroupSize

{{Fill MaximumGroupSize Description}}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumMemoryUsage

Specifica la percentuale massima della memoria di sistema che può essere utilizzata dall'applicazione di servizio. Il valore predefinito è 100.

Il tipo deve essere un numero intero valido compreso tra 10 e 100.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumSyncConversionRequests

{{Fill MaximumSyncConversionRequests Description}}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RecycleProcessThreshold

Specifica il numero di documenti che vengono convertiti prima che un processo di conversione venga riciclato. Per ulteriori informazioni sul processo di conversione, vedere la descrizione del parametro ActiveProcess riportata in precedenza in questa tabella.

Il tipo deve essere un numero intero valido compreso tra 1 e 1000.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RemoveSupportedFormats

Specifica un set di formati di file di cui è disabilitato l'utilizzo da parte dell'applicazione di servizio.

Il valore deve essere un elenco di uno o più dei formati seguenti delimitati da virgole: docx, doc, mht, rtf, xml.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-TimerJobFrequency

Specifica la frequenza, espressa in minuti, con cui viene eseguito il processo timer per l'applicazione di servizio. Il valore predefinito è 15.

Il tipo deve essere un numero intero valido compreso tra 1 e 59.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019