New-SettingOverride
Questo cmdlet è disponibile solo in Exchange locale.
Attenzione: L'uso non corretto dei cmdlet di sostituzione delle impostazioni può causare gravi danni all'organizzazione di Exchange. Per risolvere questo problema potrebbe essere necessario reinstallare Exchange. Usare questi cmdlet solo come indicato nella documentazione del prodotto o sotto la direzione del servizio clienti e supporto tecnico Microsoft.
Utilizzare il cmdlet New-SettingOverride per creare sostituzioni delle impostazioni che archivino le personalizzazioni di Exchange in Active Directory anziché nei file di testo sul server.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
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
Impostazione delle sostituzioni: configurare e archiviare le personalizzazioni di Exchange Server in Active Directory. Le impostazioni possono essere specifiche dell'organizzazione o del server e vengono mantenute in Active Directory tra gli Aggiornamenti cumulativi (CU) di Exchange. Le personalizzazioni di Exchange nei file di configurazione dell'applicazione XML web.config o exe.config sono specifiche del server e vengono perse quando si installa l'aggiornamento cumulativo di Exchange successivo.
È 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
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 IM. 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 utilizzato, la sostituzione si applica a tutti i server Exchange 2016 nella foresta Active Directory.
Per ulteriori informazioni, vedere Configurare l'integrazione della messaggistica immediata con Outlook sul Web in Exchange.
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 Generazione della Rubrica fuori rete modifica. Questo override specifica un intervallo di generazione della Rubrica offline di 2 ore. Poiché viene utilizzato il parametro Server, la sostituzione si applica solo al server specificato denominato Mailbox01.
Per ulteriori informazioni, vedere Modificare la pianificazione della generazione della rubrica offline in Exchange.
Parametri
-Component
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro Component consente di specificare il componente al quale viene applicato l'override di impostazione. Ad esempio:
- TimeBasedAssistants
- OwaServer
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 |
-DomainController
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 |
-Force
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
L'interruttore di 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| 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 |
-MaxVersion
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro MaxVersion specifica l'ultima versione di Exchange 2016 a cui si applica questa sostituzione (fino al valore specificato incluso).
L'input valido per questo parametro è un valore della 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), il che significa che la sostituzione si applica a tutte le versioni di Exchange 2016.
Proprietà dei parametri
| Tipo: | Version |
| 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 |
-MinVersion
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro MinVersion consente di specificare 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 della 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), il che significa che la sostituzione si applica a tutte le versioni di Exchange 2016.
Proprietà dei parametri
| Tipo: | Version |
| 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 |
-Name
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro Name consente di specificare il nome univoco dell'override di impostazione. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Parameters
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 utilizza la sintassi seguente: @("Parameter1=Value1","Parameter2=Value2"...). Ad esempio:
@("Enabled=true")@("IMServerName=<SkypePoolFQDN>","IMCertificateThumbprint=<ThumbprintGUID>")
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Reason
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 (").
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Section
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Server
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro Server consente di specificare il nome del server Exchange 2016 a cui si desidera applicare la sostituzione. È possibile specificare un singolo nome di server Exchange 2016 o una matrice di caratteri jolly dei nomi dei server Exchange 2016. Ad esempio, se si dispone di tre server Exchange 2016 denominati Exchange01, Exchange02 ed Exchange03, specificare il valore Exchange* per applicare la sostituzione a tutti.
Se non si utilizza questo parametro per specificare un server, la sostituzione si applica a tutti i server di Exchange 2016 nella foresta Active Directory.
Proprietà dei parametri
| Tipo: | String[] |
| 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, Exchange Server 2019, Exchange Server SE
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.