Freigeben über

  • Artikel

Set-CsLocationPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert eine vorhandene Ortungsrichtlinie.

Syntax

Set-CsLocationPolicy [-Identity <XdsIdentity>] [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsLocationPolicy [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mit der Ortungsrichtlinie werden Einstellungen im Zusammenhang mit der Funktion für 9-1-1 (erweitert) (E9-1-1) und dem Clientstandort zugewiesen. Die Ortungsrichtlinie ermittelt, ob E9-1-1 für einen Benutzer aktiviert ist, und legt ggf. das Verhalten eines Notrufs fest. Sie können mit der Ortungsrichtlinie beispielsweise definieren, welche Nummer als Notrufnummer betrachtet wird, ob die Abteilung für Unternehmenssicherheit automatisch benachrichtigt werden soll und wie der Anruf weitergeleitet werden soll. Dieses Cmdlet ändert eine vorhandene Ortungsrichtlinie.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eine eindeutige ID für die Ortungsrichtlinie, die geändert werden soll. Zum Ändern der globalen Ortungsrichtlinie verwenden Sie den Wert "Global". Für eine auf Standortebene erstellte Richtlinie erhält dieser Wert das Format "site:<Standortname>", wobei der Standortname dem Namen eines Standorts entspricht, der in der Microsoft Lync Server 2010-Bereitstellung definiert ist (z. B. "site:Redmond"). Für eine auf Benutzerebene erstellte Richtlinie entspricht dieser Wert dem Namen der Richtlinie, beispielsweise "Reno".

Instance

Optional

LocationPolicy

Ein Verweis auf ein Ortungsrichtlinienobjekt. Dieses Objekt muss ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy" sein und kann durch Aufrufen von Get-CsLocationPolicy abgerufen werden. Rufen Sie dieses Objekt ab, ändern Sie die Eigenschaften im Arbeitsspeicher, und übergeben Sie dann den Objektverweis als Wert an diesen Parameter, um die Ortungsrichtlinie zu aktualisieren.

ConferenceMode

Optional

ConferenceModeEnum

Wenn für den Parameter "ConferenceUri" ein Wert angegeben wurde, bestimmt der Parameter "ConferenceMode", ob ein dritter Teilnehmer an dem Anruf teilnehmen oder nur zuhören kann. Verfügbare Werte:

- oneway: Der dritte Teilnehmer kann die Unterhaltung zwischen dem Anrufer und der Rettungsleitstelle nur hören.

- twoway: Der dritte Teilnehmer kann die Unterhaltung zwischen dem Anrufer und der Rettungsleitstelle hören und daran teilnehmen.

ConferenceUri

Optional

Zeichenfolge

Der SIP-URI (Uniform Resource Identifier), in diesem Fall die Telefonnummer, eines dritten Teilnehmers, der bei allen abgesetzten Notrufen zugeschaltet wird. Beispielsweise kann die Sicherheitsstelle des Unternehmens beim Absetzen eines Notrufs einen Anruf erhalten und den Anruf abhören oder daran teilnehmen (je nach Wert der Eigenschaft "ConferenceMode").

Die Zeichenfolge muss zwischen 1 und 256 Zeichen lang sein und mit dem Präfix "sip:" beginnen.

Description

Optional

Zeichenfolge

Eine ausführliche Beschreibung des Standorts. Beispiel: Building 30, 3rd Floor, Northeast corner.

EmergencyDialMask

Optional

Zeichenfolge

Eine Nummer, die gewählt wird und die in den Wert der Eigenschaft "EmergencyDialString" übersetzt wird. Wenn der Wert für "EmergencyDialMask" beispielsweise 212 lautet und "EmergencyDialString" den Wert 911 aufweist, wird zum Beispiel automatisch ein Notruf abgesetzt, sobald ein Benutzer 212 wählt. Auf diese Weise können andere Notrufnummern eingerichtet werden, die dennoch die Notrufdienste erreichen. (Dies ist beispielsweise hilfreich, wenn jemand aus einem Land oder einer Region mit einer anderen Notrufnummer versucht, die Notrufnummer des eigenen Landes zu wählen und nicht die Notrufnummer des Landes oder der Region, in dem/der er sich gerade aufhält.) Sie können mehrere Notrufmasken definieren, indem Sie die Werte durch Semikolon trennen. Beispiel: -EmergencyDialMask "212;414".

WICHTIG: Stellen Sie sicher, dass die angegebenen Notrufmaskenwerte nicht mit einer Nummer im Bereich eines Orbits zum Parken von Anrufen übereinstimmen. Die Weiterleitung zum Parken von Anrufen hat Vorrang vor der Konvertierung von Notrufzeichenfolgen. Zur Anzeige der vorhandenen Bereiche von Orbits zum Parken von Anrufen rufen Sie das Cmdlet Get-CsCallParkOrbit auf.

Die maximale Länge der Zeichenfolge beträgt 100 Zeichen. Bei jedem Zeichen muss es sich um eine Ziffer von 0 bis 9 handeln.

EmergencyDialString

Optional

Zeichenfolge

Die Nummer, die zum Erreichen der Notrufdienste gewählt wird. In den USA lautet dieser Wert "911".

Die Zeichenfolge muss aus den Ziffern 0 bis 9 bestehen und kann 1 bis 10 Zeichen lang sein.

EnhancedEmergencyServicesEnabled

Optional

Boolescher Wert

Gibt an, ob die dieser Richtlinie zugeordneten Benutzer für E9-1-1 aktiviert sind. Setzen Sie den Wert auf "True", um E9-1-1 zu aktivieren. Lync Server-Clients rufen dann Ortungsinformationen zur Registrierung ab und berücksichtigen diese Informationen, wenn ein Notruf abgesetzt wird.

LocationRequired

Optional

LocationRequiredEnum

Wenn der Client keinen Standort aus der Standortkonfigurationsdatenbank abrufen konnte, kann der Benutzer zur manuellen Eingabe eines Standorts aufgefordert werden. Dieser Parameter nimmt die folgenden Werte an:

- no: Der Benutzer wird nicht zur Eingabe eines Standorts aufgefordert. Wird ein Anruf ohne Standortinformationen getätigt, nimmt der Anbieter für die Notrufunterstützung den Anruf entgegen und fragt nach dem Standort.

- yes: Der Benutzer wird zur Eingabe von Standortinformationen aufgefordert, wenn der Client sich an einem neuen Standort registriert. Der Benutzer kann die Eingabeaufforderung ohne Eingabe von Informationen verwerfen. Wenn Informationen eingegeben werden, wird ein Notruf zur Überprüfung des Standorts zunächst vom Anbieter für die Notrufunterstützung angenommen, bevor er an die Rettungsleitstelle weitergeleitet wird.

- disclaimer: Diese Option entspricht der Option "yes". Allerdings wird dem Benutzer ein Haftungsausschluss angezeigt, der ihn auf die möglichen Folgen hinweist, wenn er keine Standortinformationen eingibt. (Der Haftungsausschluss muss über das Cmdlet Set-CsEnhancedEmergencyServiceDisclaimer festgelegt werden.)

Dieser Wert wird ignoriert, wenn "EnhancedEmergencyServicesEnabled" auf "False" (die Standardeinstellung) festgelegt ist. Benutzer werden nicht zur Eingabe von Standortinformationen aufgefordert.

NotificationUri

Optional

Zeichenfolge

Ein oder mehrere SIP-URIs (Uniform Resource Identifier), die beim Absetzen eines Notrufs benachrichtigt werden sollen. Beispielsweise kann die Sicherheitsstelle des Unternehmens durch eine Sofortnachricht über jeden Notruf informiert werden. Wenn der Anruferstandort verfügbar ist, wird dieser Standort in die Benachrichtigung aufgenommen.

Es können mehrere SIP-URIs als eine durch Kommas getrennte Liste eingeschlossen werden. Beispiel: -NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com. Beachten Sie, dass Verteilerlisten und Gruppen-URIs nicht unterstützt werden.

Die Zeichenfolge muss zwischen 1 und 256 Zeichen lang sein und mit dem Präfix "sip:" beginnen.

PstnUsage

Optional

Zeichenfolge

Die PSTN-Verwendung (Public Switched Telephone Network) zur Bestimmung der VoIP-Route, die zum Weiterleiten von Notrufen von Clients aus eingesetzt wird, die dieses Profil verwenden. Die dieser Verwendung zugeordnete Route muss auf einen SIP-Trunk verweisen, der speziell für Notrufe eingerichtet wurde.

Die Verwendung muss bereits in der globalen Liste der PSTN-Verwendungen vorhanden sein. Rufen Sie das Cmdlet Get-CsPstnUsage auf, um eine Liste der Verwendungen abzurufen. Zur Erstellung einer neuen Verwendung verwenden Sie das Cmdlet Set-CsPstnUsage.

UseLocationForE911Only

Optional

Boolescher Wert

Standortinformationen können vom Microsoft Lync 2010-Client aus verschiedenen Gründen verwendet werden (beispielsweise zur Benachrichtigung von Teamkollegen über den aktuellen Standort). Setzen Sie diesen Wert auf "True", um sicherzustellen, dass Standortinformationen nur für einen Notruf zur Verfügung stehen.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy-Objekt. Akzeptiert eine weitergeleitete Eingabe von Ortungsrichtlinienobjekten.

Rückgabetypen

Dieses Cmdlet gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy" konfiguriert.

Beispiel

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

Set-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True

Dieser Befehl verwendet das Cmdlet Set-CsLocationPolicy zum Ändern der Ortungsrichtlinie mit dem Identitätswert "site:Redmond". (Anders ausgedrückt, er ändert die dem Standort "Redmond" zugeordnete Ortungsrichtlinie.) In diesem Fall legt der Befehl den Wert der Eigenschaft "EnhancedEmergencyServicesEnabled" auf "True" fest, sodass die E9-1-1-Funktion für alle Benutzer aktiviert wird, die mit dem Standort "Redmond" verbunden sind.

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

Get-CsLocationPolicy | Where-Object {$_.ConferenceUri -ne $null} | Set-CsLocationPolicy -ConferenceMode twoway

In Beispiel 2 werden alle in der Organisation verwendeten Ortungsrichtlinien geändert, für die ein Konferenz-URI definiert wurde, um den Konferenzmodus auf "twoway" festzulegen. Hierzu ruft der Befehl zunächst Get-CsLocationPolicy auf, um eine Auflistung aller derzeit definierten Ortungsrichtlinien zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, um die Auflistung auf die Ortungsrichtlinien zu beschränken, deren Eigenschaft "ConferenceUri" nicht leer (d. h. ungleich Null) ist. Das Ergebnis ist eine Auflistung von Ortungsrichtlinien, die über Werte für "ConferenceUri" verfügen. Diese Auflistung wird dann an das Cmdlet Set-CsLocationPolicy weitergeleitet, das den Wert der Eigenschaft "ConferenceMode" für jede Richtlinie in der Auflistung ändert und den Wert auf "twoway" setzt.