Set-UMService

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solo in Exchange locale.

Utilizzare il cmdlet Set-UMService per modificare le proprietà del servizio Messaggistica unificata di Microsoft Exchange sui server Cassette postali di Exchange 2013 o Exchange 2016.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Default (Impostazione predefinita) 

Set-UMService
    [-Identity] <UMServerIdParameter>
    [-Confirm]
    [-DialPlans <MultiValuedProperty>]
    [-DomainController <Fqdn>]
    [-GrammarGenerationSchedule <ScheduleInterval[]>]
    [-IPAddressFamily <IPAddressFamily>]
    [-IPAddressFamilyConfigurable <Boolean>]
    [-IrmLogEnabled <Boolean>]
    [-IrmLogMaxAge <EnhancedTimeSpan>]
    [-IrmLogMaxDirectorySize <Unlimited>]
    [-IrmLogMaxFileSize <ByteQuantifiedSize>]
    [-IrmLogPath <LocalLongFullPath>]
    [-MaxCallsAllowed <Int32>]
    [-SIPAccessService <ProtocolConnectionSettings>]
    [-Status <ServerStatus>]
    [-UMStartupMode <UMStartupMode>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-UMService -Identity MyUMServer -IPAddressFamily Any -UMStartupMode Dual

In questo esempio vengono eseguite le azioni seguenti:

  • Al servizio Messaggistica unificata di Microsoft Exchange sul server Cassette postali MyUMServer viene consentito di accettare entrambi i pacchetti di dati IPv4 e IPv6.
  • Viene consentito l'avvio del servizio Messaggistica unificata di Microsoft Exchange sul server Cassette postali MyUMServer utilizzando entrambi i pacchetti di dati IPv4 e IPv6.

Esempio 2

Set-UMService -Identity MyUMServer -DialPlans $null

In questo esempio il server Cassette postali MyUMServer viene rimosso da tutti i dial plan di messaggistica unificata.

Esempio 3

Set-UMService -Identity MyUMServer -DialPlans MySIPDialPlan -MaxCallsAllowed 50 -SipAccessService northamerica.lyncpoolna.contoso.com:5061 -UMStartupMode TLS

In questo esempio vengono eseguite le azioni seguenti:

  • Il server Cassette postali MyUMServer viene aggiunto al dial plan di messaggistica unificata MySIPDialPlan.
  • Il numero massimo di chiamate in arrivo viene impostato su 50.
  • Imposta northamerica.lyncpoolna.contoso.com:5061 come FQDN e la porta per il servizio di accesso SIP utilizzato da Microsoft Lync Server o Skype for Business Server per le chiamate in ingresso e in uscita da client Lync o Skype for Business remoti.
  • Viene consentito l'avvio in modalità TLS del servizio Messaggistica unificata di Microsoft Exchange sul server Cassette postali MyUMServer.

Parametri

-Confirm

Applicabile: Exchange Server 2013, Exchange Server 2016

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DialPlans

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro DialPlans consente di specificare tutti i dial plan per cui il servizio di messaggistica unificata gestisce le chiamate in arrivo.

I server Exchange 2016 ed Exchange 2013 non possono essere associati a un dial plan TelExt o E.164 UM, ma possono essere associati o aggiunti ai dial plan SIP. Se si integra la messaggistica unificata con Lync Server 2010, Lync Server 2013 o Skype for Business Server 2015, è necessario associare o aggiungere tutti i server Exchange 2016 ed Exchange 2013 ai dial plan SIP.

È inoltre possibile utilizzare questo parametro per associare i server Messaggistica unificata di Exchange 2010 a un dial plan di messaggistica unificata.

Per inserire più valori e sovrascrivere le voci esistenti, utilizzare la seguente sintassi: Value1,Value2,...ValueN. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".

Per aggiungere o rimuovere uno o più valori senza alterare le voci esistenti, utilizzare la seguente sintassi: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DomainController

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Proprietà dei parametri

Tipo:Fqdn
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-GrammarGenerationSchedule

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro GrammarGenerationScheduleconsente di specificare gli orari pianificati per avviare la generazione della grammatica vocale. Il parametro consente un solo orario di avvio al giorno. L'ora programmata predefinita per la generazione della grammatica è 02.00–02.30 ora locale, ogni giorno.

La sintassi di questo parametro è: StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM]. È possibile specificare più pianificazioni separate da virgole: "Schedule1","Schedule2",..."ScheduleN".

