• Artikel

Get-CsAnnouncement

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den Microsoft Lync Server 2010-Ansagen zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind. 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

Get-CsAnnouncement [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsAnnouncement [-Filter <String>] [-LocalStore <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, wird für diesen Benutzer standardmäßig ein Besetztzeichen ausgegeben, und u. U. wird dem SIP-Client ein Fehler gemeldet. 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 eine oder mehrere dieser Ansageeinstellungen abgerufen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eine eindeutige ID für die Ansage, die abgerufen werden soll. Wenn Sie diesen Parameter und den Parameter "Filter" nicht angeben, werden alle Instanzen der für die Organisation konfigurierten Ansagen angezeigt. Es gibt zwei Möglichkeiten, den Wert für den Parameter "Identity" bereitzustellen:

- Geben Sie den Identitätswert des Anwendungsdiensts für die Ansagen ein, die Sie abrufen möchten. Dadurch werden alle Ansagen abgerufen, die mit der angegebenen Dienstidentität konfiguriert sind. Beispiel: ApplicationServer:Redmond.litwareinc.com.

- Geben Sie den vollständigen Identitätswert der einzelnen Ansagen ein, die Sie abrufen möchten. Dieser Wert besitzt immer das Format "<serviceID>/<GUID>", wobei "serviceID" der Identitätswert des Anwendungsservers ist, der den Ansagedienst ausführt, und die GUID die globale eindeutige ID ist, die dieser Ansage zugeordnet ist. Beispiel: ApplicationServer:Redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c.

Filter

Optional

Zeichenfolge

Dieser Parameter ermöglicht eine Platzhaltersuche nach dem Identitätswert aller für die Organisation konfigurierten Ansagen. Mit dem Platzhalterzeichen (*) kann nach einer beliebigen Komponente des Identitätswerts gefiltert werden.

LocalStore

Optional

Switch-Parameter

Ruft die Ansageinformationen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Gibt eine oder mehrere Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement" zurück.

Beispiel

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

Get-CsAnnouncement

In Beispiel 1 werden alle Ansagen zurückgegeben, die für die Verwendung innerhalb der Organisation konfiguriert sind. Dazu wird Get-CsAnnouncement ohne Parameter aufgerufen.

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

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90"

Mit dem vorstehenden Befehl wird eine einzelne Ansage zurückgegeben: die Ansage mit der Identität "ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90". Beispiel 5 zeigt eine alternative (und möglicherweise leichtere) Methode zum Abrufen einer bestimmten Ansage.

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

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com"

Der Befehl in Beispiel 3 gibt Informationen zu allen Ansagen zurück, die für den Dienst "ApplicationServer:redmond.litwareinc.com" konfiguriert wurden.

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

Get-CsAnnouncement -Filter "*ApplicationServer:Redmond*"

In Beispiel 4 werden Informationen zu allen Ansagen zurückgegeben, die für den Standort "Redmond" (unter allen Domänen) konfiguriert wurden. Dazu werden der Parameter "Filter" und der Filterwert "*ApplicationServer:Redmond*" angegeben, um die zurückgegebenen Daten auf die Ansagen zu beschränken, deren Identitätswert die Zeichenfolge "ApplicationServer:Redmond" enthält. Diese Ansagen sind auf Dienstebene für die Verwendung am Standort "Redmond" konfiguriert.

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

Get-CsAnnouncement | Where-Object {$_.Name -eq "Welcome Announcement"}

Beispiel 5 zeigt eine alternative Möglichkeit zum Zurückgeben einer bestimmten Ansage oder eines Ansagensatzes. In diesem Fall handelt es sich um alle Ansagen namens "Welcome Announcement". Dazu wird Get-CsAnnouncement zunächst ohne Parameter aufgerufen, um eine Auflistung aller Ansagen zurückzugeben, die innerhalb der Organisation verwendet werden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Ansagen mit dem Namen "Welcome Announcement" herausfiltert (der Vergleichsoperator "-eq" steht für "equal to").

-------------------------- Beispiel 6 ------------------------

Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com" | Where-Object {$_.Name -eq "Welcome Announcement"}

Beispiel 6 ähnelt Beispiel 5, zeigt aber eine andere Möglichkeit zum Zurückgeben einer einzelnen Ansage. Dabei wird wieder Get-CsAnnouncement aufgerufen, diesmal jedoch unter Angabe des Identitätswerts "ApplicationServer:redmond.litwareinc.com". Dadurch wird eine Auflistung aller Ansagen zurückgegeben, die diesem Dienst zugeordnet sind. Wie in Beispiel 5 wird diese Auflistung dann an das Cmdlet Where-Object weitergeleitet, das die Ansagen mit dem Namen "Welcome Announcement" herausfiltert (der Vergleichsoperator "-eq" steht für "equal to"). Da Ansagenamen innerhalb eines Anwendungsdiensts eindeutig sein müssen, gibt dieser Befehl immer nur ein Element zurück.

-------------------------- Beispiel 7 ------------------------

Get-CsAnnouncement | Where-Object {$_.Name -like "Welcome*"}

Dieses Beispiel ähnelt Beispiel 5, da alle Ansagen abgerufen werden und die Auflistung der Ansagen dann an das Cmdlet Where-Object weitergeleitet wird. In Beispiel 5 wird jedoch der Vergleichsoperator "-eq" in der Where-Klausel verwendet, um nach einer identischen Übereinstimmung für den Namen zu suchen. In diesem Beispiel werden der Vergleichsoperator "-like" und ein Platzhalterwert verwendet, um nach allen Ansagen zu suchen, die in diesem Fall mit der Zeichenfolge "Welcome" beginnen.

-------------------------- Beispiel 8 ------------------------

Get-CsAnnouncement | Where-Object {($_.TextToSpeechPrompt -ne $Null) -and ($_.Language -ne "en-US")}

In Beispiel 8 werden Informationen zu allen Ansagen zurückgegeben, die eine Text-zu-Sprache-Ansage (Text-to-Speech, TTS) (als primäre Ansage oder als Alternative zu einer Audiodatei), jedoch nicht US-Englisch als Sprache verwenden. Dazu ruft der Befehl zunächst Get-CsAnnouncement auf, um eine Auflistung aller derzeit konfigurierten Ansagen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das alle Ansagen auswählt, bei denen die Eigenschaft "TextToSpeechPrompt" nicht leer (ungleich "$Null") ist und die Eigenschaft "Language" nicht den Wert "en-US" aufweist (der Vergleichsoperator "-ne" steht für "not equal to").