Set-UmServer

Dieses Cmdlet ist nur in Exchange Server 2010 verfügbar.

Verwenden Sie das Cmdlet Set-UMServer, um Einstellungen zu ändern, die der Unified Messaging-Serverrolle (UM) zugeordnet sind.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

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

Beschreibung

Das cmdlet Set-UMServer legt bestimmte Eigenschaften auf einem Unified Messaging-Server fest. Dieses Cmdlet kann verwendet werden, um einzelne Unified Messaging-Parameter für einen angegebenen Unified Messaging-Server festzulegen.

Nach Abschluss dieses Tasks legt das Cmdlet die Parameter und die angegebenen Werte fest.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Set-UMServer -Identity MyUMServer -Status NoNewCalls

In diesem Beispiel wird verhindert, dass der Unified Messaging-Server MyUMServer neue Anrufe akzeptiert.

Beispiel 2

Set-UMServer -Identity MyUMServer -DialPlans $null

In diesem Beispiel wird der Unified Messaging-Server MyUMServer aus allen UM-Wählplänen entfernt.

Beispiel 3

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

In diesem Beispiel wird der Unified Messaging-Server MyUMServer dem UM-Wählplan MyUMDialPlanName hinzugefügt und die maximale Anzahl eingehender Sprachanrufe auf 50 festgelegt.

Beispiel 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

In diesem Beispiel wird der Zeitplan für die Grammatikgenerierung auf dem Unified Messaging-Server MyUMServer täglich in 02:30-03:00 geändert.

Parameter

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
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

Der Parameter DialPlans gibt alle Wählpläne an, für die dieser Server UM-Anrufe verarbeitet. Wenn keine Wählpläne definiert sind, verarbeitet der Unified Messaging-Server keine UM-Anrufe.

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

-DomainController

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: 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

Der Parameter ExternalServiceFqdn ist der FQDN oder Der Hostname eines Lastenausgleichs, der Unified Messaging-Server bedient. Dieser Parameter ist nützlich, wenn Sie Unified Messaging-Server aus Ihrer Organisation zu einer Microsoft Exchange Server 2010 gehosteten Umgebung migrieren. Der FQDN des externen Diensthosts kann bis zu 2.048 Zeichen enthalten.

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

-GrammarGenerationSchedule

Der Parameter GrammarGenerationSchedule gibt die geplanten Uhrzeiten für den Start der Sprachgrammatikgenerierung an. Dieser Parameter lässt nur eine Startzeit pro Tag zu. Die geplante Standardzeit für die Grammatikgenerierung ist 02:00-02:30 Ortszeit jeden Tag.

Die Syntax für diesen Parameter lautet: StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM]. Sie können mehrere Zeitpläne angeben, die durch Kommas getrennt sind: "Schedule1","Schedule2",..."ScheduleN".

Sie können die folgenden Werte für Tage verwenden:

  • Vollständiger Name des Tages.
  • Abgekürzter Name des Tages.
  • Ganze Zahl von 0 bis 6, wobei 0 = Sonntag.

Sie können die Uhrzeit im 24-Stunden-Format eingeben und den AM/PM-Wert weglassen. Wenn Sie die Zeit im 12-Stunden-Format eingeben, fügen Sie ein Leerzeichen zwischen der Uhrzeit und dem AM/PM-Wert ein.

Sie können Datums-/Uhrzeitformate kombinieren und abgleichen.

Zwischen Start- und Endzeit müssen mindestens 15 Minuten liegen. Minuten werden auf 0, 15, 30 oder 45 abgerundet. Wenn Sie mehrere Intervalle angeben, müssen zwischen den einzelnen Intervallen mindestens 15 Minuten liegen.

