azcmagent disconnect

Tar bort den Azure Arc-aktiverade serverresursen i molnet och återställer konfigurationen av den lokala agenten. Detaljerad information om hur du tar bort tillägg och kopplar från och avinstallerar agenten finns i avinstallera agenten.

Användning

azcmagent disconnect [authentication] [flags]

Exempel

Koppla från en server med standardinloggningsmetoden (interaktiv webbläsare eller enhetskod).

azcmagent disconnect

Koppla från en server med hjälp av tjänstens huvudnamn.

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

Koppla från en server om motsvarande resurs i Azure redan har tagits bort.

azcmagent disconnect --force-local-only

Autentiseringsalternativ

Det finns fyra sätt att ange autentiseringsuppgifter för den Azure-anslutna datoragenten. Välj ett autentiseringsalternativ och ersätt [authentication] avsnittet i användningssyntaxen med de rekommenderade flaggorna.

Interaktiv webbläsarinloggning (endast Windows)

Det här alternativet är standardinställningen för Windows-operativsystem med skrivbordsmiljö. Inloggningssidan öppnas i standardwebbläsaren. Det här alternativet kan krävas om din organisation har konfigurerat principer för villkorlig åtkomst som kräver att du loggar in från betrodda datorer.

Ingen flagga krävs för att använda den interaktiva webbläsarinloggningen.

Inloggning med enhetskod

Det här alternativet genererar en kod som du kan använda för att logga in på en webbläsare på en annan enhet. Det här är standardalternativet för Windows Server Core-utgåvor och alla Linux-distributioner. När du kör anslutningskommandot har du 5 minuter på dig att öppna den angivna inloggnings-URL:en på en Internetansluten enhet och slutföra inloggningsflödet.

Om du vill autentisera med en enhetskod använder du --use-device-code flaggan.

Tjänstens huvudnamn med hemlighet

Med tjänstens huvudnamn kan du autentisera icke-interaktivt och används ofta för skalningsåtgärder där samma skript körs på flera servrar. Vi rekommenderar att du tillhandahåller information om tjänstens huvudnamn via en konfigurationsfil (se --config) för att undvika att exponera hemligheten i konsolloggar. Tjänstens huvudnamn bör också vara dedikerat för Arc-registrering och ha så få behörigheter som möjligt för att begränsa effekten av en stulen autentiseringsuppgift.

Om du vill autentisera med ett huvudnamn för tjänsten med hjälp av en hemlighet anger du tjänstens huvudnamns program-ID, hemlighet och klient-ID: --service-principal-id [appid] --service-principal-secret [secret] --tenant-id [tenantid]

Tjänstens huvudnamn med certifikat

Certifikatbaserad autentisering är ett säkrare sätt att autentisera med hjälp av tjänstens huvudnamn. Agenten accepterar båda PCKS #12 (. PFX-filer och ASCII-kodade filer (till exempel . PEM) som innehåller både privata och offentliga nycklar. Certifikatet måste vara tillgängligt på den lokala disken och användaren som kör azcmagent kommandot måste ha läsbehörighet till filen. Lösenordsskyddade PFX-filer stöds inte.

Om du vill autentisera med ett huvudnamn för tjänsten med hjälp av ett certifikat anger du tjänstens huvudnamns program-ID, klient-ID och sökväg till certifikatfilen: --service-principal-id [appId] --service-principal-cert [pathToPEMorPFXfile] --tenant-id [tenantid]

Mer information finns i skapa ett huvudnamn för tjänsten för RBAC med certifikatbaserad autentisering.

Åtkomsttoken

Åtkomsttoken kan också användas för icke-interaktiv autentisering, men är kortvariga och används vanligtvis av automatiseringslösningar som körs på flera servrar under en kort tidsperiod. Du kan hämta en åtkomsttoken med Get-AzAccessToken eller någon annan Microsoft Entra-klient.

Om du vill autentisera med en åtkomsttoken använder du --access-token [token] flaggan.

Flaggor

--access-token

Anger den Microsoft Entra-åtkomsttoken som används för att skapa den Azure Arc-aktiverade serverresursen i Azure. Mer information finns i autentiseringsalternativ.

-f, --force-local-only

Kopplar från servern utan att ta bort resursen i Azure. Används främst om Azure-resursen har tagits bort och den lokala agentkonfigurationen måste rensas.

-i, --service-principal-id

Anger program-ID för tjänstens huvudnamn som används för att skapa den Azure Arc-aktiverade serverresursen i Azure. Måste användas med flaggorna --tenant-id --service-principal-secret och eller --service-principal-cert . Mer information finns i autentiseringsalternativ.

--service-principal-cert

Anger sökvägen till en certifikatfil för tjänstens huvudnamn. Måste användas med flaggorna --service-principal-id och --tenant-id . Certifikatet måste innehålla en privat nyckel och kan finnas i en PKCS #12 (. PFX) eller ASCII-kodad text (. PEM. CRT)-format. Lösenordsskyddade PFX-filer stöds inte. Mer information finns i autentiseringsalternativ.

-p, --service-principal-secret

Anger tjänstens huvudnamnshemlighet. Måste användas med flaggorna --service-principal-id och --tenant-id . För att undvika att exponera hemligheten i konsolloggar rekommenderar Microsoft att du tillhandahåller tjänstens huvudnamnshemlighet i en konfigurationsfil. Mer information finns i autentiseringsalternativ.

--use-device-code

Generera en Inloggningskod för Microsoft Entra-enheter som kan anges i en webbläsare på en annan dator för att autentisera agenten med Azure. Mer information finns i autentiseringsalternativ.

--user-tenant-id

Klientorganisations-ID:t för det konto som används för att ansluta servern till Azure. Det här fältet krävs när klientorganisationen för registreringskontot inte är samma som den önskade klientorganisationen för den Azure Arc-aktiverade serverresursen.

Vanliga flaggor som är tillgängliga för alla kommandon

--config

Tar in en sökväg till en JSON- eller YAML-fil som innehåller indata till kommandot. Konfigurationsfilen ska innehålla en serie nyckel/värde-par där nyckeln matchar ett tillgängligt kommandoradsalternativ. Om du till exempel vill skicka in --verbose flaggan ser konfigurationsfilen ut så här:

{
    "verbose": true
}

Om ett kommandoradsalternativ finns i både kommandoanropet och en konfigurationsfil har det värde som anges på kommandoraden företräde.

-h, --help

Få hjälp för det aktuella kommandot, inklusive dess syntax och kommandoradsalternativ.

-j, --json

Mata ut kommandoresultatet i JSON-format.

--log-stderr

Omdirigeringsfel och utförliga meddelanden till standardfelströmmen (stderr). Som standard skickas alla utdata till standardutdataströmmen (stdout).

--no-color

Inaktivera färgutdata för terminaler som inte stöder ANSI-färger.

-v, --verbose

Visa mer detaljerad loggningsinformation medan kommandot körs. Användbart för felsökning av problem när du kör ett kommando.