Set-UMService

La cmdlet est disponible uniquement dans Exchange en local.

Utilisez l’applet de commande Set-UMService pour modifier les propriétés du service de messagerie unifiée Exchange Microsoft sur les serveurs de boîtes aux lettres Exchange 2013 ou Exchange 2016.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

Set-UMService
   [-Identity] <UMServerIdParameter>
   [-Confirm]
   [-DialPlans <MultiValuedProperty>]
   [-DomainController <Fqdn>]
   [-GrammarGenerationSchedule <ScheduleInterval[]>]
   [-IPAddressFamily <IPAddressFamily>]
   [-IPAddressFamilyConfigurable <Boolean>]
   [-IrmLogEnabled <Boolean>]
   [-IrmLogMaxAge <EnhancedTimeSpan>]
   [-IrmLogMaxDirectorySize <Unlimited>]
   [-IrmLogMaxFileSize <ByteQuantifiedSize>]
   [-IrmLogPath <LocalLongFullPath>]
   [-MaxCallsAllowed <Int32>]
   [-SIPAccessService <ProtocolConnectionSettings>]
   [-Status <ServerStatus>]
   [-UMStartupMode <UMStartupMode>]
   [-WhatIf]
   [<CommonParameters>]

Description

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Set-UMService -Identity MyUMServer -IPAddressFamily Any -UMStartupMode Dual

Cet exemple exécute les actions suivantes :

  • Active le service de messagerie unifiée Microsoft Exchange dans le serveur de boîtes aux lettres MyUMServer pour accepter les paquets de données IPv4 et IPv6.
  • Active le service de messagerie unifiée Microsoft Exchange dans le serveur de boîtes aux lettres MyUMServer pour commencer à utiliser les modes TCP et TLS.

Exemple 2

Set-UMService -Identity MyUMServer -DialPlans $null

Cet exemple supprime le serveur de boîte aux lettres MyUMServer de tous les plans de numérotation de messagerie unifiée.

Exemple 3

Set-UMService -Identity MyUMServer -DialPlans MySIPDialPlan -MaxCallsAllowed 50 -SipAccessService northamerica.lyncpoolna.contoso.com:5061 -UMStartupMode TLS

Cet exemple exécute les actions suivantes :

  • Ajoute le serveur de boîtes aux lettres MyUMServer au plan de numérotation de messagerie unifiée MySIPDialPlan.
  • Définit le nombre maximal d’appels entrants sur 50.
  • Définit northamerica.lyncpoolna.contoso.com:5061 comme nom de domaine complet et port pour le service d’accès SIP utilisé par Microsoft Lync Server ou Skype Entreprise Server pour les appels entrants et sortants à partir de clients Lync ou Skype Entreprise distants.
  • Active le service de messagerie unifiée Microsoft Exchange dans le serveur de boîtes aux lettres MyUMServer pour lancer le mode TLS.

Paramètres

-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
  • La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-DialPlans

Le paramètre DialPlans spécifie tous les plans de numérotation dont le service de messagerie unifiée gère les appels entrants.

Les serveurs Exchange 2016 et Exchange 2013 ne peuvent pas être associés à un plan de numérotation de messagerie unifiée TelExt ou E.164, mais peuvent être associés ou ajoutés à des plans de numérotation SIP. Si vous intégrez la messagerie unifiée à Lync Server 2010, Lync Server 2013 ou Skype Entreprise Server 2015, vous devez associer ou ajouter tous les serveurs Exchange 2016 et Exchange 2013 à des plans de numérotation SIP.

Vous pouvez également utiliser ce paramètre pour associer des serveurs de messagerie unifiée Exchange 2010 à un plan de numérotation de messagerie unifiée.

Pour entrer plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : Value1,Value2,...ValueN. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".

Pour ajouter ou supprimer une ou plusieurs valeurs sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-DomainController

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-GrammarGenerationSchedule

Le paramètre GrammarGenerationSchedule spécifie les heures planifiées pour démarrer la génération de grammaire vocale. Ce paramètre n’autorise qu’une heure de démarrage par jour. L’heure planifiée par défaut pour la génération de grammaire est 14h00–14h30 heure locale chaque jour.

