Set-CsLisLocation

Syntax

Set-CsLisLocation -City <String> -CompanyName <String> -Country <String> -HouseNumber <String> -HouseNumberSuffix <String> -Location <String> -PostalCode <String> -PostDirectional <String> -PreDirectional <String> -State <String> -StreetName <String> -StreetSuffix <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Set-CsLisLocation -Instance <PSObject> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mit E9-1-1 können Notrufoperatoren den geografischen Standort des Anrufers ermitteln, ohne dass der Anrufer nach dieser Information gefragt werden muss. In Microsoft Lync Server 2010 wird der Standort anhand der Zuordnung des Ports, Subnetzes, Switches oder drahtlosen Zugriffspunkts eines Anrufers zu einem spezifischen Standort bestimmt. (Diese Standortzuordnung wird auch als "Wiremap" bezeichnet.) Dieses Cmdlet fügt der Liste mit Standorten, die in der Standortkonfigurationsdatenbank auf dem LIS-Server (Location Information Server) gespeichert ist, eine neue Adresse hinzu oder ändert eine vorhandene Adresse. Die Standorte werden nachfolgend mit einer Liste gültiger Adressen abgeglichen, die von dem Anbieter für die Notrufunterstützung bereitgestellt wird, der mit dem Unternehmen zusammenarbeitet.

Die Kombination aller erforderlichen Parameter (mit Ausnahme von "Instance") für dieses Cmdlet stellt einen eindeutigen Eintrag dar. Durch das Ändern einer dieser Parameter wird kein vorhandener Standort geändert, sondern ein neuer Standort erstellt. Beachten Sie, dass sämtliche dieser Parameter erforderlich sind (einige können Nullwerte enthalten). Die Parameter, die keine Nullwerte enthalten dürfen, sind: Location, HouseNumber, StreetName, City, State, Country. Zum Ändern eines vorhandenen Werts müssen Sie den Parameter "Instance" verwenden (oder eine Instanz an das Cmdlet weiterleiten).

Neben der Möglichkeit, über dieses Cmdlet einen Standort zu erstellen, wird automatisch ein Standort erstellt, wenn eine neue Adresse für Port, Subnetz, Switch oder den drahtlosen Zugriffspunkt eingegeben wird. Diese Informationen können mit den Cmdlets Set-CsLisPort, Set-CsLisSubnet, Set-CsLisSwitch und Set-CsLisWirelessAccessPoint eingegeben werden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsLisLocation 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-CsLisLocation"}

Parameter

Eingabetypen

Akzeptiert eine weitergeleitete Eingabe von LIS-Standortobjekten.

Rückgabetypen

Dieses Cmdlet gibt keine Werte oder Objekte zurück. Es erstellt oder ändert ein Objekt vom Typ "System.Management.Automation.PSCustomObject".

Beispiel

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

Set-CsLisLocation -Location Bldg30NEWing -HouseNumber 1000 -StreetName Main -City Redmond -State WA -Country US

In Beispiel 1 wird ein neuer Standort namens "Bldg30NEWing" erstellt. Dieser Befehl füllt alle Parameter, die zur Erstellung eines Standorts erforderlich sind. In diesem Beispiel lautet die Adresse für den Standort "1000 Main, Redmond, WA, US". Diese Adresse wird eingegeben, indem der Parameter "HouseNumber" den Wert 1000 erhält. Der Parameter "StreetName" erhält den Wert "Main", der Parameter "City" den Wert "Redmond" und der Parameter "Country" den Wert "US".

Beachten Sie, dass Sie bei Ausführung eines Befehls mit den gezeigten Parametern zur Eingabe weiterer Parameter aufgefordert werden. Sie können jedoch bei jeder Aufforderung die EINGABETASTE drücken, ohne Werte anzugeben. Der Standort wird anschließend erstellt.

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