È possibile usare i valori seguenti per i giorni:

  • Nome completo del giorno.
  • Nome abbreviato del giorno.
  • Numero intero compreso tra 0 e 6, dove 0 = domenica.

È possibile immettere l'ora nel formato 24 ore e omettere il valore AM/PM. Se si immette l'ora nel formato ora 12, includere uno spazio tra l'ora e il valore AM/PM.

È possibile combinare formati di data e ora.

Tra l'ora di inizio e di fine devono intercorrere almeno 15 minuti. I minuti saranno arrotondati a 0, 15, 30 o 45. Se si specifica più di un intervallo, fra un intervallo e l'altro dovranno intercorrere almeno 15 minuti.

Ecco alcuni esempi:

  • "Dom. 23.30-Lun. 01.30"
  • "6.22:00-6.22:15" (da sabato alle 22:00 fino a sabato alle 22:15.)
  • "Dom.1:15 AM-Monday.23:00"
  • "Lunedì.4:30-Lunedì.5:30","Mercoledì.4:30-Mercoledì.5:30" (Lunedì e mercoledì mattina dalle 4:30 alle 5:30.)

Proprietà dei parametri

Tipo:

ScheduleInterval[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro Identity consente di specificare il server Cassette postali che ospita la configurazione del servizio di messaggistica unificata che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • ExchangeLegacyDN
  • GUID

Proprietà dei parametri

Tipo:UMServerIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-IPAddressFamily

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro IPAddressFamily consente di specificare la versione IP (Internet Protocol) da utilizzare. I valori validi sono:

  • IPv4Only: il gateway IP di messaggistica unificata utilizza solo IPv4 per comunicare.
  • Solo IPv6: il gateway IP di messaggistica unificata utilizza solo IPv6.
  • Qualsiasi: IPv6 viene utilizzato per primo. Se IPv6 non è disponibile, viene utilizzato IPV4. Questo è il valore predefinito.

Proprietà dei parametri

Tipo:IPAddressFamily
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IPAddressFamilyConfigurable

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro IPAddressFamilyConfigurable specifica se si è in grado di impostare il parametro IPAddressFamily su IPv6Only o Any. L'impostazione predefinita è $true.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IrmLogEnabled

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro IrmLogEnabled consente di specificare se abilitare la registrazione delle transazioni IRM (Information Rights Management). La registrazione IRM è abilitata per impostazione predefinita. I valori validi sono:

  • $true: Abilita registrazione IRM
  • $false: disabilitare la registrazione IRM

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IrmLogMaxAge

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro IrmLogMaxAge consente di specificare il limite massimo di validità per il file di registro IRM. I file di registro precedenti alla data specificata vengono eliminati. Il valore predefinito è 30 giorni.

Per specificare un valore, immetterlo come intervallo di tempo: dd.hh:mm:ss dove dd = giorni, hh = ore, mm = minuti e ss = secondi.

L'intervallo di input valido per questo parametro è compreso tra 00:00:00 e 24855.03:14:07. Se si imposta il valore del parametro IrmLogMaxAge su 00:00:00, i file di registro di connettività non vengono eliminati automaticamente una volta raggiunto il limite di validità.

Proprietà dei parametri

Tipo:EnhancedTimeSpan
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IrmLogMaxDirectorySize

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro IrmLogMaxDirectorySize consente di specificare la dimensione massima di tutti i registri IRM nella directory dei registri di connettività. Quando una directory raggiunge la dimensione massima dei file, il server elimina innanzitutto i file di log meno recenti. Il valore predefinito è 250 MB.

Nel caso venga immesso un valore, qualificarlo con una delle seguenti unità:

  • B (byte)
  • KB (kilobyte)
  • MB (megabyte)
  • GB (gigabyte)
  • TB (terabyte)

I valori non qualificati vengono in genere trattati come byte, ma i valori piccoli possono essere arrotondati per eccesso al kilobyte più vicino.

Il valore del parametro IrmLogMaxFileSize deve essere minore o uguale al valore del parametro IrmLogMaxDirectorySize. L'intervallo di input valido per questi parametri è compreso tra 1 e 9223372036854775807 byte. Se si immette un valore unlimited, alla directory del registro di connettività non viene applicato alcun limite di dimensione.

Proprietà dei parametri

Tipo:Unlimited
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IrmLogMaxFileSize

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro IrmLogMaxFileSize consente di specificare la dimensione massima di ciascun file di registro IRM. Quando viene raggiunta la dimensione massima, viene creato un nuovo file di registro. Il valore predefinito è 10 MB.

Nel caso venga immesso un valore, qualificarlo con una delle seguenti unità:

  • B (byte)
  • KB (kilobyte)
  • MB (megabyte)
  • GB (gigabyte)
  • TB (terabyte)

I valori non qualificati vengono in genere trattati come byte, ma i valori piccoli possono essere arrotondati per eccesso al kilobyte più vicino.

Il valore del parametro IrmLogMaxFileSize deve essere minore o uguale al valore del parametro IrmLogMaxDirectorySize. L'intervallo di input valido per questi parametri è compreso tra 1 e 9223372036854775807 byte. Se si immette il valore unlimited, ai file di registro IRM non viene imposto alcun limite di dimensione.

Proprietà dei parametri

Tipo:ByteQuantifiedSize
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IrmLogPath

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro IrmLogPath consente di specificare il percorso predefinito della directory dei registri IRM. La posizione predefinita è %ExchangeInstallPath%IRMLogs.

Se si imposta il valore del parametro su $null, la registrazione IRM viene disabilitata. Tuttavia, se il valore del parametro IrmLogEnabled è $true, Exchange aggiunge errori al registro eventi dell'applicazione. La modalità da preferire per la disabilitazione della registrazione IRM è l'impostazione del parametro IrmLogEnabled su $false.

Proprietà dei parametri

Tipo:LocalLongFullPath
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MaxCallsAllowed

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro MaxCallsAllowed consente di specificare il numero massimo di chiamate vocali contemporanee consentite dal servizio di messaggistica unificata. Il valore predefinito è 100.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SIPAccessService

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro SIPAccessService consente di specificare la porta FQDN e TCP del pool Front End di Lync Server o del pool Front End di Skype for Business Server più vicino per le chiamate in ingresso e in uscita da utenti remoti di Lync o Skype for Business esterni alla rete.

Si consiglia di utilizzare sempre questo parametro nelle distribuzioni di Lync Server o Skype for Business Server che si estendono su più aree geografiche. In caso contrario, il servizio di messaggistica unificata di Microsoft Exchange potrebbe selezionare un pool per il traffico multimediale RTP (Real-Time Transport Protocol) che non è il più vicino geograficamente all'utente remoto.

Questo parametro viene configurato per ogni istanza del servizio Messaggistica unificata (ogni server Exchange) in modo che il valore identifichi il pool Front End di Lync Server o di Skype for Business Server più vicino al server Exchange.

Proprietà dei parametri

Tipo:ProtocolConnectionSettings
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Status

Applicabile: Exchange Server 2013, Exchange Server 2016

Questo parametro è deprecato e non viene più utilizzato.

Proprietà dei parametri

Tipo:ServerStatus
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UMStartupMode

Applicabile: Exchange Server 2013, Exchange Server 2016

Il parametro UMStartupMode consente di specificare la modalità di avvio per il servizio messaggistica unificata. I valori validi sono:

  • TCP (valore predefinito)
  • TLS
  • Doppio: il servizio può ascoltare sulle porte 5060 e 5061 contemporaneamente. Se si aggiunge il server Exchange a dial plan di messaggistica unificata con impostazioni di protezione diverse, è necessario utilizzare questo valore.

Se si modifica il valore di questo parametro, è necessario riavviare il servizio di messaggistica unificata.

Proprietà dei parametri

Tipo:UMStartupMode
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Server 2013, Exchange Server 2016

L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.