La syntaxe de ce paramètre est : StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM]. Vous pouvez spécifier plusieurs planifications séparées par des virgules : "Schedule1","Schedule2",..."ScheduleN".

Vous pouvez utiliser les valeurs suivantes pour les jours :

  • Nom complet du jour.
  • Nom abrégé du jour.
  • Entier compris entre 0 et 6, où 0 = Dimanche.

Vous pouvez entrer l’heure au format 24 heures et omettre la valeur AM/PM. Si vous entrez l’heure au format 12 heures, incluez un espace entre l’heure et la valeur AM/PM.

Vous pouvez combiner des formats de date/heure.

Les heures de début et de fin doivent être séparées d'au moins 15 minutes. Les minutes sont arrondies à la valeur inférieure (0, 15, 30 ou 45). Si vous spécifiez plusieurs intervalles, ils doivent être séparés d'au moins 15 minutes.

Voici quelques exemples :

  • "Dim.23:30-Lun.1:30"
  • « 6.22:00-6.22:15 » (à partir du samedi à 22h00 jusqu’au samedi à 22h15.)
  • « Dim.1:15 AM-Monday.23:00 »
  • « Lundi.4:30 AM-Lundi.5:30 AM »,"Mercredi.4:30 AM-Mercredi.5:30 AM » (Exécution le lundi et le mercredi matin de 4:30 à 5:30.)
