azcmagent disconnect

Elimina la risorsa server abilitata per Azure Arc nel cloud e reimposta la configurazione dell'agente locale. Per informazioni dettagliate sulla rimozione delle estensioni e la disconnessione e la disinstallazione dell'agente, vedere Disinstallare l'agente.

Utilizzo

azcmagent disconnect [authentication] [flags]

Esempi

Disconnettere un server usando il metodo di accesso predefinito (browser interattivo o codice del dispositivo).

azcmagent disconnect

Disconnettere un server usando un'entità servizio.

azcmagent disconnect --service-principal-id "ID" --service-principal-secret "SECRET"

Disconnettere un server se la risorsa corrispondente in Azure è già stata eliminata.

azcmagent disconnect --force-local-only

Opzioni di autenticazione

Esistono 4 modi per fornire le credenziali di autenticazione all'agente del computer connesso di Azure. Scegliere un'opzione di autenticazione e sostituire la [authentication] sezione nella sintassi di utilizzo con i flag consigliati.

Nota

L'account usato per disconnettere un server deve essere dallo stesso tenant della sottoscrizione in cui è registrato il server.

Accesso interattivo al browser (solo Windows)

Questa opzione è l'impostazione predefinita nei sistemi operativi Windows con un'esperienza desktop. La pagina di accesso viene aperta nel Web browser predefinito. Questa opzione potrebbe essere necessaria se l'organizzazione ha configurato criteri di accesso condizionale che richiedono l'accesso da computer attendibili.

Non è necessario alcun flag per usare l'account di accesso interattivo del browser.

Accesso al codice del dispositivo

Questa opzione genera un codice che è possibile usare per accedere a un Web browser in un altro dispositivo. Questa è l'opzione predefinita nelle edizioni principali di Windows Server e in tutte le distribuzioni linux. Quando si esegue il comando connect, è necessario avere 5 minuti per aprire l'URL di accesso specificato in un dispositivo connesso a Internet e completare il flusso di accesso.

Per eseguire l'autenticazione con un codice del dispositivo, usare il --use-device-code flag .

Entità servizio

Le entità servizio consentono di autenticare in modo non interattivo e vengono spesso usate per le operazioni su larga scala in cui lo stesso script viene eseguito su più server. È consigliabile fornire informazioni sull'entità servizio tramite un file di configurazione (vedere --config) per evitare di esporre il segreto in tutti i log della console.

Per eseguire l'autenticazione con un'entità servizio, specificare l'ID applicazione e il segreto dell'entità servizio: --service-principal-id [appid] --service-principal-secret [secret]

Token di accesso

I token di accesso possono essere usati anche per l'autenticazione non interattiva, ma sono di breve durata e in genere usati da soluzioni di automazione che operano su più server in un breve periodo di tempo. È possibile ottenere un token di accesso con Get-AzAccessToken o qualsiasi altro client Microsoft Entra.

Per eseguire l'autenticazione con un token di accesso, usare il --access-token [token] flag .

Flag

--access-token

Specifica il token di accesso Microsoft Entra usato per creare la risorsa server abilitata per Azure Arc in Azure. Per altre informazioni, vedere Opzioni di autenticazione.

-f, --force-local-only

Disconnette il server senza eliminare la risorsa in Azure. Usato principalmente se la risorsa di Azure è già stata eliminata e la configurazione dell'agente locale deve essere pulita.

-i, --service-principal-id

Specifica l'ID applicazione dell'entità servizio usata per creare la risorsa server abilitata per Azure Arc. Deve essere utilizzato con i --service-principal-secret flag e --tenant-id . Per altre informazioni, vedere Opzioni di autenticazione.

-p, --service-principal-secret

Specifica il segreto dell'entità servizio. Deve essere utilizzato con i --service-principal-id flag e --tenant-id . Per evitare di esporre il segreto nei log della console, è consigliabile passare il segreto dell'entità servizio in un file di configurazione. Per altre informazioni, vedere Opzioni di autenticazione.

--use-device-code

Generare un codice di accesso al dispositivo Microsoft Entra che può essere immesso in un Web browser in un altro computer per autenticare l'agente con Azure. Per altre informazioni, vedere Opzioni di autenticazione.

--user-tenant-id

ID tenant per l'account usato per connettere il server ad Azure. Questo campo è obbligatorio quando il tenant dell'account di onboarding non corrisponde al tenant desiderato per la risorsa server abilitata per Azure Arc.

Flag comuni disponibili per tutti i comandi

--config

Accetta un percorso di un file JSON o YAML contenente input al comando. Il file di configurazione deve contenere una serie di coppie chiave-valore in cui la chiave corrisponde a un'opzione della riga di comando disponibile. Ad esempio, per passare il --verbose flag, il file di configurazione sarà simile al seguente:

{
    "verbose": true
}

Se viene trovata un'opzione della riga di comando sia nella chiamata al comando che in un file di configurazione, il valore specificato nella riga di comando avrà la precedenza.

-h, --help

Ottenere la Guida per il comando corrente, inclusa la sintassi e le opzioni della riga di comando.

-j, --json

Restituire il risultato del comando nel formato JSON.

--log-stderr

Reindirizzare i messaggi di errore e dettagliati al flusso di errore standard (stderr). Per impostazione predefinita, tutto l'output viene inviato al flusso di output standard (stdout).

--no-color

Disabilitare l'output dei colori per i terminali che non supportano i colori ANSI.

-v, --verbose

Visualizzare informazioni di registrazione più dettagliate durante l'esecuzione del comando. Utile per la risoluzione dei problemi durante l'esecuzione di un comando.