Set-CmdletExtensionAgent
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet Set-CmdletExtensionAgent per modificare gli agenti di estensione del cmdlet. Per abilitare o disabilitare gli agenti di estensione del cmdlet, utilizzare i cmdlet Enable-CmdletExtensionAgent e Disable-CmdletExtensionAgent.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-CmdletExtensionAgent
[-Identity] <CmdletExtensionAgentIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Name <String>]
[-Priority <Byte>]
[-WhatIf]
[<CommonParameters>] Descrizione
Gli agenti di estensione dei cmdlet vengono usati dai cmdlet di Exchange in Exchange Server 2010 e versioni successive. I cmdlet forniti da altri Microsoft o prodotti di terze parti non possono usare gli agenti di estensione dei cmdlet.
Le modifiche apportate tramite il cmdlet Set-CmdletExtensionAgent vengono applicate a ogni server Exchange nell'organizzazione.
È 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-CmdletExtensionAgent "Validation Agent" -Priority 9Con questo esempio la priorità dell'agente di estensione cmdlet fittizio "Validation Agent" viene modificata in 9.
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 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Il parametro Identity consente di specificare l'agente di estensione del cmdlet che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi l'agente in maniera univoca. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
| Type: | CmdletExtensionAgentIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
Il parametro Name consente di specificare il nome univoco dell'agente di estensione del cmdlet. La lunghezza massima del nome dell'agente è di 64 caratteri. Se il nome contiene spazi, racchiudere il nome tra virgolette (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Priority
Il parametro Priority consente di specificare la priorità dell'agente di estensione del cmdlet. Gli agenti con priorità superiore vengono applicati per primi. Un valore valido è un numero intero compreso tra 0 e 255. Valori interi inferiori indicano una priorità maggiore.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, 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 2010, 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.