Set-UMService
Dieses Cmdlet ist nur lokal in Exchange verfügbar.
Verwenden Sie das Cmdlet Set-UMService, um die Eigenschaften des Microsoft Exchange Unified Messaging-Diensts auf Exchange 2013- oder Exchange 2016-Postfachservern zu ändern.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
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>]
Beschreibung
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-UMService -Identity MyUMServer -IPAddressFamily Any -UMStartupMode Dual
In diesem Beispiel werden folgende Aktionen ausgeführt:
- Ermöglicht dem Microsoft Exchange Unified Messaging-Dienst auf dem Postfachserver "MyUMServer" das Akzeptieren von sowohl IPv4- als auch IPv6-Datenpaketen.
- Ermöglicht dem Microsoft Exchange Unified Messaging-Dienst auf dem Postfachserver "MyUMServer" das Starten sowohl im TCP- als auch im TLS-Modus.
Beispiel 2
Set-UMService -Identity MyUMServer -DialPlans $null
In diesem Beispiel wird der Postfachserver "MyUMServer" aus allen UM-Wählplänen entfernt.
Beispiel 3
Set-UMService -Identity MyUMServer -DialPlans MySIPDialPlan -MaxCallsAllowed 50 -SipAccessService northamerica.lyncpoolna.contoso.com:5061 -UMStartupMode TLS
In diesem Beispiel werden folgende Aktionen ausgeführt:
- Fügt den Postfachserver "MyUMServer" dem UM-Wählplan "MySIPDialPlan" hinzu.
- Legt die maximale Anzahl eingehender Anrufe auf 50 fest.
- Legt northamerica.lyncpoolna.contoso.com:5061 als FQDN und Port für den SIP-Zugriffsdienst fest, der von Microsoft Lync Server oder Skype for Business Server für eingehende und ausgehende Anrufe von Remote-Lync- oder Skype for Business-Clients verwendet wird.
- Ermöglicht dem Microsoft Exchange Unified Messaging-Dienst auf dem Postfachserver "MyUMServer" das Starten im TCP-Modus.
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 2013, Exchange Server 2016 |
-DialPlans
Der Parameter DialPlans gibt alle Wählpläne an, für die der Unified Messaging-Dienst eingehende Anrufe verarbeitet.
Exchange 2016- und Exchange 2013-Server können keinem TelExt- oder E.164-UM-Wählplan zugeordnet, sondern sip-Wählplänen zugeordnet oder hinzugefügt werden. Wenn Sie Unified Messaging in Lync Server 2010, Lync Server 2013 oder Skype for Business Server 2015 integrieren, müssen Sie alle Exchange 2016- und Exchange 2013-Server sip-Wählplänen zuordnen oder hinzufügen.
Sie können diesen Parameter auch verwenden, um Exchange 2010 Unified Messaging-Server einem UM-Wählplan zuzuordnen.
Verwenden Sie die folgende Syntax, um mehrere Werte einzugeben und vorhandene Einträge zu überschreiben: Value1,Value2,...ValueN
. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN"
.
Verwenden Sie die folgende Syntax, um einen oder mehrere Werte ohne Auswirkungen auf vorhandene Einträge hinzuzufügen oder zu entfernen: @{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
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 2013, Exchange Server 2016 |
-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 2013, Exchange Server 2016 |
-Identity
Der Parameter Identity gibt den Postfachserver an, der die Unified Messaging-Dienstkonfiguration hostet, die Sie ändern möchten. Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:
- Name
- Distinguished Name (DN)
- 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
Der Parameter IPAddressFamily gibt an, ob das UM-IP-Gateway IPv4, IPv6 oder beides für die Kommunikation verwendet. Gültige Werte sind:
- IPv4
- IPv6
- Beliebig: IPv6 wird zuerst verwendet, und bei Bedarf greift das UM-IP-Gateway auf IPv4 zurück. Dies ist der Standardwert.
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
Der Parameter IPAddressFamilyConfigurable gibt an, ob Sie den Parameter IPAddressFamily auf IPv6Only oder auf Any festlegen können. Der Standardwert ist $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
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 sind:
- $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 2013, Exchange Server 2016 |
-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.
Geben Sie zum Angeben eines Werts diesen als einen Zeitraum an: dd.hh:mm:ss, wobei dd Tagen, hh Stunden, mm Minuten und ss Sekunden entspricht.
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 2013, Exchange Server 2016 |
-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 in der Regel als Byte behandelt, kleine Werte werden jedoch auf das nächsthöhere Kilobyte aufgerundet.
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 2013, Exchange Server 2016 |
-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 in der Regel als Byte behandelt, kleine Werte werden jedoch auf das nächsthöhere Kilobyte aufgerundet.
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 2013, Exchange Server 2016 |
-IrmLogPath
Der Parameter IrmLogPath gibt den Standardspeicherort des IRM-Protokollverzeichnisses an. Der Standardspeicherort ist %ExchangeInstallPath%IRMLogs.
Wenn Sie den Wert dieses Parameters auf $null festlegen, deaktivieren Sie die IRM-Protokollierung effektiv. Wenn Sie diesen Parameter jedoch auf $null festlegen, wenn der Wert des IrmLogEnabled-Parameters $true ist, werden Fehler im Anwendungsereignisprotokoll generiert. Die bevorzugte Methode zum Deaktivieren der IRM-Protokollierung besteht darin, den IrmLogEnabled-Parameter auf $false festzulegen.
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
Der Parameter MaxCallsAllowed gibt die maximale Anzahl gleichzeitiger Sprachanrufe an, die der Unified Messaging-Dienst zulässt. Der Standardwert ist 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
Der PARAMETER SIPAccessService gibt den FQDN und den TCP-Port des nächstgelegenen Lync Server-Front-End-Pools oder Skype for Business Server Front-End-Poolstandorts für eingehende 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 Microsoft Exchange Unified Messaging-Dienst 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 jede Instanz des Unified Messaging-Diensts (jeden Exchange-Server), sodass der Wert den nächstgelegenen Lync Server-Front-End-Pool oder Skype for Business Server Front-End-Pool 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 2013, Exchange Server 2016 |
-Status
Dieser Parameter wird nicht mehr unterstützt und daher nicht mehr verwendet.
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
Der UMStartupMode-Parameter gibt den Startmodus für den Unified Messaging-Dienst an. Gültige Werte sind:
- TCP (Dies ist der Standardwert)
- TLS
- Dual: Der Dienst kann gleichzeitig an den Ports 5060 und 5061 lauschen. Wenn Sie den Exchange-Server zu UM-Wählplänen hinzufügen, die über unterschiedliche Sicherheitseinstellungen verfügen, sollten Sie diesen Wert verwenden.
Wenn Sie den Wert dieses Parameters ändern, müssen Sie den Unified Messaging-Dienst neu starten.
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
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 2013, Exchange Server 2016 |
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.