Set-SPWordConversionServiceApplication

Référence

Module:: sharepoint-server

S’applique à:: SharePoint Server Subscription Edition

Définit les propriétés d'une application Word Automation Services.

Syntax

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

Description

L’applet Set-SPWordConversionServiceApplication de commande définit les propriétés globales d’une application Word Automation Services.

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

-----------EXEMPLE-----------------

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

Cet exemple définit la fréquence du travail du minuteur de l’application WordServices1 avec la valeur 30 minutes.

Paramètres

-ActiveProcesses

Spécifie le nombre de conversions sur chaque machine sur laquelle l’application de service s’exécute. Cette valeur est équivalente au nombre de conversions simultanées. La valeur par défaut est 8.

Le type doit correspondre à un nombre entier valide compris entre 1 et 1000.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AddSupportedFormats

Spécifie un ensemble de formats de fichiers que l’application de service peut utiliser.

La valeur doit être une liste délimitée par des virgules comprenant un ou plusieurs des éléments suivants : 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 Subscription Edition

-ApplicationPool

Spécifie le pool d’applications existantes gérées par IIS, dans lequel cette instance de Word Automation Services s’exécute.

Le type doit correspondre à un GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh, un nom de pool d’applications valide (par exemple, AppPoolName1) ou une instance d’un objet IISWebServiceApplicationPool valide.

Type:	SPIisWebServiceApplicationPoolPipeBind
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ClearSupportedFormats

Spécifie que tous les formats de fichiers doivent être désactivés en vue de leur utilisation par l’application de service.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Confirm

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : 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 Subscription Edition

-ConversionsPerInstance

Spécifie le nombre d’éléments envoyés à chaque conversion (voir plus haut la description du paramètre ActiveProcesses) chaque fois que le travail du minuteur s’exécute. La valeur par défaut est 12.

Le type doit correspondre à un entier valide.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ConversionTimeout

Spécifie la durée, en minutes, après laquelle une conversion marquée InProgress est confirmée comme étant toujours en cours d’exécution chaque fois que le travail du minuteur s’exécute et, si nécessaire, la conversion est redémarrée. La valeur par défaut est 5.

Le type doit correspondre à un nombre entier valide compris entre 1 et 60.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabaseCredential

Spécifie les informations d’authentification à utiliser pour se connecter à la base de données de l’application Word Automation Services. Utilisez ce paramètre uniquement si l’authentification SQL est utilisée pour accéder à la base de données de l’application de service.

Si le paramètre DatabaseCredential est spécifié, les paramètres DatabaseName et DatabaseServer sont obligatoires.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabaseName

Spécifie le nom de la base de données à utiliser pour cette instance de l’application Word Automation Services.

Le type doit correspondre à un nom de base de données SQL valide, par exemple MetadataDB1.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabaseServer

Spécifie le nom du serveur hôte pour la base de données Word Automation Services.

Le type doit correspondre à un nom d'hôte de serveur de base de données SQL valide (par exemple, SQLServerHost1).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DisableBinaryFileScan

Spécifie si des vérifications supplémentaires sont exécutées lors du traitement des documents Word. Ne désactivez ce paramètre que si tous les documents traités par le service sont approuvés.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DisableEmbeddedFonts

Spécifie si les polices incorporées sont ignorées lorsqu’elles sont présentes dans les documents en entrée.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Identity

Spécifie l’application Word Automation Services à mettre à jour.

Le type doit correspondre à un GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh, à un nom valide d’application Word Automation Services (par exemple, WordSvcApp1) ou à une instance d’un objet SPServiceApplication valide.

Type:	WordServiceApplicationPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-KeepAliveTimeout

Spécifie la durée, en secondes, pendant laquelle une conversion peut ne pas réagir avant d’être terminée. La valeur par défaut est de 30.

Le type doit correspondre à un nombre entier valide compris entre 10 et 60.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-MaximumConversionAttempts

Nombre maximal de tentatives de conversion avant qu’une conversion ne soit marquée avec le statut « Échec ». La valeur par défaut est 2.

Le type doit correspondre à un nombre entier valide compris entre 1 et 10.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-MaximumConversionTime

Spécifie la durée maximale, en secondes, pendant laquelle une conversion peut s’exécuter avant d’être terminée. La valeur par défaut est 300.

Le type doit correspondre à un nombre entier valide compris entre 60 et MaxInt.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-MaximumGroupSize

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-MaximumMemoryUsage

Spécifie le pourcentage maximal de mémoire système qui peut être utilisé par l’application de service. La valeur par défaut est 100.

Le type doit correspondre à un nombre entier valide compris entre 10 et 100.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-MaximumSyncConversionRequests

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-RecycleProcessThreshold

Spécifie le nombre de documents qui sont convertis avant qu’une conversion ne soit recyclée. Pour plus d’informations sur le processus de conversion, voir plus haut la description du paramètre ActiveProcess.