Condividi tramite


New-CsCommonAreaPhone

 

Ultima modifica dell'argomento: 2012-03-23

Consente di creare un nuovo telefono nelle aree comuni che può essere gestito utilizzando Microsoft Lync Server 2010. I telefoni nelle aree comuni sono telefoni posizionati nei corridoi degli edifici, sale di ritrovo o altre posizioni dove possono essere utilizzati da persone diverse e per diversi usi.

Sintassi

New-CsCommonAreaPhone -LineUri <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

New-CsCommonAreaPhone -DN <ADObjectId> -LineUri <String> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

I telefoni nelle aree comuni sono telefoni IP non associati ad un utente individuale. Invece di essere posizionati in qualche ufficio, i telefoni nelle aree comuni sono generalmente posizionati nei corridoi degli edifici, nelle mense, nelle aree riservate ai dipendenti e in altri luoghi dove è probabile si riuniscano molte persone. Per gli amministratori, questa rappresenta una sfida gestionale; questo perché i telefoni utilizzati in Lync Server 2010 vengono normalmente gestiti utilizzando criteri vocali e dial plan associati a utenti individuali. Ai telefoni nelle aree comuni non viene associato un utente individuale.

Una soluzione a questa sfida è rappresentata dalla creazione di oggetti contatto di Active Directory per tutti i telefoni nelle aree comuni. Questi oggetti contatto possono essere creati usando il cmdlet New-CsCommonAreaPhone. Come nel caso degli account utente, anche a questi oggetti contatto è possibile assegnare criteri e voice plan. Di conseguenza, sarà possibile mantenere il controllo dei telefoni nelle aree comuni anche se non sono associati a singoli utenti. Ad esempio, se si desidera evitare che le persone possano trasferire o parcheggiare le chiamate da un telefono in un'area comune, è possibile creare un criterio vocale che impedisca il trasferimento o il parcheggio delle chiamate e quindi assegnare questo criterio ai telefoni nelle aree comuni (oppure, più correttamente, all'oggetto contatto che rappresenta il telefono nell'area comune). Questo comando assegna il criterio vocale CommonAreaPhoneVoicePolicy a tutti i telefoni nelle aree comuni:

Get-CsCommonAreaPhone | Grant-CsVoicePolicy –PolicyName "CommonAreaPhoneVoicePolicy"

Si noti che è possibile creare nuovi telefoni nelle aree comuni usando il cmdlet New-CsCommonAreaPhone. New-CsCommonAreaPhone consente di creare nuovi oggetti contatto da utilizzare per i telefoni nelle aree comuni o associare oggetti contatto esistenti a un nuovo telefono in un'area comune. Per ulteriori informazioni, vedere le descrizioni dei parametri OU e DN in questo argomento.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsCommonAreaPhone può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins. Il permesso di eseguire questo cmdlet per siti specifici o specifiche unità organizzative di Active Directory (OU) può essere assegnato utilizzando il cmdlet Grant-CsOUPermission. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsCommonAreaPhone"}

Parametri

Parametro Obbligatorio Tipo Descrizione

LineUri

Obbligatorio

Stringa

Numero di telefono per il telefono nell'area comune. L'URI di linea deve essere specificato utilizzando il formato E.164 e il prefisso "TEL:". Ad esempio: TEL:+14255551297. Qualsiasi numero di interno deve essere aggiunto alla fine dell'URI di linea, ad esempio: TEL:+14255551297;ext=51297.

RegistrarPool

Obbligatorio

Stringa

Nome di dominio completo (FQDN) del pool di registrazione dove deve essere ospitato l'oggetto contatto. Ad esempio: -RegistrarPool "atl-cs-001.litwareinc.com".

Description

Facoltativo

Stringa

