Partager via

Set-SPWordConversionServiceApplication

Module:
SharePointServer module

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

Syntaxe

Default (Par défaut) 

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

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AddSupportedFormats

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ApplicationPool

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:SPIisWebServiceApplicationPoolPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AssignmentCollection

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:SPAssignmentCollection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ClearSupportedFormats

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ConversionsPerInstance

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ConversionTimeout

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DatabaseCredential

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:PSCredential
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DatabaseName

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DatabaseServer

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DisableBinaryFileScan

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DisableEmbeddedFonts

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:WordServiceApplicationPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-KeepAliveTimeout

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaximumConversionAttempts

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaximumConversionTime

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaximumGroupSize

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

{{Fill MaximumGroupSize Description}}

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaximumMemoryUsage

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-MaximumSyncConversionRequests

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

{{Fill MaximumSyncConversionRequests Description}}

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RecycleProcessThreshold

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

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

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RemoveSupportedFormats

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie un ensemble de formats de fichiers que l’application de service ne peut pas 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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-TimerJobFrequency

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Spécifie la fréquence, en minutes, à laquelle le travail du minuteur de l’application de service s’exécute. Par défaut, la valeur 15 s’applique.

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

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.