Set-UMServer

Modul:

Exchange PowerShell

Dieses Cmdlet steht nur in Exchange Server 2010 zur Verfügung.

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

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

Syntax

Default (Standard)

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

Mit dem Cmdlet Set-UMServer werden bestimmte Eigenschaften auf einem Unified Messaging-Server festgelegt. 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

Dieses Beispiel verhindert, dass der Unified Messaging-Server MyUMServer neue Anrufe annimmt.

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

Dieses Beispiel fügt den Unified Messaging-Server MyUMServer zum UM-Wählplan MyUMDialPlanName hinzu und legt außerdem die maximale Anzahl eingehender Sprachanrufe auf 50 fest.

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 von 02:30 bis 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 sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.

• 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 die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.

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 Hostname eines Load Balancers, der Unified Messaging-Server bedient. Dieser Parameter ist hilfreich, wenn Sie Unified Messaging-Server innerhalb Ihrer organization zu einer von Microsoft Exchange Server 2010 gehosteten Umgebung migrieren. Der FQDN des externen Diensthosts kann bis zu 2.048 Zeichen umfassen.

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 standardmäßig geplante Zeit für die Grammatikgenerierung ist jeden Tag 02:00-02:30 Ortszeit.

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.
• Ganzzahl 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 Uhrzeit im 12-Stunden-Format eingeben, schließen Sie ein Leerzeichen zwischen der Uhrzeit und dem AM/PM-Wert ein.

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

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" (Läuft von Samstag um 22:00 Uhr bis Samstag um 22:15 Uhr.)
• "So.01:15-Montag.23:00"
• "Montag.04:30-Montag.05:30 Uhr","Mittwoch.04:30-Mittwoch.05:30 Uhr" (Wird montags und mittwochs morgens von 4:30 bis 5:30 Uhr ausgeführt.)

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 IRM-Protokollierung aktivieren
• $false IRM-Protokollierung deaktivieren

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. Geben Sie zum Angeben eines Werts den Wert als Zeitspanne ein: tt.hh:mm:ss, wobei d = Tage, h = Stunden, m = Minuten und s = Sekunden ist. 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 effektiv die IRM-Protokollierung. Wenn der Wert des IrmLogEnabled-Parameters jedoch $true ist, fügt Exchange dem Anwendungsereignisprotokoll Fehler hinzu. Die bevorzugte Methode zum Deaktivieren der IRM-Protokollierung besteht darin, den Parameter IrmLogEnabled auf $false zu setzen.

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 Standorts des Lync-Server-Edgepools oder Skype for Business Server Edgepools für eingehende und ausgehende Anrufe von Remotebenutzern von Lync oder Skype for Business an, die sich außerhalb des Netzwerks befinden.

Wir empfehlen, 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 RTP-Medienverkehr (Transport Protocol) 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 Edgepool 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, über den der Unified Messaging-Server eingehende Anrufe empfängt. Dieser TCP-Port wird von Unified Messaging-Servern verwendet, die einem UM-Wählplan hinzugefügt werden, der nicht für die Verwendung des gesicherten SIP- 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, über den der Unified Messaging-Server eingehende Anrufe empfängt. Dieser TLS-Port wird von Unified Messaging-Servern verwendet, die zu einem UM-Wählplan hinzugefügt werden, der für die Verwendung des gesicherten SIP- oder gesicherten 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 Status-Parameter gibt den Status des Messaging-Servers an. Die verfügbaren Optionen sind "Aktiviert", "Deaktiviert" 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 Parameter UMStartupMode 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 die Ports 5060 und 5061 überwachen.

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

Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. 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.