Condividi tramite


Set-UMService

Questo cmdlet è disponibile solo in Exchange locale.

Usare il cmdlet Set-UMService per modificare le proprietà del servizio messaggistica unificata di Exchange Microsoft nei 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

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. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano 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 porta per il servizio di accesso SIP usato 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

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-DialPlans

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

I server Exchange 2016 ed Exchange 2013 non possono essere associati a un dial plan di messaggistica unificata TelExt o E.164, 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.

È anche possibile usare questo parametro per associare i server di messaggistica unificata di Exchange 2010 a un dial plan di messaggistica unificata.

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

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

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-DomainController

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.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-GrammarGenerationSchedule

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 per 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.
  • Intero compreso tra 0 e 6, dove 0 = domenica.

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

È possibile combinare e abbinare i formati di data/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" (Eseguire da sabato alle 22:00 fino a sabato alle 22:15).
  • "Dom.1:15-Lunedì.23:00"
  • "Monday.4:30 AM-Monday.5:30 AM","Wednesday.4:30 AM-Wednesday.5:30 AM" (Run on Monday and Wednesday mornings from 4:30 to 5:30.)
Type:ScheduleInterval[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-Identity

Il parametro Identity consente di specificare il server Cassette postali che ospita la configurazione del servizio 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
Type:UMServerIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IPAddressFamily

Il parametro IPAddressFamily consente di specificare se il gateway IP di messaggistica unificata utilizzerà IPv4, IPv6 o entrambi per comunicare. I valori validi sono:

  • IPv4
  • IPv6
  • Any: IPv6 viene usato per primo e, se necessario, il gateway IP di messaggistica unificata torna a IPv4. Questo è il valore predefinito.
Type:IPAddressFamily
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IPAddressFamilyConfigurable

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogEnabled

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: Abilitare la registrazione IRM
  • $false: Disabilitare la registrazione IRM
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogMaxAge

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à.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogMaxDirectorySize

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)

TB (terabyte)

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.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogMaxFileSize

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)

TB (terabyte)

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.

Type:ByteQuantifiedSize
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-IrmLogPath

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, impostando questo parametro su $null quando viene $true il valore del parametro IrmLogEnabled, vengono generati errori nel registro eventi dell'applicazione. La modalità da preferire per la disabilitazione della registrazione IRM è l'impostazione del parametro IrmLogEnabled su $false.

Type:LocalLongFullPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-MaxCallsAllowed

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-SIPAccessService

Il parametro SIPAccessService specifica il nome di dominio completo e la porta TCP del pool Front End di Lync Server più vicino o Skype for Business Server posizione del pool Front End per le chiamate in ingresso e in uscita da Lync remoto o Skype for Business utenti che si trovano all'esterno della rete.

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

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

Type:ProtocolConnectionSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-Status

Questo parametro è obsoleto e non viene più utilizzato.

Type:ServerStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-UMStartupMode

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

  • TCP (questo è il valore predefinito)
  • TLS
  • Doppio: il servizio può restare in ascolto contemporaneamente sulle porte 5060 e 5061. Se si aggiunge il server Exchange ai dial plan di messaggistica unificata con impostazioni di sicurezza diverse, è necessario usare questo valore.

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

Type:UMStartupMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016

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.