az agentfabric

Note

Questo riferimento fa parte dell'estensione agentfabric per il interfaccia della riga di comando di Azure (versione 2.75.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az agentfabric . Altre informazioni sulle estensioni.

Gestire Fabric agente e Microsoft correlati. Risorse NetworkSecurity. I comandi radice gestiscono le risorse di Agent Fabric.

Gestire Fabric agente e Microsoft correlati. Risorse NetworkSecurity. I comandi di creazione radice, visualizzazione, elenco, aggiornamento ed eliminazione gestiscono le risorse di Agent Fabric.

Comandi

Nome Descrizione Tipo Status
az agentfabric aks

Gestire l'agente Fabric registrazione di calcolo.

Extension GA
az agentfabric aks attach

Collegare una risorsa di calcolo a un Fabric di Agent.

Extension GA
az agentfabric aks detach

Eliminare un'associazione di calcolo Fabric agent.

Extension GA
az agentfabric aks list

Elencare le associazioni di calcolo in un Fabric di Agent.

Extension GA
az agentfabric aks show

Visualizzare un'associazione di calcolo Fabric agent.

Extension GA
az agentfabric aks update

Applicare patch ai tag di registrazione, allo SKU o all'INDIRIZZO IP del gateway.

Extension GA
az agentfabric aks wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

Extension GA
az agentfabric create

Creare o sostituire una risorsa Fabric Agent.

Extension GA
az agentfabric delete

Eliminare una risorsa Fabric Agent.

Extension GA
az agentfabric egress-trust-bundle

Leggere Bundle di trust in uscita Fabric agent.

Extension GA
az agentfabric egress-trust-bundle list

Elencare i bundle di trust in uscita per un Fabric di Agent.

Extension GA
az agentfabric egress-trust-bundle show

Mostra il bundle di trust in uscita predefinito per un Fabric di Agent.

Extension GA
az agentfabric list

Elencare le risorse Fabric agent.

Extension GA
az agentfabric member

Gestire i membri Fabric agent.

Extension GA
az agentfabric member list

Elencare i membri di un Fabric di Agent.

Extension GA
az agentfabric member show

Mostra un membro Fabric Agent.

Extension GA
az agentfabric member wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

Extension GA
az agentfabric policy-group

Gestire gli agenti indipendenti Fabric gruppi di criteri.

Extension GA
az agentfabric policy-group create

Creare un Microsoft indipendente. Gruppo di criteri di sicurezza di rete.

Extension GA
az agentfabric policy-group delete

Eliminare un gruppo di criteri indipendente.

Extension GA
az agentfabric policy-group list

Elencare i gruppi di criteri indipendenti.

Extension GA
az agentfabric policy-group show

Mostra un gruppo di criteri indipendente.

Extension GA
az agentfabric policy-group update

Aggiornare i tag di un gruppo di criteri indipendente.

Extension GA
az agentfabric policy-group wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

Extension GA
az agentfabric show

Visualizzare una risorsa Fabric agent.

Extension GA
az agentfabric update

Aggiornare i tag dell'agente Fabric o l'identità assegnata dal sistema.

Extension GA
az agentfabric wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

Extension GA

az agentfabric create

Creare o sostituire una risorsa Fabric Agent.

Creare un agente Fabric, inclusa l'identità assegnata dal sistema facoltativa e completare la coppia api-key/endpoint di ispezione dei contenuti di proprietà del cliente. Omettendo il profilo di ispezione o fornendo un oggetto vuoto, non viene richiesta alcuna modifica di connessione per un Fabric esistente.

az agentfabric create --name
                      --resource-group
                      [--acquire-policy-token]
                      [--change-reference]
                      [--content-inspection-profile --inspection-profile]
                      [--default-policy-groups]
                      [--identity]
                      [--location]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--tags]
                      [--trust-domain]

Esempio

Creare un Fabric agente con l'ispezione dei contenuti di proprietà del cliente

az agentfabric create --resource-group rgnetworksecurity --name testAIFabric --location westus3 --trust-domain contoso.agentfabric --identity "{type:SystemAssigned}" --inspection-profile "{endpoint:'https://contoso.cognitiveservices.azure.com/',api-key:<content-safety-api-key>}"

Creare un Fabric agente senza ispezione del contenuto

az agentfabric create --resource-group rgnetworksecurity --name testAIFabric --location westus3 --trust-domain contoso.agentfabric

Parametri necessari

--name -n

Nome di AgentFabric.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--content-inspection-profile --inspection-profile -p