Consente di impostare l'attributo Description di Active Directory per il telefono nell'area comune. A sua volta, questa operazione consente di fornire informazioni aggiuntive sul telefono (ad esempio, dettagli sulla persona da contattare in caso si verifichino dei problemi con l'apparecchio).

DisplayName

Facoltativo

Stringa

Consente di impostare il nome visualizzato di Active Directory del telefono nell'area comune.

DisplayNumber

Facoltativo

Stringa

Numero telefonico come viene visualizzato in Microsoft Lync 2010. La proprietà DisplayNumber può essere formattata in qualsiasi modo; ad esempio, 1-800-555-1234, 1-(800)-555-1234, 1.800.555.1234 e così via. Quando si sceglie un numero da visualizzare, tenere presente che quel numero verrà visualizzato sullo schermo di un telefono nelle aree comuni solo se il numero può essere normalizzato. La normalizzazione è il procedimento di conversione delle stringhe di numeri nel formato standard dei numeri telefonici. Se non esiste una regola di normalizzazione per il formato del numero telefonico utilizzato nella configurazione del numero da visualizzare, sullo schermo del telefono nell'area comune comparirà il valore della proprietà LineUri invece del valore della proprietà DisplayNumber.

DN

Facoltativo

Nome distinto di Active Directory

Consente di associare un oggetto contatto di Active Directory esistente al nuovo telefono nell'area comune. Se si dispone di un oggetto contatto che si desidera associare a un telefono in un'area comune, utilizzare il parametro DN seguito dal nome distinto del contatto. Ad esempio: -DN "cn=Building 14 Lobby,dc=litwareinc,dc=com". Si noti che il comando avrà esito negativo, se il contatto specificato non esiste. Il comando avrà esito negativo anche se il contatto è già stato abilitato per Lync Server. In tal caso, è necessario prima disabilitare il contatto utilizzando Disable-CsUser e quindi eseguire New-CsCommonAreaPhone.

Il parametro DN è particolarmente utile per le organizzazioni che hanno già creato oggetti contatto per sale conferenza e altre entità. Questi contatti vengono spesso utilizzati a scopo di pianificazione. Utilizzando il parametro DN è possibile creare un nuovo telefono nell'area comune utilizzando uno di questi oggetti contatto pre esistenti.

Non è possibile utilizzare i parametri OU e DN nello stesso comando.

OU

Facoltativo

Nome distinto di Active Directory

Nome distinto dell'unità organizzativa di Active Directory dove dovrà essere collocato l'oggetto contatto. Ad esempio: -OU "ou=Redmond,dc=litwareinc,dc=com”.

Se si include il parametro OU, nell'unità organizzativa specificata verrà creato un nuovo contatto e a questo verrà automaticamente assegnato un identificatore univoco globale (GUID) come nome comune. Di conseguenza, l'oggetto contatto avrà un nome simile a questo: {ce84964a-c4da-4622-ad34-c54ff3ed361f}.

SipAddress

Facoltativo

Indirizzo SIP

Identificatore univoco che consente al telefono in un'area comune di comunicare con i dispositivi SIP come, ad esempio, Lync 2010. L'indirizzo SIP deve essere preceduto dal prefisso "sip:". e includere un dominio SIP valido. Ad esempio: sip:bldg14lobby@litwareinc.com.

PassThru

Facoltativo

Parametro opzionale

Restituisce un oggetto che rappresenta il telefono nell'area comune.

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

Nessuno. New-CsCommonAreaPhone non accetta input tramite pipeline.

Tipi restituiti

New-CsCommonAreaPhone consente di creare una nuova istanza dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Esempio

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

New-CsCommonAreaPhone -LineUri tel:+14255556710 -RegistrarPool redmond-cs-001.litwareinc.com -DisplayName "Building 14 Lobby" -OU "ou=Telecommunications,dc=litwareinc,dc=com"

Il comando riportato nell'Esempio 1 consente di creare un nuovo telefono in un'area comune con numero telefonico 1-425-555-6710. Si noti che il parametro LineUri deve essere specificato utilizzando il formato E.164. Oltre a specificare il numero di telefono, il comando specifica anche il pool di registrazione (RegistrarPool), il nome visualizzato di Active Directory (DisplayName) e il nome distinto dell'unità organizzativa in cui deve essere creato il corrispondente oggetto contatto (OU).

-------------------------- Esempio 2 ------------------------

New-CsCommonAreaPhone -LineUri tel:+14255556710 -RegistrarPool redmond-cs-001.litwareinc.com -DN "cn=Building 14 Lobby,ou=Telecommunications,dc=litwareinc,dc=com"

Il comando riportato nell'Esempio 2 è una variante del comando riportato nell'Esempio 1. Nell'Esempio 2, però, il nuovo telefono in un'area comune è associato a un oggetto contatto di Active Directory esistente. Per ottenere questo risultato, il comando utilizza il parametro DN invece del parametro OU, specificando il nome distinto dell'oggetto contatto esistente (cn=Building 14 Lobby,ou=Telecommunications,dc=litwareinc,dc=com) come valore del parametro. In questo comando, anche il parametro DisplayName viene ignorato e ciò significa che il nuovo telefono in un'area comune utilizzerà il nome visualizzato assegnato all'oggetto contatto esistente.