Hier sind einige Beispiele:

  • "So.23:30-Mo.1:30"
  • "6.22:00-6.22:15" (Ausführung von Samstag um 22:00 Uhr bis Samstag um 22:15 Uhr.)
  • "So.1:15 AM-Monday.23:00"
  • "Monday.4:30 AM-Monday.5:30 AM","Wednesday.4:30 AM-Wednesday.5:30 AM" (Ausführung montags und mittwochs von 4:30 bis 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

Der Parameter Identity gibt den Unified Messaging-Server an, den Sie ändern möchten. Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:

  • Name
  • GUID
  • Distinguished Name (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

Der Parameter IrmLogEnabled gibt an, ob für IRM-Transaktionen (Information Rights Management, Verwaltung von Informationsrechten) die Protokollierung aktiviert wird. Die IRM-Protokollierung ist standardmäßig aktiviert. Gültige Werte schließen ein:

  • $true Aktivieren der IRM-Protokollierung
  • $false Deaktivieren der IRM-Protokollierung
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-IrmLogMaxAge

Der Parameter IrmLogMaxAge gibt das maximale Alter der IRM-Protokolldatei an. Protokolldateien, die älter sind als der angegebene Wert, werden gelöscht. Die Standardeinstellung beträgt 30 Tage. Um einen Wert anzugeben, geben Sie den Wert als Zeitspanne ein: dd.hh:mm:ss, wobei d = Tage, h = Stunden, m = Minuten und s = Sekunden. Der gültige Eingabebereich für diesen Parameter liegt zwischen 00:00:00 und 24855.03:14:07. Wenn Sie den Wert des Parameters IrmLogMaxAge auf 00:00:00 festlegen, wird die automatische Entfernung der IRM-Protokolldateien aufgrund ihres Alters verhindert.

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

-IrmLogMaxDirectorySize

Der Parameter IrmLogMaxDirectorySize gibt die maximale Größe aller IRM-Protokolle im Konnektivitätsprotokollverzeichnis an. Wenn die maximale Größe eines Verzeichnisses erreicht ist, löscht der Server zuerst die ältesten Protokolldateien. Der Standardwert ist 250 Megabytes (MB). Wenn Sie einen Wert eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:

  • B (Bytes)
  • KB (Kilobytes)
  • MB (Megabytes)
  • GB (Gigabytes)
  • TB (Terabytes)

Nicht qualifizierte Werte werden als Bytes behandelt. Der Wert des Parameters IrmLogMaxFileSize muss kleiner oder gleich dem Wert des Parameters IrmLogMaxDirectorySize sein. Der gültige Eingabebereich für beide Parameter liegt zwischen 1 und 9223372036854775807 Bytes. Bei Eingabe des Werts unlimited wird für das Konnektivitätsprotokollverzeichnis keine Größenbeschränkung festgelegt.

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

-IrmLogMaxFileSize

Der Parameter IrmLogMaxFileSize gibt die maximale Größe jeder einzelnen IRM-Protokolldatei an. Wenn die maximale Größe der Protokolldatei erreicht ist, wird eine neue Protokolldatei erstellt. Der Standardwert beträgt 10 MB. Wenn Sie einen Wert eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:

  • B (Bytes)
  • KB (Kilobytes)
  • MB (Megabytes)
  • GB (Gigabytes)
  • TB (Terabytes)

Nicht qualifizierte Werte werden als Bytes behandelt. Der Wert des Parameters IrmLogMaxFileSize muss kleiner oder gleich dem Wert des Parameters IrmLogMaxDirectorySize sein. Der gültige Eingabebereich für beide Parameter liegt zwischen 1 und 9223372036854775807 Bytes. Bei Eingabe des Werts unlimited wird für die IRM-Protokolldateien keine Größenbeschränkung festgelegt.

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

-IrmLogPath

Der Parameter IrmLogPath gibt den Standardspeicherort des IRM-Protokollverzeichnisses an. Der Standardwert ist C:\Programme\Microsoft\Exchange Server\V14. Wenn Sie den Wert des Parameters IrmLogPath in $null ändern, wird die IRM-Protokollierung deaktiviert. Wenn Sie jedoch den Wert des IrmLogPath-Parameters auf $null festlegen, wenn der Wert des IrmLogEnabled-Attributs $true ist, protokolliert Exchange Fehler im Anwendungsereignisprotokoll. Die bevorzugte Methode zum Deaktivieren der IRM-Protokollierung besteht darin, den Parameter IrmLogEnabled auf $false festzulegen.

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

-MaxCallsAllowed

Der Parameter MaxCallsAllowed gibt die maximale Anzahl gleichzeitiger Sprachanrufe an, die der Unified Messaging-Server zulässt.

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

-SIPAccessService

Der Parameter SIPAccessService gibt den FQDN und den TCP-Port des nächstgelegenen Lync Server Edge-Pools oder Skype for Business Server Edgepoolstandorts für ein- und ausgehende Anrufe von Remote-Lync oder Skype for Business Benutzern außerhalb des Netzwerks an.

Es wird empfohlen, diesen Parameter immer in Lync Server oder Skype for Business Server Bereitstellungen zu verwenden, die sich über mehrere geografische Regionen erstrecken. Andernfalls wählt der Unified Messaging-Server möglicherweise einen Pool für Real-Time Transport Protocol (RTP)-Mediendatenverkehr aus, der dem Remotebenutzer geografisch nicht am nächsten ist.

Sie konfigurieren diesen Parameter für jeden Unified Messaging-Server, sodass der Wert den nächstgelegenen Lync Server Edge-Pool oder Skype for Business Server Edgepool zum Exchange-Server identifiziert.

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

-SipTcpListeningPort

Der Parameter SipTcpListeningPort gibt den TCP-Port an, der vom Unified Messaging-Server zum Empfangen eingehender Anrufe verwendet wird. Dieser TCP-Port wird von Unified Messaging-Servern verwendet, die einem UM-Wählplan hinzugefügt wurden, der nicht für die Verwendung des SIP-gesicherten oder gesicherten Modus konfiguriert ist. Der Standardport lautet 5060.

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

-SipTlsListeningPort

Der Parameter SipTlsListeningPort gibt den TLS-Port (Transport Layer Security) an, der vom Unified Messaging-Server zum Empfangen eingehender Anrufe verwendet wird. Dieser TLS-Port wird von Unified Messaging-Servern verwendet, die einem UM-Wählplan hinzugefügt werden, der für die Verwendung des SIP-gesicherten oder geschützten Modus konfiguriert ist. Der Standardport lautet 5061.

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

-Status

Der Status-Parameter gibt den Status des Unified Messaging-Servers an. Die verfügbaren Optionen sind Enabled, Disabled und NoNewCalls.

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

-UMStartupMode

Der UMStartupMode-Parameter gibt an, ob der Microsoft Exchange Unified Messaging-Dienst auf einem Unified Messaging-Server im TCP-, TLS- oder Dual-Modus gestartet wird. Wenn der Unified Messaging-Server zu UM-Wählplänen mit unterschiedlichen Sicherheitseinstellungen hinzugefügt wird, sollten Sie dualen Modus auswählen. Im Dual-Modus kann der Unified Messaging-Server gleichzeitig an den Ports 5060 und 5061 lauschen. Wenn der Startmodus geändert wird, muss der Microsoft Exchange Unified Messaging-Dienst neu gestartet werden.

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

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

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

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.