Remove-CsAnnouncement
Letztes Änderungsdatum des Themas: 2012-03-26
Entfernt eine vorhandene 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
Remove-CsAnnouncement -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 eine oder mehrere dieser Ansageeinstellungen entfernt.
Wenn Sie versuchen, eine Ansage zu entfernen, die mit einem Bereich nicht zugewiesener Nummern zugeordnet ist, wird standardmäßig eine Aufforderung angezeigt, in der Sie gefragt werden, ob Sie die Ansage tatsächlich entfernen möchten. Wenn Sie die Ansage löschen, wird die Eigenschaft "AnnouncementName" dieses Bereichs als "Null" angezeigt. Es wird keine Ansage abgespielt, wenn diese Nummern gewählt werden, sondern es wird ein Besetztzeichen wiedergegeben. Der Eigenschaftswert "AnnouncementId" (die GUID der Ansage, die entfernt wurde) wird jedoch weiter angezeigt.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-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 "Remove-CsAnnouncement"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Die eindeutige ID für die Ansage, die entfernt werden soll. 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 entfernen möchten. Dadurch werden alle Ansagen entfernt, 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 entfernen 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. |
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
Keine.
Rückgabetypen
Löscht vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement".
Beispiel
-------------------------- Beispiel 1 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90"
Mit dem vorstehenden Befehl wird die Ansage mit dem Identitätswert "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90" entfernt. Da Identitätswerte eindeutig sein müssen, wird mit diesem Befehl höchstens eine Ansage entfernt.
-------------------------- Beispiel 2 ------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com"
In Beispiel 2 werden alle Ansagen gelöscht, die auf den Dienst "ApplicationServer:Redmond.litwareinc.com" angewendet wurden. Dazu wird Remove-CsAnnouncement mit dem Parameter "Identity" aufgerufen. Durch das Festlegen des Parameterwerts "ApplicationServer:Redmond.litwareinc.com" (ohne angefügte GUID, die eine eindeutige Ansage identifiziert) werden alle Ansagen entfernt, die für den angegebenen Dienst konfiguriert wurden.