New-SettingOverride
Questo cmdlet è disponibile solo in Exchange locale.
Attenzione: l'utilizzo errato dei cmdlet di sostituzione dell'impostazione può causare gravi danni all'organizzazione di Exchange. Questo danno potrebbe richiedere la reinstallazione di Exchange. Usare questi cmdlet solo come indicato dalla documentazione del prodotto o sotto la direzione di Microsoft servizio clienti e supporto tecnico.
Usare il cmdlet New-SettingOverride per creare sostituzioni di impostazione che archivino le personalizzazioni di Exchange in Active Directory anziché nei file di testo nel server.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-SettingOverride
[-Name] <String>
-Component <String>
-Parameters <MultiValuedProperty>
-Reason <String>
-Section <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-MaxVersion <Version>]
[-MinVersion <Version>]
[-Server <String[]>]
[-WhatIf]
[<CommonParameters>] Descrizione
L'impostazione delle sostituzioni configura e archivia le personalizzazioni del server Exchange in Active Directory. Le impostazioni possono essere specifiche dell'organizzazione o del server e vengono mantenute in Active Directory in Aggiornamenti cumulativi di Exchange. Le personalizzazioni di Exchange in web.config o exe.config file di configurazione dell'applicazione XML sono specifiche del server e vanno perse quando si installa l'cu cu di Exchange successiva.
È 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
New-SettingOverride -Name "IM Override" -Component OwaServer -Section IMSettings -Parameters @("IMServerName=skype01.contoso.com","IMCertificateThumbprint=CDF34A740E9D225A1A06193A9D44B2CE22775308") -Reason "Configure IM"In questo esempio viene creata una nuova sostituzione dell'impostazione denominata Integrazione del server di messaggistica istantanea. Questa sostituzione specifica il pool di Skype for Business Server 2015 e un'identificazione personale del certificato che consente l'integrazione della messaggistica istantanea tra Outlook sul web e Skype for Business. Poiché il parametro Server non viene usato, l'override si applica a tutti i server Exchange 2016 nella foresta di Active Directory.
Per altre informazioni, vedere l'argomento Configurare l'integrazione della messaggistica istantanea con Outlook sul web in Exchange 2016.
Esempio 2
New-SettingOverride -Name "Change OAB Generation" -Server Mailbox01 -Component TimeBasedAssistants -Section OABGeneratorAssistant -Parameters @("WorkCycle=02:00:00") -Reason "Generate OAB Every 2 hours"In questo esempio viene creata una nuova sostituzione dell'impostazione denominata Change OAB Generation.This example creates a new setting override named Change OAB Generation. Questa sostituzione specifica un intervallo di generazione della Rubrica offline di 2 ore. Poiché viene usato il parametro Server, l'override si applica solo al server specificato denominato Mailbox01.
Per altre informazioni, vedere l'argomento Modificare la pianificazione di generazione della rubrica offline in Exchange.
Parametri
-Component
Il parametro Component consente di specificare il componente al quale viene applicato l'override di impostazione. Ad esempio:
- TimeBasedAssistants
- OwaServer
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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, Exchange Server 2019 |
-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, Exchange Server 2019 |
-Force
L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.
È possibile utilizzare questa opzione per eseguire attività a livello di programmazione, se la richiesta di un input amministrativo è inappropriata.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MaxVersion
Il parametro MaxVersion specifica la versione più recente di Exchange 2016 a cui si applica questa sostituzione (fino al valore specificato incluso).
L'input valido per questo parametro è un valore di versione di Exchange 2016 nel formato 15.1.xxx.xx. È possibile utilizzare valori con zero iniziale, che viene però rimosso dai risultati. Ad esempio, 15.01.0225.042 è memorizzato come 15.1.225.42.
Il valore predefinito è vuoto ($null), ovvero l'override si applica a tutte le versioni di Exchange 2016.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MinVersion
Il parametro MinVersion specifica la versione meno recente di Exchange 2016 a cui si applica questa sostituzione (fino al valore specificato incluso).
L'input valido per questo parametro è un valore di versione di Exchange 2016 nel formato 15.1.xxx.xx. È possibile utilizzare valori con zero iniziale, che viene però rimosso dai risultati. Ad esempio, 15.01.0225.042 è memorizzato come 15.1.225.42.
Il valore predefinito è vuoto ($null), ovvero l'override si applica a tutte le versioni di Exchange 2016.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
Il parametro Name consente di specificare il nome univoco dell'override di impostazione. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Parameters
Il parametro Parameters consente di specificare uno o più parametri per l'override disponibili per la combinazione dei valori dei parametri Component e Section. Questo parametro usa la sintassi : @("Parameter1=Value1","Parameter2=Value2"...). Ad esempio:
@("Enabled=true")@("IMServerName=<SkypePoolFQDN>","IMCertificateThumbprint=<ThumbprintGUID>")
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Reason
Il parametro Reason consente di specificare il motivo per cui si sta creando l'override di impostazione. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Section
Il parametro Section consente di specificare il nome della sezione per la quale viene creato l'override. I valori disponibili per questo parametro dipendono dal valore del parametro Component.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
Il parametro Server specifica il nome del server Exchange 2016 in cui si vuole applicare l'override. È possibile specificare un singolo nome di server di Exchange 2016 o una matrice di caratteri jolly per il nome del server Exchange 2016. Ad esempio, se si dispone di tre server Exchange 2016 denominati Exchange01, Exchange02 ed Exchange03, specificare il valore Exchange* per applicare l'override a tutti.
Se non si usa questo parametro per specificare un server, l'override si applica a tutti i server Exchange 2016 nella foresta di Active Directory.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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, Exchange Server 2019 |