Freigeben über

  • Artikel

New-CsAnnouncement

 

Letztes Änderungsdatum des Themas: 2012-03-23

Erstellt eine neue 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

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

New-CsAnnouncement -Name <String> -Parent <String> [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Language <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. Über dieses Cmdlet werden diese Einstellungen für Ansagen erstellt.

Durch den Aufruf des Cmdlets New-CsUnassignedNumber oder Set-CsUnassignedNumber können Sie nicht zugewiesenen Nummern Ansagen zuweisen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-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 "New-CsAnnouncement"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eine eindeutige ID für die Ansage. Für diesen Wert muss die Identität des Anwendungsservers angegeben werden, auf dem die Reaktionsgruppenanwendung ausgeführt wird. Beispiel: ApplicationServer:redmond.litwareinc.com.

Einem einzelnen Dienst können mehrere Ansagen zugewiesen werden. Um eindeutige Identitäten sicherzustellen, wird beim Erstellen der Ansage daher automatisch eine GUID (Globally Unique Identifier) generiert und der Identität zugewiesen. Die Identität der neuen Ansage weist das folgende Format auf:<Dienst-ID>/<GUID>. Beispiel: service: ApplicationServer:redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c. Sie müssen beim Aufrufen dieses Cmdlets keine GUID bereitstellen. Stattdessen geben Sie die Dienstidentität an. Die GUID wird automatisch generiert und dem Identitätswert hinzugefügt.

Die Angabe einer GUID ist jedoch optional. Dies kann sinnvoll sein, wenn eine Ansage einem Bereich nicht zugewiesener Nummern zugewiesen und anschließend gelöscht wurde. Sie können eine neue Ansage mit übereinstimmender Identität (einschließlich GUID) erstellen und müssen den Bereich nicht zugewiesener Nummern nicht aktualisieren.

Parent

Optional

Zeichenfolge

Dieser Parameter ist praktisch mit "Identity" identisch. Die einzige Ausnahme ist, dass "Identity" die Dienstidentität und die GUID, "Parent" jedoch lediglich die Dienstidentität akzeptiert (die GUID wird automatisch generiert). Sie können nur einen der beiden Parameter "Identity" und "Parent" festlegen.

Name

Erforderlich

Zeichenfolge

Ein beschreibender Name für die Ansage. Dieser Name muss innerhalb des Diensts eindeutig sein. Dieser Name wird zum Aufrufen von New-CsUnassignedNumber oder Set-CsUnassignedNumber verwendet, um die einem Bereich nicht zugewiesener Nummern zugeordnete Ansage anzugeben.

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

Language

Optional

Zeichenfolge

Die Sprache der TTS-Ansage (Text-to-Speech). 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 (Uniform Resource Identifier), 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.

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.

Force

Optional

Switch-Parameter

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

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

WhatIf

Optional

Switch-Parameter

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

Confirm

Switch-Parameter

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

Eingabetypen

Keine.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement".

Beispiel

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

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Help Desk Announcement" -TextToSpeechPrompt "Welcome to the Help Desk." -Language "en-US"

In Beispiel 1 wird gezeigt, wie Sie eine neue Ansage zur Wiedergabe einer TTS-Ansage in englischer Sprache (Vereinigte Staaten) erstellen. Der erste angegebene Parameter ist "Identity". Die Identität muss für die Dienstebene gelten. Anschließend wird die Dienst-ID des Anwendungsservers angegeben (ApplicationServer:redmond.litwareinc.com). Dann wird ein Name für die Ansage festgelegt, in diesem Fall "Help Desk Announcement". Um dieser Ansage eine TTS-Ansage zuzuweisen, wird der Parameter "TextToSpeechPrompt" verwendet, auf den eine Zeichenfolge mit dem Ansagetext folgt. Bei Verwendung einer TTS-Ansage muss eine Sprache angegeben werden. In diesem Beispiel wird hierzu der Parameter "Language" verwendet, auf den eine Zeichenfolge für die englische Sprache folgt (en-US).

Beachten Sie, dass Identitäten von Ansagen zwei Teile umfassen: den Dienst, in dem die Ansage gespeichert werden soll, und eine 36-stellige GUID (Globally Unique Identifier). Die vollständige Identität wird nach dem Erstellen der neuen Ansage angezeigt, die GUID wird automatisch generiert und angewendet. Die Identität entspricht in etwa folgendem Beispiel: service:ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90.

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

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Welcome Announcement" -AudioFilePrompt "WelcomeMessage.wav"

Beispiel 2 ist insofern mit Beispiel 1 vergleichbar, als zunächst die erforderlichen Parameter ("Identity" und "Name") eingegeben werden. In diesem Beispiel soll anstelle einer TTS-Ansage jedoch eine Audiodatei für die Ansage verwendet werden. Hierzu wird der Parameter "AudioFilePrompt" aufgenommen, an den eine Zeichenfolge mit dem Namen der Audiodatei (WelcomeMessage.wav) übergeben wird. Zur Wiedergabe dieser Ansage muss sich diese Datei im Dateispeicher befinden. Zum Hinzufügen von Audiodateien zum Dateispeicher rufen Sie das Cmdlet Import-CsAnnouncementFile auf.

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

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Forward Announcement" -AudioFilePrompt "WelcomeMessage.wav" -TargetUri sip:kmyer@litwareinc.com

Wie in Beispiel 2 wird in diesem Beispiel eine Ansage erstellt, für die beim Anrufen einer Nummer eine Audiodatei wiedergegeben wird. Neben den Parametern "Identity", "Name" und "AudioFilePrompt" wird in diesem Beispiel jedoch zusätzlich der Parameter "TargetUri" angegeben. In diesen Parameter wird der SIP-URI des Benutzers oder Telefons übergeben, an den der Anrufer nach der Wiedergabe der Ansage weitergeleitet wird.

-------------------------- Beispiel 4 ------------------------

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Forward Announcement" -AudioFilePrompt "WelcomeMessage.wav" -TargetUri "sip:+14255551212@litwareinc.com;user=phone"

Beispiel 4 ist praktisch mit Beispiel 3 identisch. Die einzige Ausnahme ist, dass der Anruf nicht basierend auf der SIP-Adresse eines Benutzers, sondern an eine Telefonnummer weitergeleitet wird.

-------------------------- Beispiel 5 ------------------------

New-CsAnnouncement -Identity ApplicationServer:redmond.litwareinc.com -Name "Busy"

In diesem Beispiel wird weder eine Ansage noch ein Ziel-URI, sondern lediglich eine Identität und ein Name angegeben. Das bedeutet, dass beim Herstellen einer Verbindung über eine nicht zugewiesene Nummer, die dieser Ansage zugeordnet ist, ein Besetztzeichen ertönt.