Set-CmdletExtensionAgent

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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 9

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