Share via

Set-Contact

  • Articolo

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2009-05-12

Il cmdlet Set-Contact consente di modificare le impostazioni di un contatto esistente.

Sintassi

Set-Contact -Identity <ContactIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Contact [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-Instance <Contact>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descrizione dettagliata

È possibile utilizzare il cmdlet Set-Contact per modificare le impostazioni degli oggetti contatto visualizzabili in Utenti e computer di Active Directory. Se il contatto è abilitato all'utilizzo della posta, utilizzare il cmdlet Set-MailContact per modificare le impostazioni di posta elettronica del contatto non disponibili quando si utilizza il cmdlet Set-Contact.

Per eseguire il cmdlet Set-Contact, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo Exchange Recipient Administrator

  • Ruolo operatore account per i contenitori Active Directory applicabili

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

Il parametro Identity consente di specificare l'oggetto da modificare. Può assumere uno dei seguenti valori per l'oggetto contatto:

  • GUID

  • Nome distinto (DN)

  • Nome canonico

  • Nome

Il parametro Identity non può essere utilizzato nel caso in cui sia specificato il parametro Instance.

AllowUMCallsFromNonUsers

Facoltativo

Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags

Questo parametro consente di specificare se escludere il contatto dalle ricerche di directory.

AssistantName

Facoltativo

System.String

Il parametro AssistantName consente di definire il nome dell'assistente del contatto.

City

Facoltativo

System.String

Il parametro City consente di definire la città del contatto.

Company

Facoltativo

System.String

Il parametro Company consente di definire la società del contatto.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'utente, prima che l'elaborazione continui, confermi l'operazione che verrà eseguita dal comando. Non è necessario specificare alcun valore con il parametro Confirm.

CountryOrRegion

Facoltativo

Microsoft.Exchange.Data.Directory.CountryInfo

Il parametro CountryOrRegion consente di definire il Paese o l'area geografica del contatto.

CreateDTMFMap

Facoltativo

System.Boolean

Questo parametro consente di specificare una mappa DTMF (Dual Tone Multi-Frequency) da creare per il contatto.

Department

Facoltativo

System.String

Il parametro Department consente di definire il reparto del contatto.

DisplayName

Facoltativo

System.String

È possibile utilizzare il parametro DisplayName per specificare il nome del contatto in Exchange Management Console e nell'elenco indirizzi globale (GAL) di Exchange. DisplayName si applica solo agli oggetti abilitati alla posta.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di scrivere le modifiche alla configurazione nel servizio directory di Active Directory, includere il parametro DomainController.

Fax

Facoltativo

System.String

Il parametro Fax consente di definire il numero di fax del contatto.

FirstName

Facoltativo

System.String

Il parametro FirstName consente di definire il nome del contatto.

HomePhone

Facoltativo

System.String

Il parametro HomePhone consente di definire il numero di telefono dell'abitazione del contatto.

IgnoreDefaultScope

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro IgnoreDefaultScope indica al comando di ignorare l'impostazione predefinita dell'ambito del destinatario per Exchange Management Shell e utilizzare l'intera foresta come ambito. In questo modo il comando può accedere agli oggetti Active Directory che non si trovano correntemente nell'ambito predefinito. L'utilizzo del parametro IgnoreDefaultScope comporta le seguenti restrizioni:

  • Non è possibile utilizzare il parametro DomainController. Il comando utilizzerà automaticamente il server di catalogo globale corretto.

  • È possibile utilizzare solo il nome distinto per il parametro Identity. Altre forme di identificazione, quali l'alias o il GUID, non sono accettate.

Initials

Facoltativo

System.String

Il parametro Initials consente di definire le iniziali del nome del contatto.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.Management.Contact

Il parametro Instance consente di passare al comando l'intero oggetto per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare al comando un oggetto completo.

Il parametro Instance non può essere utilizzato nel caso in cui sia specificato il parametro Identity.

LastName

Facoltativo

System.String

Il parametro LastName consente di definire il cognome del contatto.

Manager

Facoltativo

Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter

Il parametro Manager consente di definire il manager del contatto.

MobilePhone

Facoltativo

System.String

Il parametro MobilePhone consente di definire il numero del cellulare principale del contatto.

Name

Facoltativo

System.String

Il parametro Name consente di specificare il nome del contatto in Utenti e computer di Active Directory e, se il gruppo è abilitato alla posta, anche nel campo Nome gruppo in Exchange Management Console.

Il valore Name non può contenere più di 64 caratteri.

Notes

Facoltativo

System.String

Il parametro Notes consente di definire informazioni aggiuntive sul contatto.

Office

Facoltativo

System.String

Il parametro Office consente di definire il nome o il numero dell'ufficio fisico del contatto.

OtherFax

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Il parametro OtherFax consente di definire il numero di fax alternativo del contatto.

OtherHomePhone

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Il parametro OtherHomePhone consente di definire il numero di telefono alternativo dell'abitazione del contatto.

OtherTelephone

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Il parametro OtherTelephone consente di definire il numero di telefono alternativo dell'ufficio del contatto.

Pager

Facoltativo

System.String

Il parametro Pager consente di definire il numero del cercapersone del contatto.

Phone

Facoltativo

System.String

Il parametro Phone consente di definire il numero di telefono dell'ufficio del contatto.

PhoneticDisplayName

Facoltativo

System.String

Il parametro PhoneticDisplayName consente di specificare la pronuncia fonetica del parametro DisplayName.

Il valore di questo parametro può contenere al massimo 255 caratteri. Per ulteriori informazioni sul parametro PhoneticDisplayName e sul riconoscimento vocale, vedere Concetti relativi alle ricerche nella directory di riconoscimento vocale automatico.

PostalCode

Facoltativo

System.String

Il parametro PostalCode consente di definire il codice di avviamento postale del contatto.

PostOfficeBox

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Il parametro PostOfficeBox consente di definire il numero di casetta postale del contatto.

SimpleDisplayName

Facoltativo

System.String

Il parametro SimpleDisplayName viene utilizzato per visualizzare una descrizione alternativa dell'oggetto quando è consentito solo un set di caratteri limitato, Tale set di caratteri limitato si compone dei seguenti caratteri:

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

SimpleDisplayName si applica solo agli oggetti abilitati alla posta.

StateOrProvince

Facoltativo

System.String

Il parametro StateOrProvince consente di definire lo Stato o la provincia del contatto.

StreetAddress

Facoltativo

System.String

Il parametro StreetAddress consente di definire l'indirizzo fisico del contatto.

TelephoneAssistant

Facoltativo

System.String

Il parametro TelephoneAssistant consente di definire il numero di telefono dell'assistente del contatto.

Title

Facoltativo

System.String

Il parametro Title consente di definire la posizione del contatto.

UMDialPlan

Facoltativo

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Questo parametro consente di specificare l'ID della directory del dial plan.

UMDtmfMap

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare se si intende creare una mappa DTMF definita dall'utente per il contatto abilitato alla messaggistica unificata. 

UseRusServer

Facoltativo

System.String
noteNota:
Questo parametro è disponibile solo in Exchange 2007 SP2.

Il parametro UseRusServer consente al comando di utilizzare il server Cassette postali specificato su cui è in esecuzione il Servizio elenco di indirizzi per ottenere e impostare la cassetta postale e gli attributi dell'utente di Active Directory.

Il Servizio elenco indirizzi è un componente del servizio Supervisore sistema di Exchange. Il Servizio elenco indirizzi consente di creare e gestire i valori degli attributi specifici di Exchange in Active Directory. È possibile utilizzare il Servizio elenco indirizzi per aggiornare gli oggetti destinatario in un dominio utilizzando informazioni specifiche, come l'appartenenza a un elenco di indirizzi e gli indirizzi di posta elettronica.

WebPage

Facoltativo

System.String

Il parametro WebPage consente di definire la pagina Web del contatto.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Non è necessario specificare alcun valore con il parametro WhatIf.

WindowsEmailAddress

Facoltativo

Microsoft.Exchange.Data.SmtpAddress

Il parametro WindowsEmailAddressconsente di specificare l'indirizzo di posta elettronica del contatto archiviato in Active Directory.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Eccezioni

Eccezioni Descrizione

 

 

Esempio

Nel seguente esempio di codice viene mostrato come utilizzare il comando Set-Contact per apportare le modifiche che seguono a un contatto esistente denominato Andrea Neri nel contenitore di utenti nel dominio di Active Directory denominato contoso.com:

  • Modifica del valore City in Roma.

  • Modifica del valore Company in Contoso.

Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"