Condividi tramite

  • Articolo

Set-CsLisLocation

 

Ultima modifica dell'argomento: 2012-03-26

Crea una nuova posizione o modifica una posizione esistente nel database di configurazione delle posizioni per il servizio chiamate di emergenza.

Sintassi

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>]]

Descrizione dettagliata

Il servizio consente a chi risponde alle chiamate di emergenza di determinare la posizione geografica del chiamante senza dover richiedere al chiamante tali informazioni. In Microsoft Lync Server 2010 la posizione è determinata in base al mapping di porta, subnet, switch o punto di accesso wireless del chiamante a una posizione specifica. Questa mappa è definita mappa reticolare. Questo cmdlet consente di aggiungere un nuovo indirizzo o di modificare un indirizzo esistente nell'elenco delle posizioni archiviato nel database di configurazione delle posizioni sul server LIS (Location Information Server). Le posizioni vengono quindi fatte corrispondere a un elenco di indirizzi validi forniti dal provider dei servizi di emergenza che collabora con la società.

La combinazione di tutti i parametri obbligatori (diversi da Instance) per questo cmdlet costituisce una voce univoca. La modifica di uno qualsiasi di questi parametri provocherà la creazione di una nuova posizione, anziché la modifica di una posizione esistente. Anche se tutti questi parametri sono obbligatori, alcuni possono contenere valori null. I parametri che devono contenere valori diversi da null sono Location, HouseNumber, StreetName, City, State e Country. Per modificare un valore esistente è necessario utilizzare il parametro Instance (o inviare tramite pipe un'istanza al cmdlet).

Oltre a utilizzare questo cmdlet per creare una posizione, quando viene immesso un nuovo indirizzo per la porta, la subnet, lo switch o il punto di accesso wireless viene creata automaticamente una posizione. Queste informazioni possono essere immesse mediante i cmdlet Set-CsLisPort, Set-CsLisSubnet, Set-CsLisSwitch e Set-CsLisWirelessAccessPoint.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsLisLocation in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsLisLocation"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Instance

Obbligatorio

PSObject

Un riferimento a un oggetto posizione. Questo oggetto deve contenere le proprietà richieste per creare una posizione. È possibile recuperare un oggetto di questo tipo chiamando Get-CsLisLocation.

City

Obbligatorio

Stringa

La città della posizione.

Lunghezza massima: 64 caratteri.

CompanyName

Obbligatorio

Stringa

Il nome della società in questa posizione.

Lunghezza massima: 60 caratteri

Country

Obbligatorio

Stringa

Il paese/area geografica relativo alla posizione.

Lunghezza massima: 2 caratteri

HouseNumber

Obbligatorio

Stringa

Il numero civico della posizione. Nel caso di una società è il numero nella via in cui ha sede la società.

Lunghezza massima: 10 caratteri

HouseNumberSuffix

Obbligatorio

Stringa

Informazioni aggiuntive sul numero civico, come 1/2 o A. Ad esempio: 1234 1/2 Oak Street o 1234 A Elm Street.

Nota: per indicare un numero di appartamento o di un ufficio, è necessario utilizzare il parametro Location. Ad esempio: -Location "Suite 100/Office 150".

Lunghezza massima: 5 caratteri

Location

Obbligatorio

Stringa

Il nome della posizione. Generalmente questo valore è il nome di una posizione più specifica rispetto all'indirizzo civico, quale un numero di ufficio, ma può essere qualsiasi valore stringa.

Lunghezza massima: 20 caratteri

PostalCode

Obbligatorio

Stringa

Il codice postale associato a questa posizione.

Lunghezza massima: 10 caratteri

PostDirectional

Obbligatorio

Stringa

La designazione direzionale di una via. Esempio: NE o NW per Main Street NE o 7th Avenue NW.

Lunghezza massima: 2 caratteri

PreDirectional

Obbligatorio

Stringa

La designazione direzionale per un nome di una via che precede il nome della via. Esempio: NE o NW per NE Main Street o NW 7th Avenue.

Lunghezza massima: 2 caratteri

State

Obbligatorio

Stringa

Lo stato o la provincia associato a questa posizione.

Lunghezza massima: 2 caratteri

StreetName

Obbligatorio

Stringa

Il nome della via per questa posizione.

Lunghezza massima: 60 caratteri

StreetSuffix

Obbligatorio

Stringa

Il tipo di via indicato nel nome, ad esempio Street, Avenue o Court.

Lunghezza massima: 10 caratteri

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Consente di accettare l'input da pipeline di oggetti posizione LIS.

Tipi restituiti

Questo cmdlet non restituisce un valore o un oggetto. Crea o modifica un oggetto di tipo System.Management.Automation.PSCustomObject.

Esempio

-------------------------- Esempio 1 --------------------------

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

Con l'esempio 1 viene creata una nuova posizione denominata Bldg30NEWing. Questo comando specifica tutti i parametri per cui è obbligatorio un valore per la creazione di una posizione. In questo esempio l'indirizzo della posizione è 1000 Main, Redmond, WA, US. Tale indirizzo viene immesso specificando il parametro HouseNumber con il valore 1000, il parametro StreetName con il valore Main, il parametro City con il valore Redmond e il parametro Country con il valore US.

Se si esegue un comando con i parametri mostrati sarà richiesto di immettere altri parametri. Tuttavia, è sufficiente premere Invio ad ogni richiesta senza fornire valori per creare la posizione.

-------------------------- Esempio 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

Questo esempio è simile all'esempio 1 in quanto crea una nuova posizione. Tuttavia, in questo esempio il comando specifica tutti i parametri per il cmdlet. In questo modo si evitano i messaggi di richiesta che seguivano il comando nell'esempio 1, perché in questo esempio tutti i valori che si desidera lasciare vuoti sono impostati su stringhe vuote.

-------------------------- Esempio 3 --------------------------

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

Con questo esempio viene modificata la posizione creata nell'esempio 1. La prima riga nell'esempio inizia con una chiamata al cmdlet Get-CsLisLocation. Viene restituita una raccolta di tutte le posizioni definite nella distribuzione di Lync Server 2010. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object. Where-Object consente di recuperare tutti gli elementi della raccolta in cui la proprietà Location è uguale (-ceq, uguale con distinzione tra maiuscole e minuscole) a Bldg30NEWing. L'oggetto corrispondente a questo criterio viene assegnato alla variabile $a.

Nella riga 2 viene chiamato Set-CsLisLocation. Il primo parametro è il parametro Instance. A questo parametro viene passata la variabile ($a) contenente l'oggetto recuperato nella riga 1, vale a dire l'oggetto che si desidera modificare. Viene quindi specificato il parametro StreetSuffix, passando il valore Street. In questo modo il valore della proprietà StreetSuffix della posizione nella variabile $a viene cambiato in Street.

Tenere presente che, poiché Location non è una proprietà univoca, il cmdlet Where-Object può restituire più posizioni. In questo caso, l'esempio non funzionerà. Per modificare più posizioni contemporaneamente, vedere l'esempio 4.

-------------------------- Esempio 4 --------------------------

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

Con l'esempio 4 viene modificata la proprietà StreetSuffix di uno o più oggetti posizione. L'esempio è molto simile all'esempio 3. Viene innanzitutto chiamato Get-CsLisLocation per recuperare tutte le posizioni. Questa raccolta di posizioni viene inviata tramite pipe a Where-Object, che circoscrive la raccolta alle posizioni la cui proprietà Location è uguale a NorthCampus. Questa nuova raccolta è archiviata nella variabile $a. Nella riga 2 il contenuto di $a viene inviato tramite pipe al cmdlet Set-CsLisLocation. Questo cmdlet esegue un'iterazione nei vari oggetti (o posizioni) archiviati in $a, modificando gli oggetti relativi. In questo caso la modifica prevede il cambiamento della proprietà StreetSuffix di ogni oggetto in Avenue.

I comandi in questo esempio possono essere eseguiti anche senza l'uso di una variabile. È sufficiente inviare tramite pipe i risultati del comando Where-Object al comando Set-CsLisLocation:

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