Podręcznik interfejsu wiersza poleceń Bosch She46c05uc 33

• Artykuł
11/29/2022
• Czas czytania: 7 min

Zestaw . NET SDK zawiera funkcję telemetrii, która zbiera dane użycia i wysyła je do Microsoft podczas korzystania z poleceń interfejsu wiersza polecenia platformy. NET. Dane użycia zawierają informacje o wyjątkach w przypadku awarii interfejsu wiersza polecenia platformy. NET. Interfejs wiersza polecenia platformy. NET jest dostarczany z zestawem. NET SDK i jest zestawem zleceń, które umożliwiają kompilowanie, testowanie i publikowanie aplikacji platformy. Dane telemetryczne pomagają zespołowi platformy. NET zrozumieć, jak są używane narzędzia, aby można je było ulepszyć. Informacje o błędach pomagają zespołowi w rozwiązywaniu problemów i usuwaniu usterek.

Zebrane dane są publikowane w agregacji w ramach licencji Creative Commons Attribution License. Niektóre zebrane dane są publikowane w obszarze Dane telemetryczne interfejsu wiersza polecenia platformy.

Zakres

dotnet Ma dwie funkcje: do uruchamiania aplikacji i wykonywania poleceń interfejsu wiersza polecenia. Dane telemetryczne nie są zbierane w przypadku używania dotnet polecenia w celu uruchomienia aplikacji w następującym formacie:

• dotnet [path-to-app]. dll

Dane telemetryczne są zbierane podczas korzystania z dowolnego z poleceń interfejsu wiersza polecenia platformy. NET, takich jak:

• dotnet build
• dotnet pack
• dotnet run

Jak zrezygnować

Funkcja telemetrii zestawu. NET SDK jest domyślnie włączona. Aby zrezygnować z funkcji telemetrii, ustaw zmienną środowiskową na DOTNET_CLI_TELEMETRY_OPTOUT1 lub true.

Pojedynczy wpis telemetrii jest również wysyłany przez instalatora zestawu SDK platformy. NET w przypadku pomyślnej instalacji. Aby zrezygnować, przed zainstalowaniem zestawu SDK platformy. NET ustaw zmienną DOTNET_CLI_TELEMETRY_OPTOUT środowiskową.

Ważne

Aby zrezygnować po uruchomieniu instalatora: zamknij instalatora, ustaw zmienną środowiskową, a następnie uruchom instalatora ponownie z tym zestawem wartości.

Ujawnienie

Zestaw. NET SDK wyświetla tekst podobny do poniższego po pierwszym uruchomieniu jednego z poleceń interfejsu wiersza polecenia platformy. NET (na przykład dotnet build). Tekst może się nieco różnić w zależności od używanej wersji zestawu SDK. To środowisko "pierwszego uruchomienia" polega na tym, jak Microsoft powiadamia o zbieraniu danych.

Telemetry---------The. NET tools collect usage data in order to help us improve your experience. The data is collected by Microsoft and shared with the community. You can opt-out of telemetry by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell.Read more about. NET CLI Tools telemetry: https://aka. ms/dotnet-cli-telemetry

Aby wyłączyć ten komunikat i komunikat powitalny platformy. NET, ustaw zmienną DOTNET_NOLOGO środowiskową na true. Należy pamiętać, że ta zmienna nie ma wpływu na rezygnację z telemetrii.

Punkty danych

Funkcja telemetrii nie zbiera danych osobowych, takich jak nazwy użytkowników lub adresy e-mail. Nie skanuje kodu i nie wyodrębnia danych na poziomie projektu, takich jak nazwa, repozytorium lub autor. Dane są bezpiecznie wysyłane do serwerów Microsoft przy użyciu technologii Azure Monitor, przechowywanej w ograniczonym dostępie i publikowane w ramach rygorystycznych mechanizmów kontroli zabezpieczeń z bezpiecznych systemów usługi Azure Storage.

Ochrona prywatności jest dla nas ważna. Jeśli podejrzewasz, że dane telemetryczne zbierają poufne dane lub dane są niezabezpieczone lub niewłaściwie obsługiwane, zgłoś problem w repozytorium dotnet/sdk lub wyślij wiadomość e-mail na dotnet@microsoft. com adres w celu zbadania.

Funkcja telemetrii zbiera następujące dane:

