• Artikel

Set-CsAnnouncement

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert die Eigenschaftswerte einer vorhandenen Microsoft Lync Server 2010-Ansage. Ansagen werden abgespielt, wenn Benutzer eine gültige, aber nicht zugewiesene Telefonnummer wählen. Bei der Ansage kann es sich um eine Nachricht (z. B. "Diese Nummer ist derzeit nicht verfügbar") oder um ein Besetztzeichen handeln.

Syntax

Set-CsAnnouncement [-Identity <XdsIdentity>] [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Language <String>] [-Name <String>] [-TargetUri <String>] [-TextToSpeechPrompt <String>] [-WhatIf [<SwitchParameter>]]

Set-CsAnnouncement [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Language <String>] [-Name <String>] [-TargetUri <String>] [-TextToSpeechPrompt <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Eine Organisation kann Telefonnummern besitzen, die keinen Benutzern oder Telefonen zugeordnet sind, die aber trotzdem gültige Telefonnummern sind, die angerufen werden können. Wenn ein Benutzer eine dieser Nummern wählt, erhält dieser Benutzer standardmäßig ein Besetztzeichen, und der Anruf kann zur Rückgabe eines Fehlers an den SIP-Client führen. Durch das Anwenden von Ansageeinstellungen auf nicht zugewiesene Nummern können Administratoren festlegen, ob eine Nachricht abgespielt, ein Besetztzeichen zurückgegeben oder der Anruf weitergeleitet werden soll. Mit diesem Cmdlet werden die Ansageeinstellungen geändert.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsAnnouncement lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAnnouncement"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eine eindeutige ID für die Ansage. Dieser Wert weist immer das Format "<Dienst-ID>/<GUID>" auf, wobei "Dienst-ID" den Identitätswert des Anwendungsservers angibt, auf dem der Anwendungsdienst ausgeführt wird, und "GUID" für die global eindeutige ID steht, die diesen Ansageeinstellungen zugeordnet ist. Beispiel: ApplicationServer:redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c.

Da eine ordnungsgemäße Eingabe von GUIDs in die Befehlszeile nicht immer einfach ist, rufen Sie Ansagen sehr wahrscheinlich mit dem Cmdlet Get-CsAnnouncement ab und leiten sie zur Änderung an das Cmdlet Set-CsAnnouncement weiter. (Weitere Informationen finden Sie im Abschnitt mit den Beispielen.)

Instance

Optional

Ansage

Ein Verweis auf das Ansageobjekt, das Sie ändern möchten. Dieses Objekt muss ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement" sein, das durch Aufrufen des Cmdlets Get-CsAnnouncement abgerufen wird.

Name

Optional

Zeichenfolge

Geben Sie einen Wert für diesen Parameter ein, um den Namen der Ansage zu ändern. Namen müssen innerhalb eines Diensts eindeutig sein.

AudioFilePrompt

Optional

Zeichenfolge

Der Name der Audiodatei, die als Ansage abgespielt werden soll. Audiodateien werden im Dateispeicher gespeichert. Verwenden Sie das Cmdlet Import-CsAnnouncementFile, um eine Audiodatei im Dateispeicher zu speichern.

Gültige Dateitypen: WAV und WMA

TextToSpeechPrompt

Optional

Zeichenfolge

Eine TTS-Ansage (Text-to-Speech). Dabei handelt es sich um einen Text, der in Audio konvertiert und als Ansage abgespielt wird.

Wenn für eine einzelne Ansage sowohl "AudioFilePrompt" als auch "TextToSpeechPrompt" festgelegt wurde, wird eine Warnung ausgegeben, dass die Audiodatei Vorrang hat und die TTS-Ansage ignoriert wird.

Language

Optional

Zeichenfolge

Die Sprache der TTS-Ansage. Wenn für "TextToSpeechPrompt" ein Wert eingegeben wird, ist dieser Parameter erforderlich.

Die Werte werden als Zeichenfolge für die zu verwendende Sprache und das zu verwendende Gebietsschema eingegeben. In der folgenden Liste sind gültige Werte aufgeführt, auf die in Klammern die Sprache und das Gebietsschema folgen: ca-ES (Katalanisch, Katalonien); da-DK (Dänisch, Dänemark); de-DE (Deutsch, Deutschland); en-AU (Englisch, Australien); en-CA (Englisch, Kanada); en-GB (Englisch, Vereinigtes Königreich); en-IN (Englisch, Indien); en-US (Englisch, Vereinigte Staaten); es-ES (Spanisch, Spanien); es-MX (Spanisch, Mexiko); fi-FI (Finnisch, Finnland); fr-CA (Französisch, Kanada); fr-FR (Französisch, Frankreich); it-IT (Italienisch, Italien); ja-JP (Japanisch, Japan); ko-KR (Koreanisch, Korea); nb-NO (Norwegisch, Bokmal, Norwegen); nl-NL (Niederländisch, Niederlande); pl-PL (Polnisch, Polen); pt-BR (Portugiesisch, Brasilien); pt-PT (Portugiesisch, Portugal); ru-RU (Russisch, Russische Föderation); sv-SE (Schwedisch, Schweden); zh-CN (Chinesisch, Volksrepublik China); zh-HK (Chinesisch, Hongkong SAR); zh-TW (Chinesisch, Taiwan)

TargetUri

Optional

Zeichenfolge

Der URI, an den der Anrufer nach der Wiedergabe der Ansage weitergeleitet wird. Dieser Wert muss als SIP-Adresse mit dem folgenden Format eingegeben werden: "sip:", gefolgt von der SIP-Adresse. Beispiel: sip:kmyer@litwareinc.com. Beachten Sie, dass es sich bei der SIP-Adresse auch um eine Telefonnummer oder Voicemail handeln kann. Beispiel: "sip:+14255551212@litwareinc.com;user=phone" für eine Telefonnummer oder "sip:kmyer@litwareinc.com;opaque=app:voicemail" für Voicemail.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement-Objekt. Akzeptiert eine weitergeleitete Eingabe von Ansageobjekten.

Rückgabetypen

Set-CsAnnouncement gibt keine Objekte oder Werte zurück. Mit dem Cmdlet werden stattdessen bestehende Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement" geändert.

Beispiel

-------------------------- Beispiel 1 --------------------------

Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -AudioFilePrompt "helpdesk.wav"

Der Befehl in Beispiel 1 weist der Helpdeskansage eine neue Audiodatei zu. Hierzu ruft der Befehl zunächst Get-CsAnnouncement ohne Parameter auf, um eine Auflistung aller derzeit verfügbaren Ansagen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Ansage herausfiltert, deren Eigenschaft "Name" den Wert "Help Desk Announcement" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Die Ansage wird dann an Set-CsAnnouncement weitergeleitet, das den Wert der Eigenschaft "AudioFilePrompt" auf "helpdesk.wav" festlegt.

Wenn diese Ansage bereits über einen zugewiesenen Wert für "TextToSpeechPrompt" verfügt, wird beim Ausführen dieses Befehls eine Warnung ausgegeben wird. In dieser Warnung wird darauf hingewiesen, dass der Wert für "TextToSpeechPrompt" ignoriert wird.

-------------------------- Beispiel 2 --------------------------

Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -TextToSpeechPrompt $Null

In Beispiel 2 wird die Eigenschaft "TextToSpeechPrompt" für die Ansage "Help Desk Announcement" auf einen Nullwert festgelegt; damit wird der Eigenschaftswert effektiv gelöscht. Hierzu wird zunächst Get-CsAnnouncement aufgerufen, um eine Auflistung aller derzeit verfügbaren Ansagen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Ansage herausfiltert, deren Eigenschaft "Name" den Wert "Help Desk Announcement" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Diese Ansage wird dann an das Cmdlet Set-CsAnnouncement weitergeleitet, das für die Eigenschaft "TextToSpeechPrompt" einen Nullwert ($Null) festlegt.

-------------------------- Beispiel 3 --------------------------

Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -TargetUri "sip:kmyer@litwareinc.com;opaque=app:voicemail"

In diesem Beispiel wird "TargetUri" für die Ansage mit dem Namen "Help Desk Announcement" aktualisiert. Hierzu wird zunächst Get-CsAnnouncement aufgerufen, um eine Auflistung aller derzeit verfügbaren Ansagen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Ansage herausfiltert, deren Eigenschaft "Name" den Wert "Help Desk Announcement" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Diese Ansage wird dann an das Cmdlet Set-CsAnnouncement weitergeleitet, das für die Eigenschaft "TargetUri" einen Voicemailstandort festlegt (sip:kmyer@litwareinc.com;opaque=app:voicemail).