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 NoNewCallsIn diesem Beispiel wird verhindert, dass der Unified Messaging-Server MyUMServer neue Anrufe akzeptiert.
Beispiel 2
Set-UMServer -Identity MyUMServer -DialPlans $nullIn diesem Beispiel wird der Unified Messaging-Server MyUMServer aus allen UM-Wählplänen entfernt.
Beispiel 3
Set-UMServer -Identity MyUMServer -DialPlans MyUMDialPlanName -MaxCallsAllowed 50In 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:00In 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.