Set-ServerComponentState
Questo cmdlet è disponibile solo in Exchange locale.
Usare il cmdlet Set-ServerComponentState per configurare e aggiornare i componenti e gli endpoint di Microsoft Exchange nei server specificati.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-ServerComponentState
[-Identity] <ServerIdParameter>
-Component <String>
-Requester <String>
-State <ServiceState>
[-Confirm]
[-DomainController <Fqdn>]
[-LocalOnly]
[-RemoteOnly]
[-TimeoutInSeconds <Int32>]
[-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-ServerComponentState -Identity MailboxServer01 -Component UMCallRouter -Requester Maintenance -State ActiveL'esempio seguente imposta lo stato di un componente di messaggistica unificata (UM) su Attivo, come richiesto dalla modalità di manutenzione.
Esempio 2
Set-ServerComponentState -Identity Exch5 -Component ServerWideOffline -State Inactive -Requester Maintenance
Set-ServerComponentState -Identity Exch5 -Component ServerWideOffline -State Active -Requester MaintenanceIn questo esempio viene preparato il server per la manutenzione, ad esempio l'installazione di un aggiornamento della sicurezza o di un aggiornamento cumulativo.
Il primo comando modifica lo stato di tutti i componenti del server in Inattivo.
Il secondo comando modifica lo stato in Attivo dopo il completamento della manutenzione (obbligatorio).
Nota: per impostazione predefinita, i servizi IMAP4 e POP3 di Microsoft Exchange si arrestano se i ImapProxy componenti correlati e PopProxy sono in stato inattivo. Potrebbe essere necessario riavviare manualmente i servizi dopo che i componenti correlati ImapProxy e PopProxy sono stati modificati nello stato Attivo.
Parametri
-Component
Il parametro Component specifica il componente o endpoint per il quale si vuole impostare lo stato.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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-*) 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, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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.
Il parametro DomainController non è supportato sui server Trasporto Edge. Un server Trasporto Edge usa l'istanza locale di Active Directory Lightweight Directory Services (AD LDS) per leggere e scrivere i dati.
| Tipo: | Fqdn |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Il parametro Identity consente di specificare il server Exchange in cui si vuole eseguire questo comando. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:
- Nome
- FQDN
- Nome distinto (DN)
- DN legacy di Exchange
| Tipo: | ServerIdParameter |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LocalOnly
L'opzione LocalOnly specifica che le modifiche vengono scritte solo nel Registro di sistema del server Exchange e non in Active Directory. Con questa opzione non è necessario specificare alcun valore.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RemoteOnly
L'opzione RemoteOnly specifica che le modifiche vengono scritte solo in Active Directory e non nel Registro di sistema del server Exchange. Con questa opzione non è necessario specificare alcun valore.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Requester
Il parametro Requester specifica il sistema che richiede questa modifica di stato. I valori validi sono:
- HEALTHAPI
- Manutenzione
- Linea laterale
- Funzionale
- Distribuzione
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-State
Il parametro State specifica lo stato che si desidera per il componente. I valori validi sono:
- Attivazione
- Inattivo
- Scolatura
| Tipo: | ServiceState |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TimeoutInSeconds
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Tipo: | Int32 |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.