Get-CsNetworkSite
Letztes Änderungsdatum des Themas: 2012-03-23
Ruft einen oder mehrere Netzwerkstandorte ab, die für die Anrufsteuerung oder für 9-1-1 (erweitert) (E9-1-1) definiert wurden.
Syntax
Get-CsNetworkSite [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSite [-Filter <String>] [-LocalStore <SwitchParameter>]
Detaillierte Beschreibung
Netzwerkstandorte sind Niederlassungen oder Standorte, die in jeder Region einer Anrufsteuerungs- oder E9-1-1-Bereitstellung konfiguriert sind. Dieses Cmdlet ruft die Einstellungen für einen oder mehrere vorhandene Standorte ab.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsNetworkSite 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-CsNetworkSite"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsGlobalRelativeIdentity |
Die eindeutige ID des Netzwerkstandorts, der abgerufen werden soll. Standorte werden nur global erstellt. Sie müssen daher keinen Gültigkeitsbereich festlegen. Stattdessen müssen Sie nur die Standort-ID angeben. (Dieser Wert entspricht dem Wert von "NetworkSiteID" für den Netzwerkstandort.) |
Filter |
Optional |
Zeichenfolge |
Eine Platzhalterzeichenfolge zum Abrufen mehrerer Standorte, indem der Identitätswert des Standorts mit dem Filterwert abgeglichen wird. |
LocalStore |
Optional |
Switch-Parameter |
Ruft die Netzwerkstandortinformationen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen. |
Eingabetypen
Keine.
Rückgabetypen
Ruft ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType" ab.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsNetworkSite
Durch den Aufruf von Get-CsNetworkSite ohne Parameter werden alle Netzwerkstandorte zurückgegeben, die innerhalb der Microsoft Lync Server 2010-Bereitstellung für Anrufsteuerung oder E9-1-1 konfiguriert sind.
-------------------------- Beispiel 2 --------------------------
Get-CsNetworkSite -Identity Redmond
Mit diesem Befehl wird der Standort mit dem Identitätswert "Redmond" (per Definition auch der Wert für "NetworkSiteID") abgerufen.
-------------------------- Beispiel 3 --------------------------
Get-CsNetworkSite -Filter NA*
Der Befehl in Beispiel 3 ruft Get-CsNetworkSite mit dem Parameter "Filter" auf. Der Wert für den Parameter "Filter" lautet "NA*", d. h. mit diesem Befehl werden alle Standorte abgerufen, deren Identitätswert mit der Zeichenfolge "NA" beginnt, gefolgt von einer beliebigen Anzahl von Zeichen. Es werden beispielsweise Standorte wie "NARedmond", "NAVancouver" und "NAChicago" zurückgegeben.
-------------------------- Beispiel 4 --------------------------
Get-CsNetworkSite | Where-Object {$_.NetworkRegionID -eq "NorthAmerica"}
In Beispiel 4 werden die zwei Cmdlets Get-CsNetworkSite und Where-Object zum Abrufen aller Standorte verwendet, die Bestandteil der Region "NorthAmerica" sind. Der Befehl ruft zunächst das Cmdlet Get-CsNetworkSite ohne Parameter auf, um alle Netzwerkstandorte abzurufen. Diese Auflistung von Standorten wird anschließend an das Cmdlet Where-Object weitergeleitet, das die Auflistung filtert und nur die Standorte in der Auflistung auswählt, bei denen die Eigenschaft "NetworkRegionID" den Wert "NorthAmerica" aufweist (der Vergleichsoperator "-eq" steht für "equal to").