Connessione all'account content safety Azure del cliente. Per una nuova infrastruttura creata con versione 2026-10-07-preview API o successiva, omettendo questo profilo o fornendo {} richieste senza funzionalità di ispezione e non usa alcun account di proprietà della piattaforma o fallback con chiave condivisa. Per un'infrastruttura esistente, omettendo il profilo da PUT, incluse le richieste provenienti da client meno recenti o fornendo {} , mantiene la connessione di proprietà del cliente, la connessione legacy a livello di area o l'assenza di connessione. L'oggetto vuoto è una richiesta di nessuna modifica della connessione, non di un profilo di sostituzione archiviato. Né omissione né {} rimozione, probe o creazione di una connessione o annullamento di un aggiornamento della connessione in sospeso. Altri campi Fabric e regole di compatibilità dei criteri sono ancora applicabili. Un profilo di richiesta nonempty richiede sia endpoint che apiKey, anche nell'endpoint non modificato. PUT può ruotare la chiave o sostituire l'endpoint fornendo la coppia completa. Le richieste PATCH di sola identità o tag non possono modificare questo profilo. Le infrastrutture legacy esistenti senza un profilo mantengono il percorso di autenticazione e l'endpoint di sicurezza del contenuto a livello di area. Omissione o {} trigger senza probe di connessione, chiamata di gestione dell'account, recupero delle chiavi o requisito delle credenziali. Specificare un profilo completo configura in modo esplicito una connessione di proprietà del cliente; non esiste alcuna conversione automatica o fallback di connessione non riuscita alle credenziali a livello di area. Il cliente è proprietario, paga e gestisce l'account. Il servizio non crea, riserva, gestisce o elimina il servizio. Il servizio convalida la configurazione di endpoint/credenziali nuove o modificate e l'API di sicurezza del contenuto richiesta prima dell'attivazione; la configurazione da sola non indica l'idoneità o l'applicazione dei criteri attivi. La configurazione, GET e l'elenco invariati non attivano una nuova richiesta di convalida. Una sostituzione non riuscita mantiene la connessione e le credenziali esistenti, inclusa una connessione a livello di area legacy. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--default-policy-groups

I gruppi di criteri predefiniti da applicare a tutti i membri di questa infrastruttura. Un'infrastruttura senza una connessione di ispezione configurata non può fare riferimento a un gruppo contenente criteri ContentInspection, anche quando i selettori di tale criterio non corrispondono attualmente a traffico. Per un'infrastruttura esistente, la compatibilità usa la configurazione archiviata quando PUT omette contentInspectionProfile o fornisce un oggetto vuoto. Le infrastrutture legacy esistenti mantengono la connessione di sicurezza dei contenuti a livello di area, che soddisfa i prerequisiti di ispezione senza nuovi probe. Una connessione ancora in corso di convalida non è una connessione assente. La rimozione di un riferimento a un gruppo rimane consentita, soggetta ad altre convalide. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--identity

Identità del servizio gestita assegnata a questa infrastruttura. Il servizio lo usa per raggiungere i cluster associati all'infrastruttura per conto del cliente. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Resource Arguments
--location -l

Posizione geografica in cui si trova la risorsa Se non specificato, verrà usata la posizione del gruppo di risorse.

Proprietà Valore
Gruppo di parametri: Resource Arguments
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--tags

Tag delle risorse. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Resource Arguments
--trust-domain

Dominio di attendibilità che definisce l'ambito delle identità dei membri di questa infrastruttura. È il componente principale dell'identità di ogni membro, che assume il formato <trustDomain>/<agentFabricName>/<memberName>. Imposta in fase di creazione e non modificabile successivamente; se omesso, viene usato il dominio microsoft.agentfabric di attendibilità predefinito condiviso.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az agentfabric delete

Eliminare una risorsa Fabric Agent.

az agentfabric delete [--acquire-policy-token]
                      [--change-reference]
                      [--ids]
                      [--name]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--resource-group]
                      [--subscription]
                      [--yes]

Esempio

Eliminare un Fabric agente

az agentfabric delete --resource-group rgnetworksecurity --name testAIFabric

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--name -n

Nome di AgentFabric.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--yes -y

Non richiedere conferma.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az agentfabric list

Elencare le risorse Fabric agent.

az agentfabric list [--max-items]
                    [--next-token]
                    [--resource-group]

Esempio

Elencare Agent Fabric in un gruppo di risorse

az agentfabric list --resource-group rgnetworksecurity

Elencare Agent Fabric in una sottoscrizione

az agentfabric list

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token in --next-token argomento di un comando successivo.

Proprietà Valore
Gruppo di parametri: Pagination Arguments
--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

Proprietà Valore
Gruppo di parametri: Pagination Arguments
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az agentfabric show

Visualizzare una risorsa Fabric agent.

az agentfabric show [--ids]
                    [--name]
                    [--resource-group]
                    [--subscription]

Esempio

Mostra un Fabric agente

az agentfabric show --resource-group rgnetworksecurity --name testAIFabric

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--name -n

Nome di AgentFabric.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az agentfabric update

Aggiornare i tag dell'agente Fabric o l'identità assegnata dal sistema.

Applicare patch solo ai tag e all'identità assegnata dal sistema. L'ispezione del contenuto, il dominio di attendibilità e i gruppi di criteri predefiniti non sono input PATCH.

az agentfabric update [--acquire-policy-token]
                      [--change-reference]
                      [--identity]
                      [--ids]
                      [--name]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--resource-group]
                      [--subscription]
                      [--tags]

Esempio

Aggiornare i tag e l'identità dell'agente Fabric

az agentfabric update --resource-group rgnetworksecurity --name testAIFabric --tags "{env:prod}" --identity "{type:SystemAssigned}"

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--identity

Identità del servizio gestita assegnata a questa infrastruttura. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--name -n

Nome di AgentFabric.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--tags

Tag delle risorse. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az agentfabric wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

az agentfabric wait [--acquire-policy-token]
                    [--change-reference]
                    [--created]
                    [--custom]
                    [--deleted]
                    [--exists]
                    [--ids]
                    [--interval]
                    [--name]
                    [--resource-group]
                    [--subscription]
                    [--timeout]
                    [--updated]

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
--deleted

Attendere l'eliminazione.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: False
--exists

Attendere che la risorsa esista.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: False
--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--interval

Intervallo di polling in secondi.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: 30
--name -n

Nome di AgentFabric.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--timeout

Attesa massima in secondi.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Proprietà Valore
Gruppo di parametri: Wait Condition Arguments
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False