Type:ScheduleInterval[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-Identity

Le paramètre Identity spécifie le serveur de boîtes aux lettres qui héberge la configuration du service de messagerie unifiée que vous souhaitez modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :

  • Nom
  • Nom unique
  • ExchangeLegacyDN
  • GUID
Type:UMServerIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IPAddressFamily

Le paramètre IPAddressFamily spécifie si la passerelle IP de messagerie unifiée utilisera IPv4, IPv6 ou les deux protocoles pour communiquer. Les valeurs valides sont les suivantes :

  • IPv4
  • IPv6
  • N’importe lequel : IPv6 est utilisé en premier et, si nécessaire, la passerelle IP de messagerie unifiée revient à IPv4. Il s’agit de la valeur par défaut.
Type:IPAddressFamily
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IPAddressFamilyConfigurable

Le paramètre IPAddressFamilyConfigurable indique si vous êtes en mesure de régler le IPAddressFamily paramètre à IPv6Only ou Any. La valeur par défaut est $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogEnabled

Le paramètre IrmLogEnabled spécifie si les transactions de gestion des droits relatifs à l’information (IRM) doivent être enregistrées. L’enregistrement des transactions IRM est activé par défaut. Les valeurs valides sont les suivantes :

  • $true : Activer la journalisation IRM
  • $false : Désactiver la journalisation IRM
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogMaxAge

‎Le paramètre IrmLogMaxAge spécifie l'âge maximal du fichier journal des transactions IRM. Les fichiers journaux plus anciens que la valeur spécifiée sont supprimés. La valeur par défaut est de 30 jours.

Pour spécifier une valeur, entrez-la sous forme d’une période : dd.hh:mm:ss où dd = jours, hh = heures, mm = minutes et ss = secondes.

La plage d'entrées valide pour ce paramètre est comprise entre 00:00:00 et 24855.03:14:07. La définition de la valeur du paramètre IrmLogMaxAge sur 00:00:00 empêche la suppression automatique des fichiers journaux IRM en raison de leur âge.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogMaxDirectorySize

Le paramètre IrmLogMaxDirectorySize spécifie la taille maximale de tous les journaux IRM dans le répertoire des journaux de connectivité. Si un répertoire atteint sa taille maximale de fichier, le serveur supprime d’abord les fichiers journaux les plus anciens. La valeur par défaut est 250 mégaoctets (Mo).

Une valeur valide est un nombre allant jusqu’à 1,999999999 téraoctets (2199023254528 octets) ou la valeur unlimited. La valeur par défaut est de 6 gigaoctets (6442450944 octets).

  • B (octets)
  • KB (kilo-octets)
  • MB (mégaoctets)
  • GB (gigaoctets)
  • To (téraoctets)

TB (téraoctets)

La valeur du paramètre IrmLogMaxFileSize doit être inférieure ou égale à la valeur du paramètre IrmLogMaxDirectorySize. La plage d’entrées valide pour ce paramètre s’étend de 1 à 9223372036854775807 octets. Si vous entrez une valeur unlimited, aucune limite de taille n’est imposée au répertoire du journal de connectivité.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogMaxFileSize

Le paramètre IrmLogMaxFileSize spécifie la taille maximale de chaque fichier journal IRM. Lorsqu'un fichier journal atteint sa taille maximale, un nouveau fichier journal est créé. La valeur par défaut est 10 Mo.

Une valeur valide est un nombre allant jusqu’à 1,999999999 téraoctets (2199023254528 octets) ou la valeur unlimited. La valeur par défaut est de 6 gigaoctets (6442450944 octets).

  • B (octets)
  • KB (kilo-octets)
  • MB (mégaoctets)
  • GB (gigaoctets)
  • To (téraoctets)

TB (téraoctets)

La valeur du paramètre IrmLogMaxFileSize doit être inférieure ou égale à la valeur du paramètre IrmLogMaxDirectorySize. La plage d’entrées valide pour ce paramètre s’étend de 1 à 9223372036854775807 octets. Si vous entrez une valeur unlimited, aucune limite de taille n’est imposée aux fichiers journaux IRM.

Type:ByteQuantifiedSize
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogPath

Le paramètre IrmLogPath spécifie l'emplacement du répertoire des journaux IRM par défaut. L’emplacement par défaut est %ExchangeInstallPath%IRMLogs.

Si vous définissez la valeur de ce paramètre sur $null, vous désactivez effectivement l’enregistrement IRM. Toutefois, la définition de ce paramètre sur $null lorsque la valeur du paramètre IrmLogEnabled est $true, génère des erreurs dans le journal des événements de l’application. Le meilleur moyen de désactiver l’enregistrement IRM est de définir le paramètre IrmLogEnabled sur $false.

Type:LocalLongFullPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-MaxCallsAllowed

Le paramètre MaxCallsAllowed spécifie le nombre maximal d’appels vocaux simultanés autorisé par le service de messagerie unifiée. La valeur par défaut est 100.

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

-SIPAccessService

Le paramètre SIPAccessService spécifie le nom de domaine complet et le port TCP du pool frontal Lync Server ou Skype Entreprise Server emplacement du pool frontal le plus proche pour les appels entrants et sortants provenant d’utilisateurs Lync distants ou Skype Entreprise situés en dehors du réseau.

Nous vous recommandons de toujours utiliser ce paramètre dans Lync Server ou dans les déploiements Skype Entreprise Server qui couvrent plusieurs régions géographiques; sinon, le service de messagerie unifiée Exchange Microsoft peut sélectionner un pool pour le trafic multimédia rtp (Real-Time Transport Protocol) qui n’est pas le plus proche géographiquement de l’utilisateur distant.

Vous configurez ce paramètre pour chaque instance du service de messagerie unifiée (chaque serveur Exchange) afin que la valeur identifie le pool frontal Lync Server ou Skype Entreprise Server pool frontal le plus proche du serveur Exchange.

Type:ProtocolConnectionSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-Status

Ce paramètre est obsolète et inutilisé.

Type:ServerStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-UMStartupMode

Le paramètre UMStartupMode spécifie le mode de démarrage du service de messagerie unifiée. Les valeurs valides sont les suivantes :

  • TCP (il s’agit de la valeur par défaut)
  • TLS
  • Double : le service peut écouter simultanément sur les ports 5060 et 5061. Si vous ajoutez le serveur Exchange à des plans de numérotation de messagerie unifiée qui ont des paramètres de sécurité différents, vous devez utiliser cette valeur.

Si vous modifiez la valeur de ce paramètre, vous devez redémarrer le service de messagerie unifiée.

Type:UMStartupMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

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

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.