Set-UMService

 

S’applique à :Exchange Server 2016

Dernière rubrique modifiée :2016-04-08

Cette cmdlet est disponible uniquement dans Exchange Server 2016 sur site.

La cmdlet Set-UMService permet de modifier les propriétés du service de messagerie unifiée Microsoft Exchange sur des serveurs Exchange de votre organisation. Le service de messagerie unifiée existe sur des serveurs de boîtes aux lettres Exchange Server 2016 et Exchange Server 2013, et sur des serveurs de messagerie unifiée Exchange Server 2010.

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

Set-UMService -Identity <UMServerIdParameter> [-Confirm [<SwitchParameter>]] [-DialPlans <MultiValuedProperty>] [-DomainController <Fqdn>] [-GrammarGenerationSchedule <ScheduleInterval[]>] [-IPAddressFamily <IPv4Only | IPv6Only | Any>] [-IPAddressFamilyConfigurable <$true | $false>] [-IrmLogEnabled <$true | $false>] [-IrmLogMaxAge <EnhancedTimeSpan>] [-IrmLogMaxDirectorySize <Unlimited>] [-IrmLogMaxFileSize <ByteQuantifiedSize>] [-IrmLogPath <LocalLongFullPath>] [-MaxCallsAllowed <Int32>] [-SIPAccessService <ProtocolConnectionSettings>] [-Status <Enabled | Disabled | NoNewCalls>] [-UMStartupMode <TCP | TLS | Dual>] [-WhatIf [<SwitchParameter>]]

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.

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

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

Set-UMService -Identity MyUMServer -DialPlans $null

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 en tant que nom de domaine complet pour le service d’accès SIP utilisé par MicrosoftLync Server ou Skype Entreprise Server pour les appels entrants et sortants depuis des 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.

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

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir l’entrée « Service de messagerie unifiée (principal) » dans la rubrique Autorisations de messagerie unifiée.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.UMServerIdParameter

Le paramètre Identity spécifie le serveur Exchange qui héberge le service de messagerie unifiée que vous voulez modifier. Par exemple :

Vous pouvez utiliser n’importe quelle valeur qui identifie le serveur Exchange de manière unique. Par exemple :

  • Nom

  • Nom unique

  • ExchangeLegacyDN

  • GUID

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm 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 cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets 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.

DialPlans

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre DialPlans spécifie tous les plans de numérotation pour lesquels le service de messagerie unifiée traite 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 ils 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 aux 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 saisir plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : <value1>,<value2>.... Si les valeurs contiennent des espaces ou requièrent des guillemets, vous devez utiliser la syntaxe suivante : "<value1>","<value2>"....

Pour ajouter ou supprimer une ou plusieurs valeur(s) sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="<value1>","<value2>"...; Remove="<value1>","<value2>"...}.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

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.

GrammarGenerationSchedule

Facultatif

Microsoft.Exchange.Common.ScheduleInterval[]

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.

IPAddressFamily

Facultatif

Microsoft.Exchange.Data.Directory.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 :

  • IPv4

  • IPv6

  • Any   Le protocole IPv6 est utilisé en premier et, si nécessaire, la passerelle IP de messagerie unifiée se reporte sur IPv4. Il s’agit de la valeur par défaut.

IPAddressFamilyConfigurable

Facultatif

System.Boolean

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.

IrmLogEnabled

Facultatif

System.Boolean

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 :

  • $true   Activer l’enregistrement IRM

  • $false   Désactiver l'enregistrement IRM

IrmLogMaxAge

Facultatif

Microsoft.Exchange.Data.EnhancedTimeSpan

‎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 30 jours.

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

La plage d’entrée valide pour ce paramètre s’étend de 00:00:00 à 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.

IrmLogMaxDirectorySize

Facultatif

Microsoft.Exchange.Data.Unlimited

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

Lorsque vous entrez une valeur, qualifiez-la à l’aide de l’une des unités suivantes :

  • B (octets)

  • KB (kilo-octets)

  • MB (mégaoctets)

  • GB (gigaoctets)

  • TB (téraoctets)

Les valeurs non qualifiées sont généralement traitées comme des octets, mais les petites valeurs peuvent être arrondies au kilo-octet le plus proche.

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

IrmLogMaxFileSize

Facultatif

Microsoft.Exchange.Data.ByteQuantifiedSize

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.

Lorsque vous entrez une valeur, qualifiez-la à l’aide de l’une des unités suivantes :

  • B (octets)

  • KB (kilo-octets)

  • MB (mégaoctets)

  • GB (gigaoctets)

  • TB (téraoctets)

Les valeurs non qualifiées sont généralement traitées comme des octets, mais les petites valeurs peuvent être arrondies au kilo-octet le plus proche.

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.

IrmLogPath

Facultatif

Microsoft.Exchange.Data.LocalLongFullPath

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 d’application. Le meilleur moyen de désactiver l’enregistrement IRM est de définir le paramètre IrmLogEnabled sur $false.

MaxCallsAllowed

Facultatif

System.Int32

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.

SIPAccessService

Facultatif

Microsoft.Exchange.Data.ProtocolConnectionSettings

Le paramètre SIPAccessService spécifie le nom de domaine complet et le port TCP le plus proche de l’emplacement du pool Lync Server ou Skype Entreprise Server pour les appels entrants et sortants émis par des utilisateurs Lync ou Skype Entreprise distants situés hors du réseau. Lorsque ce paramètre n’est pas défini, le service de messagerie unifiée MicrosoftExchange peut sélectionner un pool Lync Server ou un pool Skype Entreprise Server pour le trafic de support du protocole RTP qui n’est pas le plus proche, géographiquement parlant, de l’utilisateur distant.

Ce paramètre est optionnel lorsque vous configurez la messagerie unifiée avec des déploiements à pool Lync Server ou Skype Entreprise Server unique. Cependant, il est recommandé de spécifier ce paramètre pour les déploiements de Lync Server ou Skype Entreprise Server s’étendant sur plusieurs régions géographiques. Ce paramètre est défini sur une base de service de messagerie unifiée et doit pointer vers le pool Lync Server ou le pool Skype Entreprise Server qui est géographiquement le plus proche du serveur Exchange.

Status

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.ServerStatus

Le paramètre Status sera supprimé des versions futures du produit.

UMStartupMode

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMStartupMode

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

  • TCP   Il s’agit de la valeur par défaut.

  • TLS

  • Dual   Le service peut écouter en même temps sur les ports 5060 et 5061. Si vous ajoutez le serveur Exchange aux plans de numérotation de messagerie unifiée ayant 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.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

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.

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.

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.

 
Afficher: