Freigeben über

  • Artikel

Get-CsDialInConferencingAccessNumber

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen über alle Zugriffsnummern für Einwahlkonferenzen zurück, die in Ihrer Organisation konfiguriert wurden. Bei Einwahlkonferenzen können Benutzer mit einem "normalen" Telefon, einem Mobiltelefon oder einem Gerät im Telefonfestnetz (Public Switched Telephone Network, PSTN) am Audioteil einer Onlinekonferenz teilnehmen.

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

Parameter Erforderlich Typ Beschreibung

Identity

Optional

SIP-Adresse

SIP-Adresse der abzurufenden Zugriffsnummer für Einwahlkonferenzen (d. h. das Kontaktobjekt, das die Nummer repräsentiert). Sie müssen das Präfix "sip:" beim Festlegen des Identitätswerts angeben, z. B. -Identity sip:RedmondDialIn@litwareinc.com.

Wenn dieser Parameter nicht angegeben ist, werden mit Get-CsDialInConferencingAccessNumber alle für die Verwendung in Ihrer Organisation konfigurierten Zugriffsnummern für Einwahlkonferenzen zurückgegeben.

Credential

Optional

PS-Objekt mit Anmeldeinformationen

Ermöglicht die Ausführung des Cmdlets Get-CsDialInConferencingAccessNumber mit anderen Anmeldeinformationen. Dies kann notwendig sein, wenn das für die Anmeldung bei Windows verwendete Konto nicht über die erforderlichen Berechtigungen verfügt, um mit Kontaktobjekten zu arbeiten.

Zur Verwendung des Parameters "Credential" muss zunächst über das Cmdlet Get-Credential ein PSCredential-Objekt erstellt werden. Einzelheiten finden Sie im Hilfethema Get-Credential.

DomainController

Optional

Zeichenfolge

Ermöglicht es Ihnen, zum Abrufen von Kontaktinformationen eine Verbindung mit dem angegebenen Domänencontroller herzustellen. Zum Herstellen einer Verbindung mit einem bestimmten Domänencontroller nehmen Sie den Parameter "DomainController" auf und geben anschließend den Computernamen (z. B. "atl-mcs-001") oder den vollqualifizierten Domänennamen (z. B. "atl-mcs-001.litwareinc.com") an.

EmptyRegion

Optional

Switch-Parameter

Gibt Informationen über die Wähleinstellungen zurück, die einer Region zugeordnet sind, die nicht mindestens einer Zugriffsnummer für Einwahlkonferenzen zugeordnet ist. Angenommen, die Wähleinstellungen "Bellevue" sind der Region Bellevue zugeordnet, es wurden jedoch keine Zugriffsnummern für die Region Bellevue konfiguriert. Die Region Bellevue würde demnach als leere Region betrachtet werden.

Dieser Parameter kann nicht gemeinsam mit einem anderen Parameter verwendet werden.

Filter

Optional

Zeichenfolge

Ermöglicht die Einschränkung der zurückgegebenen Daten, indem diese nach Microsoft Lync Server 2010-spezifischen Attributen gefiltert werden. Beispielsweise können Sie die zurückgegebenen Daten auf Einwahlkonferenznummern, deren Anzeigename den Zeichenfolgenwert "Redmond" enthält, oder auf gebührenfreie Einwahlkonferenznummern mit dem Präfix 1-800 beschränken.

Der Parameter "Filter" verwendet dieselbe Windows PowerShell-Filterungssyntax wie das Cmdlet Where-Object. Beispielsweise sieht ein Filter, der nur Zugriffsnummern mit dem Präfix 1-800 zurückgibt, folgendermaßen aus: {LineUri -like "tel:+1800*"}. "LineUri" steht hierbei für das Active Directory-Attribut, "-like" stellt den Vergleichsoperator dar, und "tel:+1800*" steht für den Filterwert.

OU

Optional

Zeichenfolge

Ermöglicht es Ihnen, die Zugriffsnummern aus einer bestimmten Active Directory-Organisationseinheit (Organizational Unit, OU) zurückzugeben. Diese umfassen sowohl Daten aus der angegebenen Organisationseinheit als auch aus allen untergeordneten Organisationseinheiten. Wenn die OU "Finance" z. B. über zwei untergeordnete OUs verfügt – "AccountsPayable" und "AccountsReceivable" – werden sämtliche Zugriffsnummern aus diesen drei OUs zurückgegeben.

Verwenden Sie beim Angeben einer Organisationseinheit den Distinguished Name des Containers, z. B.: -OU "OU=Finance,dc=litwareinc,dc=com".

Region

Optional

Zeichenfolge

Gibt alle Zugriffsnummern für Einwahlkonferenzen zurück, die der angegebenen Wähleinstellungsregion zugeordnet sind. Verwenden Sie beispielsweise folgende Syntax, um alle Einwahlnummern für die Region "Northwest" zurückzugeben: -Region Northwest.

Sie können auch Zugriffsnummern mit einem Gültigkeitsbereich für einen bestimmten Standort (oder die globale Ebene) zurückgeben, indem Sie die Ebene in den Parameterwert aufnehmen. Verwenden Sie beispielsweise diese Syntax, um Zugriffsnummern zurückzugeben, die die Region "Northwest" verwenden und für den Standort "Redmond" gültig sind: -Region site:Redmond/Northwest. Beachten Sie, dass Sie für den Verweis auf die Standortebene die Eigenschaft "SiteId" verwenden müssen. Sie können Werte für "SiteId" mit dem Cmdlet Get-CsSite abrufen.

Um eine Liste von Zugriffsnummern zurückzugeben, die keinen Wähleinstellungen zugeordnet sind, setzen Sie den Parameterwert von "Region" auf "$Null": -Region $Null.

Beachten Sie, dass Zugriffsnummern für Einwahlkonferenzen nur dann in der Reihenfolge ihrer zugewiesenen Priorität zurückgegeben werden, wenn dieser Parameter angegeben wird. Bei der Reihenfolge der Priorität handelt es sich um dieselbe Reihenfolge, in der die Nummern in Besprechungseinladungen und auf der Einwahlkonferenzen-Webseite angezeigt werden. Einzelheiten finden Sie im Hilfethema Set-CsDialInConferencingAccessNumber.

ResultSize

Optional

Ganze Zahl

Ermöglicht es Ihnen, die Anzahl von zurückgegebenen Datensätzen einzuschränken. Um beispielsweise nur sieben Zugriffsnummern (unabhängig von der Gesamtzahl der Zugriffsnummern in der Gesamtstruktur) zurückzugeben, verwenden Sie den Parameter "ResultSize", und legen Sie seinen Wert auf 7 fest. Beachten Sie, dass nicht garantiert werden kann, welche sieben Elemente zurückgegeben werden. Wenn Sie "ResultSize" auf 7 festlegen, jedoch nur drei Zugriffsnummern in Ihrer Gesamtstruktur vorhanden sind, werden diese drei Zugriffsnummern zurückgegeben, und der Befehl wird anschließend ohne Fehler abgeschlossen.

Für die Ergebnisgröße kann ein ganzzahliger Wert zwischen einschließlich 0 und 2147483647 festgelegt werden. Bei Festlegung von 0 wird der Befehl ausgeführt, es werden jedoch keine Daten zurückgegeben.

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.