• Articolo

New-CsExUmContact

 

Ultima modifica dell'argomento: 2012-03-25

Crea un nuovo oggetto contatto Operatore automatico o Accesso sottoscrittore per Messaggistica unificata di Exchange ospitato.

Sintassi

New-CsExUmContact -DisplayNumber <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> -SipAddress <String> [-AutoAttendant <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Microsoft Lync Server 2010 collabora con Messaggistica unificata di Exchange per fornire diverse funzionalità vocali, tra cui Operatore automatico e Accesso sottoscrittore. Se Messaggistica unificata di Exchange è fornito come servizio ospitato (anziché locale), è necessario creare oggetti contatto con questo cmdlet per applicare le funzionalità Operatore automatico e Accesso sottoscrittore. Per creare questi oggetti viene chiamato il cmdlet New-CsExUmContact.

Un oggetto contatto creato con questo cmdlet non sarà disponibile per l'uso nel sistema fin quando non sarà applicato un criterio di segreteria telefonica ospitato che configuri il routing per il contatto. Per recuperare i criteri di segreteria telefonica ospitati è possibile chiamare il cmdlet Get-CsHostedVoicemailPolicy. Dai criteri recuperati è possibile determinare se esiste un criterio globale o di sito appropriato, oppure se esiste un criterio per utente che deve essere assegnato a questo contatto.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsExUmContact in locale: RTCUniversalUserAdmins. Per restituire un elenco di tutti i ruoli RBAC 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 "New-CsExUmContact"}

Parametri

Parametro Obbligatorio Tipo Descrizione

SipAddress

Obbligatorio

Stringa

L'indirizzo SIP del contatto. Deve essere un nuovo indirizzo che non è già esistente come utente o contatto in Servizi di dominio Active Directory. Questo valore deve iniziare con la stringa sip: seguita dall'indirizzo SIP.

RegistrarPool

Obbligatorio

FQDN

Il nome di dominio completo del pool su cui è in esecuzione il servizio di registrazione.

Un contatto Messaggistica unificata di Exchange in Lync Server 2010 non può essere spostato nei pool che sono parte di distribuzioni di Microsoft Office Communications Server 2007 o Microsoft Office Communications Server 2007 R2.

Tipo di dati completi: Microsoft.Rtc.Management.Deploy.Fqdn

DisplayNumber

Obbligatorio

Stringa

Il numero di telefono del contatto. I numeri visualizzati per ogni contatto devono essere univoci (ad esempio, due contatti Messaggistica unificata di Exchange non possono avere lo stesso numero visualizzato).

Questo valore può iniziare con un segno più (+) e può contenere qualsiasi numero di cifre. La prima cifra non può essere uno zero.

OU

Obbligatorio

OUIdParameter

L'unità organizzativa che conterrà questo contatto in Active Directory.

Tipo di dati completi: Microsoft.Rtc.Management.AD.OUIdParameter

AutoAttendant

Facoltativo

Booleano

Specifica se questo oggetto contatto è un Operatore automatico. La funzionalità Operatore automatico mette a disposizione una serie di istruzioni vocali che consentono ai chiamanti di navigare nel sistema telefonico fino a raggiungere l'utente desiderato.

Valore predefinito: False

Description

Facoltativo

Stringa

Una descrizione del contatto. La descrizione consente agli amministratori di identificare il tipo di contatto (Operatore automatico o Accesso sottoscrittore), l'ubicazione, il provider o qualsiasi altra informazione che identifichi lo scopo di ciascun contatto Messaggistica unificata di Exchange.

PassThru

Facoltativo

Parametro opzionale

Restituisce i risultati di questo comando. Con l'esecuzione del cmdlet viene visualizzato l'oggetto appena creato; se si include questo parametro tale output viene ripetuto, pertanto l'uso del parametro si rivela ridondante.

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.

Tipi restituiti

Consente di creare un oggetto di tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

Esempio

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

New-CsExUmContact -SipAddress sip:exumsa1@fabrikam.com -RegistrarPool RedmondPool.litwareinc.com -OU "OU=ExUmContacts,DC=litwareinc,DC=com" -DisplayNumber 2065554567

Con questo esempio viene chiamato il cmdlet New-CsExUmContact per creare un nuovo oggetto contatto Active Directory di Messaggistica unificata di Exchange. Per creare un nuovo contatto è necessario fornire l'indirizzo SIP (in questo esempio sip:exumsa1@fabrikam.com) dell'Operatore automatico o dell'Accesso sottoscrittore. Inoltre, è necessario fornire il nome del pool in cui è in esecuzione il servizio Registrar di Lync Server 2010 (RedmondPool.litwareinc.com), l'unità organizzativa in cui saranno archiviate tali informazioni (OU=ExUmContacts,DC=litwareinc,DC=com) e il numero di telefono dell'Operatore automatico o dell'Accesso sottoscrittore (2065554567). Poiché il parametro AutoAttendant non è stato impostato esplicitamente, viene applicato il valore predefinito False e pertanto questo oggetto contatto sarà considerato come un contatto Accesso sottoscrittore.

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

New-CsExUmContact -SipAddress sip:exumaa1@fabrikam.com -RegistrarPool RedmondPool.litwareinc.com -OU "OU=ExUmContacts,DC=litwareinc,DC=com" -DisplayNumber 2065559876 -AutoAttendant $True

Con questo esempio, simile all'esempio 1, viene chiamato il cmdlet New-CsExUmContact per creare un nuovo contatto Messaggistica unificata di Exchange. Ancora una volta viene creato un nuovo contatto Operatore automatico o Accesso sottoscrittore, questa volta con l'indirizzo SIP sip:exumaa1@fabrikam.com. Vengono inoltre forniti il nome del pool in cui è in esecuzione il servizio Registrar di Lync Server 2010 (RedmondPool.litwareinc.com), l'unità organizzativa in cui saranno archiviate tali informazioni (OU=ExUmContacts,DC=litwareinc,DC=com) e il numero di telefono dell'Operatore automatico o dell'Accesso sottoscrittore (2065554567). La differenza rilevabile in questo esempio è l'impostazione del parametro facoltativo AutoAttendant su True ($True) per indicare che questo oggetto è in effetti un contatto Operatore automatico.