Get-CsDialInConferencingAccessNumber

Syntax

Get-CsDialInConferencingAccessNumber [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Get-CsDialInConferencingAccessNumber [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-Region <String>] [-ResultSize <Unlimited>]

Get-CsDialInConferencingAccessNumber -EmptyRegion <SwitchParameter> [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

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 Onlinekonferenz teilzunehmen. So können Benutzer sogar ohne Computer oder Internetverbindung an der Besprechung teilnehmen. Den Benutzern stehen Audiofunktionen in vollem Umfang zur Verfügung: Sie können mit anderen Teilnehmern sprechen und alles hören. Sie können allerdings keine Präsentationen, Videofeeds oder andere visuellen Elemente sehen, die freigegeben wurden.

Damit Benutzer Einwahlkonferenzfunktionen erhalten, müssen Sie Zugriffsnummern für Einwahlkonferenzen erstellen: Telefonnummern, die Benutzer anrufen können, um mit einer Besprechung verbunden zu werden. Zugriffsnummern für Einwahlkonferenzen werden mit dem Cmdlet New-CsDialInConferencingAccessNumber erstellt. Wenn Sie eine neue Zugriffsnummer für Einwahlkonferenzen erstellen, erstellen Sie in Wirklichkeit ein neues Kontaktobjekt in Active Directory-Domänendienste (AD DS). Dieses Kontaktobjekt wird zur Darstellung der Zugriffsnummer und ihrer Eigenschaften verwendet. Kontaktnummern können über das Cmdlet Get-CsDialInConferencingAccessNumber abgerufen werden.

Wenn Sie Zugriffsnummern für Einwahlkonferenzen von Microsoft Office Communications Server 2007 importiert haben, werden diese Nummern auch abgerufen, indem Sie Get-CsDialInConferencingAccessNumber mit dem Parameter "Region" ausführen. (Importierte Nummern werden nur angezeigt, wenn Sie den Parameter "Region" verwenden.) Beachten Sie jedoch, dass neben den URIs (Uniform Resource Identifiers) der importierten Nummern eine Warnmeldung angezeigt wird. Auf diese Weise verarbeitet das Cmdlet importierte Zugriffsnummern für Einwahlkonferenzen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsDialInConferencingAccessNumber lokal auszuführen: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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-CsDialInConferencingAccessNumber"}

Parameter

Eingabetypen

Zeichenfolge. Get-CsDialInConferencingAccessNumber akzeptiert einen Zeichenfolgenwert, der den Identitätswert der Zugriffsnummer darstellt.

Rückgabetypen

Mit Get-CsDialInConferencingAccessNumber werden Instanzen des Objekts "Microsoft.Rtc.Management.Xds.AccessNumber" zurückgegeben.

Beispiel

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

Get-CsDialInConferencingAccessNumber

Der Befehl in Beispiel 1 gibt eine Auflistung aller derzeit in der Organisation konfigurierten Zugriffsnummern für Einwahlkonferenzen zurück. Wenn Sie Get-CsDialInConferencingAccessNumber ohne zusätzliche Parameter aufrufen, wird immer eine Auflistung aller verfügbaren Einwahlzugriffsnummern zurückgegeben.

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

Get-CsDialInConferencingAccessNumber -Identity sip:RedmondDialIn@litwareinc.com

In Beispiel 2 wird die Zugriffsnummer für Einwahlkonferenzen mit dem Identitätswert "sip:RedmondDialIn@litwareinc.com" zurückgegeben. Da Identitätswerte eindeutig sein müssen, gibt dieser Befehl immer nur eine Zugriffsnummer zurück.

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

Get-CsDialInConferencingAccessNumber -Region "Redmond"

In Beispiel 3 wird der Parameter "Region" zur Rückgabe aller Zugriffsnummern für Einwahlkonferenzen verwendet, die der Region Redmond zugeordnet sind. Dazu wird Get-CsDialInConferencingAccessNumber mit dem Parameter "Region" aufgerufen. Wenn Sie "Redmond" als Parameterwert angeben, gibt Get-CsDialInConferencingAccessNumber alle Nummern zurück, in denen "Redmond" in der Liste zugeordneter Regionen vorkommt. Beispielsweise würde eine Zugriffsnummer zurückgegeben werden, in der nur Redmond als Region aufgeführt ist, wie auch eine Zugriffsnummer, in der sowohl Redmond als auch Portland aufgeführt sind.

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

Get-CsDialInConferencingAccessNumber -Region $Null

Mit dem vorstehenden Befehl werden alle Zugriffsnummern für Einwahlkonferenzen zurückgegeben, die keiner Region zugeordnet sind (deren Eigenschaft "Regions" leer ist).

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

Get-CsDialInConferencingAccessNumber -Region site:USA/Redmond

Mit dem Befehl in Beispiel 5 werden alle Zugriffsnummern für Einwahlkonferenzen für die Region "Redmond" zurückgegeben, die für den Standort "USA" (d. h. der Standort, bei dem "SiteId" den Wert "site:USA" aufweist) gültig sind.

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

Get-CsDialInConferencingAccessNumber -Filter {DisplayName -like "*Seattle*"}

In Beispiel 6 wird der Parameter "Filter" zum Zurückgeben einer Auflistung aller Zugriffsnummern für Einwahlkonferenzen verwendet, deren Eigenschaft "DisplayName" den Zeichenfolgenwert "Seattle" enthält. Der Filterwert "{DisplayName -like "*Seattle*"}" beschränkt die zurückgegebenen Daten auf Zugriffsnummern, deren "DisplayName" das Wort "Seattle" umfasst (z. B. "Seattle Access Number", "Dial-In Number for Seattle", "Tacoma/Seattle Access Number" usw.).

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

Get-CsDialInConferencingAccessNumber -Filter {LineUri -like "tel:+1425*"}

In Beispiel 7 werden alle Zugriffsnummern für Einwahlkonferenzen zurückgegeben, deren Anschluss-URI mit "tel:+1425" beginnt. Auf diese Weise werden alle Zugriffsnummern mit der US-Ortsvorwahl 425 zurückgegeben. Hierzu wird Get-CsDialInConferencingAccessNumber mit dem Parameter "Filter" aufgerufen. Der Filterwert "{LineUri -like "tel:+1425*"}" beschränkt die zurückgegebenen Daten auf Anschluss-URIs, die mit dem Zeichenfolgenwert "tel:+1425" beginnen. Um alle Telefonnummern mit der Ortsvorwahl 425 oder mit der Ortsvorwahl 206 zurückzugeben, verwenden Sie folgenden Filterwert:

{LineUri -like "tel:+1425*" -or LineUri -like "tel:+1206*"}

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

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "it-IT"}

Im vorstehenden Beispiel wird eine Auflistung aller Zugriffsnummern für Einwahlkonferenzen zurückgegeben, bei denen die primäre Sprache auf Italienisch festgelegt ist. Hierzu wird zunächst Get-CsDialInConferencingAccessNumber aufgerufen, um eine Auflistung aller Zugriffsnummern zurückzugeben, die zur Nutzung in dieser Organisation konfiguriert wurden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Nummern herausfiltert, bei denen die Eigenschaft "PrimaryLanguage" den Wert "it-It" (Italienisch) aufweist.

-------------------------- Beispiel 9 -------------------------

Get-CsDialInConferencingAccessNumber  | Where-Object {$_.SecondaryLanguages -contains "fr-FR"}

Der Befehl in Beispiel 9 gibt alle Zugriffsnummern für Einwahlkonferenzen zurück, bei denen Französisch als eine der sekundären Sprachen aufgeführt ist. Hierzu wird zunächst Get-CsDialInConferencingAccessNumber ohne Parameter aufgerufen, um eine vollständige Auflistung der Zugriffsnummern zurückzugeben, die zur Nutzung in dieser Organisation konfiguriert wurden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Nummern herausfiltert, bei denen die Eigenschaft "SecondaryLanguages" einen Eintrag für Französisch, "fr-FR", enthält.

Siehe auch

Weitere Ressourcen

New-CsDialInConferencingAccessNumber
Remove-CsDialInConferencingAccessNumber
Set-CsDialInConferencingAccessNumber