Set-CsLisLocation -Location "Suite 100/Office 20" -CompanyName "Litware, Inc." -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName Main -StreetSuffix St -PostDirectional "" -City Redmond -State WA -PostalCode 99999 -Country US

Dieses Beispiel ähnelt Beispiel 1 darin, dass ein neuer Standort erstellt wird. In diesem Beispiel werden jedoch alle Parameter für das Cmdlet angegeben. Eingabeaufforderungen wie in Beispiel 1 werden hierbei vermieden, indem alle Parameter, für die keine Werte angegeben werden sollen, auf leere Zeichenfolgen festgelegt werden.

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

$a = Get-CsLisLocation | Where-Object {$_.Location -ceq "Bldg30NEWing"}
Set-CsLisLocation -Instance $a -StreetSuffix Street

In diesem Beispiel wird der in Beispiel 1 erstellte Standort geändert. In der ersten Zeile des Beispiels wird zunächst das Cmdlet Get-CsLisLocation aufgerufen. Dadurch wird eine Auflistung aller Standorte zurückgegeben, die in der Lync Server 2010-Bereitstellung definiert wurden. Diese Auflistung wird anschließend an das Cmdlet Where-Object weitergeleitet. Where-Object ruft alle Elemente aus der Auflistung ab, bei denen die Eigenschaft "Location" den Wert "Bldg30NEWing" aufweist (der Vergleichsoperator "-ceq" steht für "case-sensitive equals"). Alle Objekte, die diesem Kriterium entsprechen, werden der Variablen "$a" zugewiesen.

In Zeile 2 wird das Cmdlet Set-CsLisLocation aufgerufen. Der erste Parameter ist "Instance". An diesen Parameter wird die Variable ($a) mit dem in Zeile 1 abgerufenen Objekt übergeben, in diesem Fall das zu ändernde Objekt. Anschließend wird dem Parameter "StreetSuffix" der Wert "Street" übergeben. Hierdurch wird der Wert der Eigenschaft "StreetSuffix" des Standorts in Variable "$a" in "Street" geändert.

Beachten Sie, dass "Location" keine eindeutige Eigenschaft ist; das Cmdlet Where-Object könnte mehr als einen Standort zurückgeben. In diesem Fall funktioniert das Beispiel nicht. Informationen zum Ändern mehrerer Standorte in einem Schritt finden Sie in Beispiel 4.

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

$a = Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"}
$a | Set-CsLisLocation -StreetSuffix Avenue

In Beispiel 4 wird die Eigenschaft "StreetSuffix" von einem oder mehreren Standortobjekten geändert. Das Beispiel beginnt ähnlich wie Beispiel 3. Zunächst werden mit dem Cmdlet Get-CsLisLocation alle Standorte abgerufen. Diese Auflistung von Standorten wird an das Cmdlet Where-Object weitergeleitet, das die Auflistung auf die Standorte beschränkt, deren Eigenschaft "Location" den Wert "NorthCampus" aufweist. Diese neue Auflistung wird in der Variablen "$a" gespeichert. In Zeile 2 werden die Inhalte von "$a" an das Cmdlet Set-CsLisLocation weitergeleitet. Dieses Cmdlet überprüft jedes in "$a" gespeicherte Objekt (jeden Standort) und ändert dieses Objekt. In diesem Fall wird der Wert der Eigenschaft "StreetSuffix" für jedes Objekt in "Avenue" geändert.

Die Befehle in diesem Beispiel können auch ohne eine Variable ausgeführt werden. Leiten Sie die Ergebnisse des Befehls Where-Object einfach an den Befehl Set-CsLisLocation weiter:

Get-CsLisLocation | Where-Object {$_.Location -ceq "NorthCampus"} | Set-CsLisLocation -StreetSuffix Avenue

Siehe auch

Weitere Ressourcen

Remove-CsLisLocation
Get-CsLisLocation
Set-CsLisPort
Set-CsLisSubnet
Set-CsLisSwitch
Set-CsLisWirelessAccessPoint
Get-CsLisCivicAddress