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
Default (Standardwert)
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. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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
Anwendbar: Exchange Server 2010
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 (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise 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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DialPlans
Anwendbar: Exchange Server 2010
Der Parameter DialPlans gibt die Wählpläne an, für die der Server UM-Anrufe verarbeitet. Es können mehrere Werte durch Kommata getrennt angegeben werden.
Wenn keine Wählpläne angegeben sind, verarbeitet der Unified Messaging-Server keine UM-Anrufe.
Parametereigenschaften
| Typ: | MultiValuedProperty |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DomainController
Anwendbar: Exchange Server 2010
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.
Parametereigenschaften
| Typ: | Fqdn |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ExternalServiceFqdn
Anwendbar: Exchange Server 2010
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 Ihrem organization zu einer Microsoft Exchange Server 2010 gehosteten Umgebung migrieren. Der FQDN des externen Diensthosts kann bis zu 2.048 Zeichen enthalten.
Parametereigenschaften
| Typ: | UMSmartHost |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-GrammarGenerationSchedule
Anwendbar: Exchange Server 2010
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 ist.
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.)
Parametereigenschaften
| Typ: | ScheduleInterval[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: Exchange Server 2010
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
Parametereigenschaften
| Typ: | UMServerIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-IrmLogEnabled
Anwendbar: Exchange Server 2010
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
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IrmLogMaxAge
Anwendbar: Exchange Server 2010
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.
Parametereigenschaften
| Typ: | EnhancedTimeSpan |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IrmLogMaxDirectorySize
Anwendbar: Exchange Server 2010
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.
Parametereigenschaften
| Typ: | Unlimited |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IrmLogMaxFileSize
Anwendbar: Exchange Server 2010
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.
Parametereigenschaften
| Typ: | ByteQuantifiedSize |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IrmLogPath
Anwendbar: Exchange Server 2010
Der Parameter IrmLogPath gibt den Standardspeicherort des IRM-Protokollverzeichnisses an. Der Standardwert ist %ExchangeInstallPath%IRMLogs.
Wenn Sie den Wert dieses Parameters auf $null festlegen, deaktivieren Sie die IRM-Protokollierung effektiv. Wenn der Wert des IrmLogEnabled-Parameters jedoch $true ist, fügt Exchange Dem Application-Ereignisprotokoll Fehler hinzu. Die bevorzugte Methode zum Deaktivieren der IRM-Protokollierung besteht darin, den IrmLogEnabled-Parameter auf $false festzulegen.
Parametereigenschaften
| Typ: | LocalLongFullPath |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MaxCallsAllowed
Anwendbar: Exchange Server 2010
Der Parameter MaxCallsAllowed gibt die maximale Anzahl gleichzeitiger Sprachanrufe an, die der Unified Messaging-Server zulässt.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SIPAccessService
Anwendbar: Exchange Server 2010
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 so, dass der Wert den lync Server Edge-Pool oder Skype for Business Server Edgepool identifiziert, der dem Exchange-Server am nächsten liegt.
Parametereigenschaften
| Typ: | ProtocolConnectionSettings |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SipTcpListeningPort
Anwendbar: Exchange Server 2010
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.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SipTlsListeningPort
Anwendbar: Exchange Server 2010
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.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Status
Anwendbar: Exchange Server 2010
Der Parameter Status gibt den Unified Messaging-Server status an. Die verfügbaren Optionen sind Enabled, Disabled und NoNewCalls.
Parametereigenschaften
| Typ: | ServerStatus |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UMStartupMode
Anwendbar: Exchange Server 2010
Der UMStartupMode-Parameter gibt den Startmodus für den Microsoft Exchange Unified Messaging-Dienst auf einem Exchange-Server an. Gültige Werte sind:
- TCP
- TLS
- Dual: Verwenden Sie diesen Wert, um den Unified Messaging-Server zu UM-Wählplänen mit unterschiedlichen Sicherheitseinstellungen hinzuzufügen. Der Unified Messaging-Server kann gleichzeitig an den Ports 5060 und 5061 lauschen.
Wenn Sie den Startmodus ändern, müssen Sie den Microsoft Exchange Unified Messaging-Dienst neu starten.
Parametereigenschaften
| Typ: | UMStartupMode |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Exchange Server 2010
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.
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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.