Set-UmServer

Cette applet de commande est disponible uniquement dans Exchange Server 2010.

Utilisez l’applet de commande Set-UMServer pour modifier les paramètres associés au rôle serveur de messagerie unifiée( UM).

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-UmServer
   [-Identity] <UMServerIdParameter>
   [-Confirm]
   [-DialPlans <MultiValuedProperty>]
   [-DomainController <Fqdn>]
   [-ExternalServiceFqdn <UMSmartHost>]
   [-GrammarGenerationSchedule <ScheduleInterval[]>]
   [-IrmLogEnabled <Boolean>]
   [-IrmLogMaxAge <EnhancedTimeSpan>]
   [-IrmLogMaxDirectorySize <Unlimited>]
   [-IrmLogMaxFileSize <ByteQuantifiedSize>]
   [-IrmLogPath <LocalLongFullPath>]
   [-MaxCallsAllowed <Int32>]
   [-SIPAccessService <ProtocolConnectionSettings>]
   [-SipTcpListeningPort <Int32>]
   [-SipTlsListeningPort <Int32>]
   [-Status <ServerStatus>]
   [-UMStartupMode <UMStartupMode>]
   [-WhatIf]
   [<CommonParameters>]

Description

L’applet de commande Set-UMServer définit des propriétés spécifiques sur un serveur de messagerie unifiée. Cette applet de commande peut être utilisée pour définir des paramètres de messagerie unifiée individuels pour un serveur de messagerie unifiée spécifié.

Une fois cette tâche terminée, la cmdlet définit les paramètres et les valeurs spécifiés.

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-UMServer -Identity MyUMServer -Status NoNewCalls

Cet exemple empêche le serveur de messagerie unifiée MyUMServer d’accepter de nouveaux appels.

Exemple 2

Set-UMServer -Identity MyUMServer -DialPlans $null

Cet exemple supprime le serveur de messagerie unifiée MyUMServer de tous les plans de numérotation de messagerie unifiée.

Exemple 3

Set-UMServer -Identity MyUMServer -DialPlans MyUMDialPlanName -MaxCallsAllowed 50

Cet exemple ajoute le serveur de messagerie unifiée MyUMServer au plan de numérotation de messagerie unifiée MyUMDialPlanName et définit également le nombre maximal d’appels vocaux entrants sur 50.

Exemple 4

Set-UMServer -Identity MyUMServer -GrammarGenerationSchedule 0.02:30-1.03:00,1.02:30-1.03:00,2.02:30-2.03:00,3.02:30-3.03:00,4.02:30-4.03:00,5.02:30-5.03:00,6.02:30-6.03:00

Cet exemple modifie la planification de génération de grammaire en 02:30-03:00 tous les jours sur le serveur de messagerie unifiée MyUMServer.

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 2010

-DialPlans

Le paramètre DialPlans spécifie tous les plans de numérotation pour lesquels ce serveur gérera les appels de messagerie unifiée. Si aucun plan de numérotation n’est défini, le serveur de messagerie unifiée ne gère pas les appels de messagerie unifiée.

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

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

-ExternalServiceFqdn

Le paramètre ExternalServiceFqdn est le nom de domaine complet ou le nom d’hôte d’un équilibreur de charge qui entretient des serveurs de messagerie unifiée. Ce paramètre est utile lorsque vous migrez des serveurs de messagerie unifiée de votre organisation vers un environnement hébergé Microsoft Exchange Server 2010. Le nom de domaine complet de l’hôte de service externe peut contenir jusqu’à 2 048 caractères.

Type:UMSmartHost
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

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

-Identity

Le paramètre Identity spécifie le serveur de messagerie unifiée que vous souhaitez modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :

  • Nom
  • GUID
  • Nom unique (DN)
  • ExchangeLegacyDN
Type:UMServerIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

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

-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 valeur sous la forme d’un intervalle de temps : dd.hh:mm:ss, où d = jours, h = heures, m = minutes et s = 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 2010

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

Les valeurs non qualifiées sont traitées comme des octets. 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 2010

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

Les valeurs non qualifiées sont traitées comme des octets. 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 2010

-IrmLogPath

Le paramètre IrmLogPath spécifie l'emplacement du répertoire des journaux IRM par défaut. La valeur par défaut est C:\Program Files\Microsoft\Exchange Server\V14. Si vous définissez la valeur du paramètre IrmLogPath sur $null, vous désactivez effectivement l'enregistrement IRM. Toutefois, si vous définissez la valeur du paramètre IrmLogPath sur $null lorsque la valeur de l’attribut IrmLogEnabled est $true, Exchange journalisera les erreurs dans le journal des événements de l’application. La meilleure façon de désactiver la journalisation IRM consiste à 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 2010

-MaxCallsAllowed

Le paramètre MaxCallsAllowed spécifie le nombre maximal d’appels vocaux simultanés autorisés par le serveur de messagerie unifiée.

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

-SIPAccessService

Le paramètre SIPAccessService spécifie le nom de domaine complet et le port TCP du pool Lync Server Edge le plus proche ou de l’emplacement du pool edge Skype Entreprise Server pour les appels entrants et sortants à partir 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 serveur de messagerie unifiée 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 serveur de messagerie unifiée afin que la valeur identifie le pool Edge Lync Server ou Skype Entreprise Server Pool Edge 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 2010

-SipTcpListeningPort

Le paramètre SipTcpListeningPort spécifie le port TCP utilisé par le serveur de messagerie unifiée pour recevoir les appels entrants. Ce port TCP est utilisé par les serveurs de messagerie unifiée ajoutés à un plan de numérotation de messagerie unifiée qui n’est pas configuré pour utiliser le mode SIP sécurisé ou sécurisé. Le port par défaut est 5060.

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

-SipTlsListeningPort

Le paramètre SipTlsListeningPort spécifie le port TLS (Transport Layer Security) utilisé par le serveur de messagerie unifiée pour recevoir les appels entrants. Ce port TLS est utilisé par les serveurs de messagerie unifiée qui sont ajoutés à un plan de numérotation de messagerie unifiée configuré pour utiliser le mode SIP sécurisé ou sécurisé. Le port par défaut est 5061.

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

-Status

Le paramètre Status spécifie l’état du serveur de messagerie unifiée. Les options disponibles sont Enabled, Disabled et NoNewCalls.

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

-UMStartupMode

Le paramètre UMStartupMode spécifie si le service de messagerie unifiée Exchange Microsoft sur un serveur de messagerie unifiée démarre en mode TCP, TLS ou double. Si le serveur de messagerie unifiée est ajouté aux plans de numérotation de messagerie unifiée qui ont des paramètres de sécurité différents, vous devez choisir le mode double. En mode double, le serveur de messagerie unifiée peut écouter simultanément sur les ports 5060 et 5061. Si le mode de démarrage est modifié, le service de messagerie unifiée Exchange Microsoft doit être redémarré.

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

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

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.