Set-CsDialInConferencingAccessNumber
Letztes Änderungsdatum des Themas: 2012-03-27
Ändert die Eigenschaftswerte einer vorhandenen Zugriffsnummer für Einwahlkonferenzen. Bei Einwahlkonferenzen können Benutzer mit einem "normalen" Telefon, einem Mobiltelefon oder einem anderen Gerät im Telefonfestnetz (Public Switched Telephone Network, PSTN) am Audioteil einer Konferenz teilnehmen.
Syntax
Set-CsDialInConferencingAccessNumber -Instance <AccessNumber> [-Confirm [<SwitchParameter>]] [-PassThru <SwitchParameter>] [-ScopeToGlobal <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingAccessNumber -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-LineUri <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-Regions <MultiValuedProperty>] [-ScopeToGlobal <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-SecondaryLanguages <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingAccessNumber -Identity <UserIdParameter> -Priority <Int32> -ReorderedRegion <String> [-Confirm [<SwitchParameter>]] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Bei Einwahlkonferenzen können Benutzer jede Art von Telefon verwenden (z. B. ein herkömmliches Festnetztelefon, ein Mobiltelefon oder ein VoIP-Telefon), um am Audioteil einer Konferenz teilzunehmen. So können Benutzer sogar ohne Computer oder Internetverbindung an der Besprechung teilnehmen. Einwählbenutzern stehen Audiofunktionen in vollem Umfang zur Verfügung: Sie können mit anderen Teilnehmern sprechen und alles hören. Allerdings können sie keine Präsentationen, Videofeeds oder andere visuellen Elemente sehen, die freigegeben wurden.
Damit Benutzer Einwahlkonferenzfunktionen erhalten, müssen Sie Zugriffsnummern für Einwahlkonferenzen erstellen: Dabei handelt es sich um Telefonnummern, die die Benutzer zur Einwahl in eine Besprechung wählen können. Zugriffsnummern für Einwahlkonferenzen werden mit dem Cmdlet New-CsDialInConferencingAccessNumber erstellt. Wenn Sie eine neue Zugriffsnummer für Einwahlkonferenzen erstellen, erstellen Sie tatsächlich ein neues Kontaktobjekt in Active Directory-Domänendienste (AD DS). Dieses Kontaktobjekt repräsentiert die Zugriffsnummer und sämtliche ihrer Eigenschaften.
Nachdem eine Zugriffsnummer für Einwahlkonferenzen erstellt wurde, können Sie mit dem Cmdlet Set-CsDialInConferencingAccessNumber die Eigenschaften dieser Nummer ändern. Sie können beispielsweise die Telefonnummer (LineUri) selbst oder den Anzeigenamen des Kontaktobjekts ändern, das diese Nummer repräsentiert. Darüber hinaus können Sie mit Set-CsDialInConferencingAccessNumber den Bereich für die Nummer ändern; Sie können mit diesem Cmdlet z. B. eine global zugewiesene Nummer auf Standortebene zuweisen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsDialInConferencingAccessNumber 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-CsDialInConferencingAccessNumber"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
SIP-Adresse |
SIP-Adresse des Kontaktobjekts, das die Einwahlkonferenznummer darstellt. Beim Festlegen des Identitätswerts müssen Sie das Präfix "sip:" angeben. Beispiel: -Identity "sip:RedmondDialIn@litwareinc.com". |
Instance |
Optional |
Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen. |
|
DisplayName |
Optional |
Zeichenfolge |
Active Directory-Anzeigename für das neue Kontaktobjekt. Dieser Name wird auch in Microsoft Lync 2010 angezeigt. |
DisplayNumber |
Erforderlich |
Zeichenfolge |
Telefonnummer, die in Besprechungseinladungen und auf der Webseite mit den Einstellungen für die Einwahlkonferenz angezeigt wird. "DisplayNumber" kann in beliebigem Format angegeben werden, z. B "1-800-555-1234", "1-(800)-555-1234" oder "1.800.555.1234". |
LineUri |
Optional |
Zeichenfolge |
Die eigentliche Telefonnummer für Einwahlkonferenzen. "LineUri" muss mit folgender Syntax angegeben werden: das Präfix "tel:", gefolgt von einem Pluszeichen (+), dem Länder/-Regionscode, der Ortskennzahl und der Telefonnummer. Beispiel: tel:+18005551234. Leerzeichen, Bindestriche, Klammern und andere Zeichen sind nicht zulässig. |
PassThru |
Optional |
Switch-Parameter |
Ermöglicht es Ihnen, ein Kontaktobjekt weiterzuleiten, das die geänderte Zugriffsnummer für Einwahlkonferenzen darstellt. Das Cmdlet Set-CsDialInConferencingAccessNumber leitet standardmäßig keine Objekte weiter. |
PrimaryLanguage |
Optional |
Zeichenfolge |
Primäre Sprache für Einwahlkonferenzansagen. Die Sprache muss mit einem der verfügbaren Sprachcodes für Einwahlkonferenzen konfiguriert werden, z. B. "en-US" für US-Englisch oder "fr-FR" für Französisch usw. Um eine Liste der verfügbaren Sprachcodes zurückzugeben, geben Sie an der Windows PowerShell-Eingabeaufforderung folgenden Befehl ein: Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages. |
Priority |
Optional |
Ganze Zahl |
Ermöglicht es Ihnen, die Reihenfolge zu ändern, in der die Einwahlkonferenznummern den Benutzern in Besprechungseinladungen oder beim Zugriff auf die Webseite "Einstellungen für Einwahlkonferenzen" angezeigt werden. Niedrigere Werte haben eine höhere Priorität. Damit eine Nummer am Anfang der Liste angezeigt wird, legen Sie die Priorität auf "0" fest. Beachten Sie, dass beim Ändern der Priorität einer bestimmten Nummer auch der Parameter "ReorderedRegion" verwendet werden muss, um anzugeben, für welche Region die geänderte Priorität gelten soll. |
Regions |
Optional |
Zeichenfolge |
Der Einwahlnummer zugeordnete Wähleinstellungsregionen. Wenn eine Region in keinem Satz mit Wähleinstellungen enthalten ist, kann sie keiner Zugriffsnummer für Einwahlkonferenzen zugeordnet werden. Um mehrere Regionen festzulegen, verwenden Sie eine durch Trennzeichen getrennte Liste. -Regions "Northwest", "Southwest" |
ReorderedRegion |
Optional |
Zeichenfolge |
Wird zusammen mit dem Parameter "Priority" zum Ändern der Priorität einer Einwahlkonferenznummer in einer Region verwendet. Der Parameter "ReorderedRegion" gibt die Region an, für die eine Neusortierung der Priorität gelten soll. Beispiel: -ReorderedRegion "Redmond". |
ScopeToGlobal |
Optional |
Switch-Parameter |
Wenn dieser Parameter angegeben wurde, wird die Zugriffsnummer für Einwahlkonferenzen auf globaler Ebene zugewiesen. |
ScopeToSite |
Optional |
Switch-Parameter |
Wenn dieser Parameter angegeben wurde, wird die Zugriffsnummer für Einwahlkonferenzen dem Standort zugewiesen, an dem sich der Registrierungspool des Kontaktobjekts befindet. |
SecondaryLanguages |
Optional |
Zeichenfolgenauflistung |
Optionale Auflistung von Sprachen, die auch für Einwahlkonferenzansagen verwendet werden können. Sekundäre Sprachen müssen als durch Kommas getrennte Liste mit Sprachcodes konfiguriert werden. Mit der folgenden Syntax legen Sie z. B. kanadisches Französisch und Französisch als sekundäre Sprachen fest: -SecondaryLanguages "fr-CA", "fr-FR". Einer Zugriffsnummer können bis zu vier sekundäre Sprachen zugeordnet werden. |
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
Microsoft.Rtc.Management.Xds.AccessNumber-Objekt. Set-CsDialInConferencingAccessNumber akzeptiert eine weitergeleitete Eingabe von Zugriffsnummerobjekten.
Rückgabetypen
Set-CsDialInConferencingAccessNumber gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.Xds.AccessNumber" konfiguriert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -DisplayName "Redmond Dial-In Access Number"
Der Befehl in Beispiel 1 ändert die Eigenschaft "DisplayName" für die Zugriffsnummer für Einwahlkonferenzen mit dem Identitätswert "sip:RedmondDialIn@litwareinc.com". In diesem Beispiel wurde als Anzeigename "Redmond Dial-In Access Number" festgelegt.
-------------------------- Beispiel 2 --------------------------
Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -Regions "Redmond", "Seattle"
In Beispiel 2 wird die Zugriffsnummer für Einwahlkonferenzen mit dem Identitätswert "sip:RedmondDialIn@litwareinc.com" geändert, um zwei Regionen anzugeben: "Redmond" und "Seattle". Hierzu wird der Parameter "Region" aufgerufen, gefolgt von den beiden Regionen (zwei durch Kommas voneinander getrennte Werte). Beachten Sie, dass beim Ausführen dieses Befehls ein Fehler auftreten kann, wenn die beiden Regionen ("Redmond" und "Seattle") noch nicht in den Wähleinstellungen definiert wurden.
-------------------------- Beispiel 3 --------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "fr-FR"}| Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-CA"
Im vorstehenden Beispiel werden alle Zugriffsnummern für Einwahlkonferenzen, bei denen als primäre Sprache Französisch festgelegt ist, so geändert, dass als sekundäre Sprache kanadisches Französisch verwendet wird. Hierzu wird zunächst Get-CsDialInConferencingAccessNumber aufgerufen, um eine Auflistung aller Einwahlnummern zurückzugeben, die für die Verwendung in der Organisation konfiguriert sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Zugriffsnummern herausfiltert, bei denen die Eigenschaft "PrimaryLanguage" den Wert "fr-FR" (Französisch) aufweist. Diese gefilterte Auflistung wird dann an Set-CsDialInConferencingAccessNumber weitergeleitet, das den Wert der Eigenschaft "SecondaryLanguage" auf kanadisches Französisch (fr-CA) festlegt.
-------------------------- Beispiel 4 --------------------------
Get-CsDialInConferencingAccessNumber -Filter {DisplayName -eq "Default DialIn Access Number"} | Set-CsDialInConferencingAccessNumber -DisplayName "Litwareinc Conferencing"
Der Befehl in Beispiel 4 ändert den Active Directory-Anzeigenamen für die angegebene Zugriffsnummer für Einwahlkonferenzen. Hierzu ruft der Befehl zunächst Get-CsDialInConferencingAccessNumber und den Parameter "Filter" auf, um die Einwahlnummer zurückzugeben, bei der die Eigenschaft "DisplayName" den Wert "Default DialIn Access Number" aufweist. Diese Zugriffsnummer wird dann an das Cmdlet Set-CsDialInConferencingAccessNumber weitergeleitet, das den Anzeigenamen in "Litwareinc Conferencing" ändert.
-------------------------- Beispiel 5 --------------------------
Get-CsDialInConferencingAccessNumber -Filter {LineUri -eq "TEL:+14255558715"} | Set-CsDialInConferencingAccessNumber -DisplayNumber "1-425-555-1298" -LineUri "tel:+14255551298"
In Beispiel 5 werden sowohl die Anzeigenummer als auch der Anschluss-URI (Uniform Resource Identifier) für die angegebene Zugriffsnummer für Einwahlkonferenzen geändert. Mit dem Befehl werden zunächst Get-CsDialInConferencingAccessNumber und der Parameter "Filter" aufgerufen, um die zu ändernde Nummer abzurufen. Der zugehörige Filterwert beschränkt die zurückgegebenen Daten auf die Zugriffsnummer, bei der die Eigenschaft "LineUri" den Wert "TEL:+14255558715" aufweist. Diese Zugriffsnummer wird dann an das Cmdlet Set-CsDialInConferencingAccessNumber weitergeleitet, das die Eigenschaften "DisplayNumber" und "LineUri" der Zugriffsnummer ändert.
-------------------------- Beispiel 6 --------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -ne "en-US"} | Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-FR","it-IT"
Mit dem vorstehenden Befehl werden zwei sekundäre Sprachen allen Zugriffsnummern für Einwahlkonferenzen zugewiesen, bei denen US-Englisch nicht die primäre Sprache ist. Hierzu ruft der Befehl zunächst Get-CsDialInConferencingAccessNumber auf, um eine Auflistung aller Zugriffsnummern für Einwahlkonferenzen zurückzugeben, die für die Verwendung in der Organisation konfiguriert sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Nummern auswählt, bei denen die Eigenschaft "PrimaryLanguage" nicht den Wert "en-US" (US-Englisch) aufweist. Die gefilterte Auflistung wird dann an das Cmdlet Set-CsDialInConferencingAccessNumber weitergeleitet, das mit dem Parameter "-SecondaryLanguages" jeder Nummer in der Auflistung die sekundären Sprachen Französisch (fr-FR) und Italienisch (it-IT) zuweist.
-------------------------- Beispiel 7 -------------------------
Get-CsDialInConferencingAccessNumber -Identity ""sip:RedmondDialIn@litwareinc.com"" -Priority 0 -ReorderedRegion Redmond
Der in Beispiel 7 gezeigte Befehl weist der Zugriffsnummer "sip:RedmondDialIn@litwareinc.com" für Einwahlkonferenzen die höchste Priorität in der Region "Redmond" zu. Dies führt dazu, dass die Nummer in Besprechungseinladungen und auf der Webseite für Einwahlkonferenzen an erster Stelle aufgeführt wird. Zur Festlegung der Priorität wird der Parameter "Priority" mit dem Wert 0 eingeschlossen. (Die Zugriffsnummer mit der höchsten Priorität weist den Wert 0 für "Priority" auf, die Nummer mit der zweithöchsten Priorität erhält den Wert 1 für "Priority" usw.) Zusätzlich wird der Parameter "ReorderedRegion" verwendet, um anzugeben, dass die Prioritäten für Zugriffsnummern innerhalb der Region "Redmond" geändert werden sollen.
Siehe auch
Weitere Ressourcen
Get-CsDialInConferencingAccessNumber
New-CsDialInConferencingAccessNumber
Remove-CsDialInConferencingAccessNumber