• Articolo

Move-CsExUmContact

 

Ultima modifica dell'argomento: 2012-03-23

Consente di spostare uno o più contatti di Messaggistica unificata di Exchange in un nuovo pool di registrazione.

Sintassi

Move-CsExUmContact -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-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. Move-CsExUmContact offre un mezzo per spostare un oggetto contatto Messaggistica unificata di Exchange esistente in un nuovo pool di registrazione. Gli oggetti contatto possono essere spostati da un pool Microsoft Office Communications Server 2007 o Microsoft Office Communications Server 2007 R2 a un pool Lync Server 2010 oppure da un pool Lync Server 2010 a un altro. Questo cmdlet non consente di spostare un oggetto contatto di Messaggistica unificata di Exchange da un pool Lync Server 2010 a un pool Office Communications Server 2007 o Office Communications Server 2007 R2.

Quando viene spostato un oggetto contatto di Messaggistica unificata di Exchange, le proprietà AutoAttendant e IsSubscriberAccess vengono impostate in base al valore della proprietà OtherIpPhone dell'oggetto.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

UserIdParameter

L'identificatore univoco dell'oggetto contatto che si desidera spostare. Le identità dei contatti possono essere specificate utilizzando uno dei quattro formati seguenti: 1) l'indirizzo SIP del contatto; 2) l'UPN (User Principal Name) del contatto; 3) il nome di dominio e il nome di accesso del contatto, nella forma dominio\accesso (ad esempio litwareinc\davidegarghentini); 4) il nome visualizzato in Active Directory per il contatto (ad esempio Team Auto Attendant).

Target

Obbligatorio

FQDN

Il nome di dominio completo (FQDN) del pool di registrazione in cui deve essere spostato il contatto.

Confirm

Facoltativo

Parametro opzionale

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

DomainController

Facoltativo

FQDN

Consente di connettersi al controller di dominio specificato. Per la connessione a uno specifico controller di dominio, includere il parametro DomainController seguito dal nome computer (ad esempio atl-mcs-001) o dal suo nome di dominio completo (ad esempio atl-mcs-001.litwareinc.com).

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

PassThru

Facoltativo

Parametro opzionale

Consente di passare un oggetto contatto attraverso la pipeline che rappresenta l'account contatto spostato. Per impostazione predefinita, il cmdlet Move-CsExUmContact non passa oggetti attraverso la pipeline.

ProxyPool

Facoltativo

FQDN

Questo parametro è utilizzato solo per le istanze ospitate di Lync Server. Non deve essere utilizzato con un'implementazione locale di Lync Server.

WhatIf

Facoltativo

Parametro opzionale

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

Tipi di input

Stringa. Accetta un valore stringa da pipeline che rappresenta l'identità di un oggetto Messaggistica unificata di Exchange da spostare.

Tipi restituiti

Se chiamato con il parametro PassThru, restituisce un oggetto di tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

Esempio

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

Move-CsExUmContact -Identity "sip:exum1@fabrikam.com" -Target atl-cs-001.litwareinc.com

Con l'esempio 1 l'oggetto contatto di Messaggistica unificata di Exchange con indirizzo SIP exum1@fabrikam.com viene spostato nel pool di registrazione con FQDN atl-cs-001.litwareinc.com. All'esecuzione del comando viene visualizzata una richiesta di conferma, nonostante non sia stato incluso il parametro Confirm. La richiesta viene visualizzata anche se si include il parametro Force.

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

Get-CsExUmContact | Where-Object {$_.AutoAttendant -eq $True} | Move-CsExUmContact -Target atl-cs-001.litwareinc.com

Con questo esempio tutti gli oggetti contatto di Messaggistica unificata di Exchange che rappresentano operatori automatici vengono spostati nel pool di registrazione con FQDN atl-cs-001.litwareinc.com. L'esempio inizia con una chiamata a Get-CsExUmContact, che recupera tutti i contatti di Messaggistica unificata di Exchange definiti. Questa raccolta di contatti viene quindi inviata tramite pipe al cmdlet Where-Object, che individua tutti i contatti nella raccolta la cui proprietà AutoAttendant ha il valore True ($True), che indica che il contatto è un Operatore automatico.

Infine, la raccolta di contatti per cui AutoAttendant è True viene inviata tramite pipe al cmdlet Move-CsExUmContact, che sposta questi contatti nel pool di registrazione specificato nel parametro Target.

Come nell'esempio 1, viene richiesta una conferma durante l'esecuzione di questo comando.