Wersje zestawu SDK	Dane
Wszystko	Sygnatura czasowa wywołania.	Wywołano polecenie (na przykład "build"), skrót rozpoczynający się w wersji 2. 1.	Trzy oktetowe adresy IP używane do określania lokalizacji geograficznej.	System operacyjny i wersja.	Identyfikator środowiska uruchomieniowego (RID), na którym działa zestaw SDK.	Wersja zestawu. NET SDK.	Profil telemetrii: opcjonalna wartość używana tylko z jawnym wyrażeniem zgody użytkownika i używana wewnętrznie w Microsoft.	>=2. 0	Argumenty poleceń i opcje: zbiera się kilka argumentów i opcji (nie dowolnych ciągów). Zobacz zebrane opcje. Skrót po 2. 300.	Czy zestaw SDK jest uruchomiony w kontenerze.	Platformy docelowe (ze TargetFramework zdarzenia) są skrótami rozpoczynającymi się w wersji 2.	Skrót adresu Access Control multimediów (MAC) (SHA256).	Skrót bieżącego katalogu roboczego.	Raport o powodzeniu instalacji z skrótem pliku exe instalatora. 300	Wersja jądra.	Wersja/wersja biblioteki libc.	>=3. 0. 100	Czy dane wyjściowe zostały przekierowane (prawda czy fałsz).	W przypadku awarii interfejsu wiersza polecenia/zestawu SDK typ wyjątku i jego ślad stosu (wysyłany jest tylko kod interfejsu wiersza polecenia/zestawu SDK). Aby uzyskać więcej informacji, zobacz Telemetria wyjątku awaryjnego.	>=5. 100	Hashed TargetFrameworkVersion używana do kompilacji (właściwość MSBuild)	Hashed RuntimeIdentifier używany do kompilacji (właściwość MSBuild)	Funkcja Hashed SelfContained używana do kompilacji (właściwość MSBuild)	Skrót useApphost używany do kompilacji (właściwość MSBuild)	Hashed OutputType używany do kompilacji (właściwość MSBuild	>=5. 201	Funkcja Hashed PublishReadyToRun używana do kompilacji (właściwość MSBuild)	Skrót publishTrimmed używany do kompilacji (właściwość MSBuild)	Hashed PublishSingleFile używany do kompilacji (właściwość MSBuild)	>=5. 202	Upłynął czas od rozpoczęcia procesu do momentu wprowadzenia głównej metody programu interfejsu wiersza polecenia, pomiaru uruchamiania hosta i środowiska uruchomieniowego.	Upłynął czas dla kroku, który dodaje narzędzia. NET tools do ścieżki podczas pierwszego uruchomienia.	Czas, który upłynął, aby wyświetlić powiadomienie o pierwszym użyciu podczas pierwszego uruchomienia.	Upłynął czas generowania certyfikatu ASP. NET podczas pierwszego uruchomienia.	Upłynął czas analizowania danych wejściowych interfejsu wiersza polecenia.	>=6. 100	Architektura systemu operacyjnego	>=6. 104	Hashed PublishReadyToRunUseCrossgen2 używane do kompilacji (właściwość MSBuild)	Skrót Crossgen2PackVersion używany do kompilacji (właściwość MSBuild)	Hashed CompileListCount używany do kompilacji (właściwość MSBuild)	Skrót _ReadyToRunCompilationFailures używany do kompilacji (właściwość MSBuild)	>=6. 300	Jeśli interfejs wiersza polecenia został wywołany ze środowiska ciągłej integracji. Aby uzyskać więcej informacji, zobacz Ciągłe wykrywanie integracji.	>=7. 100	Funkcja Hashed PublishAot używana do kompilacji (właściwość MSBuild)	Hashed PublishProtocol używany do kompilacji (właściwość MSBuild)

Zebrane opcje

Niektóre polecenia wysyłają dodatkowe dane. Podzbiór poleceń wysyła pierwszy argument:

PolecenieWysłane dane pierwszego argumentudotnet help <arg>Pomoc polecenia jest odpytywana. dotnet new <arg>Nazwa szablonu (skrót). dotnet add <arg>Słowo package lub reference. dotnet remove <arg>dotnet list <arg>dotnet sln <arg>Słowo add, listlub remove. dotnet nuget <arg>Słowo delete, localslub push. dotnet workload <subcommand> <arg>Słowo install,, update, listsearchuninstall,, repairrestore i nazwa obciążenia (skrót). dotnet tool <subcommand> <arg>Słowo install,, update, listsearch, uninstallrun i nazwa narzędzia dotnet (skrót).

Podzbiór poleceń wysyła wybrane opcje, jeśli są używane wraz z ich wartościami:

OpcjaPolecenia--verbosityWszystkie polecenia--languagedotnet new--configurationdotnet build, dotnet clean, dotnet publish, dotnet run, dotnet test--frameworkdotnet build, dotnet clean, dotnet publish, dotnet run, dotnet test, dotnet vstest--runtimedotnet build, dotnet publish--platformdotnet vstest--logger--sdk-package-versiondotnet migrate

--verbosity Z wyjątkiem parametrów i --sdk-package-versionwszystkie pozostałe wartości są skrótami rozpoczynające się od zestawu SDK platformy. NET Core 2. 100.

Telemetria aparatu szablonu

Polecenie dotnet new tworzenia wystąpienia szablonu zbiera dodatkowe dane dla szablonów utworzonych Microsoft, począwszy od zestawu SDK platformy. 100:

• --framework
• --auth

Telemetria wyjątku awaryjnego

Jeśli interfejs wiersza polecenia/zestaw SDK platformy. NET ulegnie awarii, zbiera nazwę wyjątku i ślad stosu kodu interfejsu wiersza polecenia/zestawu SDK. Te informacje są zbierane w celu oceny problemów i poprawy jakości zestawu. NET SDK i interfejsu wiersza polecenia. Ten artykuł zawiera informacje o zbieranych danych. Zawiera również porady dotyczące sposobu, w jaki użytkownicy tworzący własną wersję zestawu. NET SDK mogą uniknąć nieumyślnego ujawnienia informacji osobistych lub poufnych.

Interfejs wiersza polecenia platformy. NET zbiera informacje tylko dla wyjątków interfejsu wiersza polecenia/zestawu SDK, a nie wyjątków w aplikacji. Zebrane dane zawierają nazwę wyjątku i ślad stosu. Ten ślad stosu jest kodem interfejsu wiersza polecenia/zestawu SDK.

W poniższym przykładzie przedstawiono rodzaj zebranych danych:

System. IO. IOExceptionat System. ConsolePal. WindowsConsoleStream. Write(Byte[] buffer, Int32 offset, Int32 count)at System. StreamWriter. Flush(Boolean flushStream, Boolean flushEncoder)at System. Write(Char[] buffer)at System. TextWriter. WriteLine()at System. SyncTextWriter. WriteLine()at Microsoft. DotNet. Cli. Utils. Reporter. Tools. Run. RunCommand. EnsureProjectIsBuilt()at Microsoft. Execute()at Microsoft. Run(String[] args)at Microsoft. Program. ProcessArgs(String[] args, ITelemetry telemetryClient)at Microsoft. Main(String[] args)
Wykrywanie ciągłej integracji
Aby wykryć, czy interfejs wiersza polecenia platformy. NET jest uruchomiony w środowisku ciągłej integracji, sondy interfejsu wiersza polecenia platformy. NET pod kątem obecności i wartości kilku dobrze znanych zmiennych środowiskowych ustawionych przez typowych dostawców ciągłej integracji. 
Poniżej przedstawiono pełną listę zmiennych środowiskowych i ich wartości. Należy pamiętać, że w każdym przypadku wartość zmiennej środowiskowej nigdy nie jest zbierana, używana tylko do ustawiania flagi logicznej. 
ZmienneDostawcaAkcjaTF_BUILDAzure PipelinesPrzeanalizuj wartość logicznąGITHUB_ACTIONSFunkcja GitHub ActionsAPPVEYORAppveyorCIWiele/większośćTRAVISCiągła integracja travisCIRCLECIOkrąg — ciągła integracjaCODEBUILD_BUILD_ID, AWS_REGIONAmazon Web Services CodeBuildSprawdź, czy wszystkie są obecne i nie ma wartości nullBUILD_ID, BUILD_URLJenkinsBUILD_ID, PROJECT_IDGoogle Cloud BuildTEAMCITY_VERSIONTeamCitySprawdzanie, czy obecne i inne niż nullJB_SPACE_API_URLPrzestrzeń JetBrains
Unikanie nieumyślnego ujawniania informacji
Współautorzy platformy. NET i każda inna osoba z wersją zestawu. NET SDK, którą skompilowali, powinni rozważyć ścieżkę do kodu źródłowego zestawu SDK. Jeśli wystąpi awaria podczas korzystania z zestawu. NET SDK, który jest niestandardową kompilacją debugowania lub skonfigurowany z niestandardowymi plikami symboli kompilacji, ścieżka pliku źródłowego zestawu SDK z maszyny kompilacji jest zbierana w ramach śledzenia stosu i nie jest skrótem. 
W związku z tym niestandardowe kompilacje zestawu. NET SDK nie powinny znajdować się w katalogach, których nazwy ścieżek ujawniają informacje osobiste lub poufne. 
Zobacz też
Źródło referencyjne telemetrii (repozytorium dotnet/sdk)