Set-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 Set-SettingOverride per modificare le sostituzioni delle impostazioni che archiviano 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)

Set-SettingOverride
    [-Identity] <SettingOverrideIdParameter>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-MaxVersion <Version>]
    [-MinVersion <Version>]
    [-Parameters <MultiValuedProperty>]
    [-Reason <String>]
    [-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 di 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

Set-SettingOverride -Identity "Change OAB Generation" -Server Mailbox01 -Parameters @("WorkCycle=03:00:00")

In questo esempio viene modificata l'override dell'impostazione denominata Modifica generazione della Rubrica offline sul server denominato Mailbox01 impostando l'intervallo di generazione della Rubrica offline su 3 ore.

Parametri

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

Questo cmdlet ha una pausa incorporata, quindi è consigliabile usare -Confirm:$false per ignorare la conferma.

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

-Identity

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro Identity consente di specificare l'override di impostazione che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi l'override in maniera univoca. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

Proprietà dei parametri

Tipo:SettingOverrideIdParameter
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

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

Per rimuovere un valore di versione configurato in modo che la sostituzione si applichi a tutte le versioni di Exchange 2016, utilizzare il valore $null.

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.

Per rimuovere un valore di versione configurato in modo che la sostituzione si applichi a tutte le versioni di Exchange 2016, utilizzare il valore $null.

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

-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:False
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 viene utilizzato per fornire una descrizione del motivo per cui l'override è stato creato. 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:False
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.

Per rimuovere il server specificato in modo che la sostituzione si applichi a tutti i server Exchange 2016 nel foresta Active Directory, utilizzare il valore $null.

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.