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.