Narzędzia konsoli Menedżera pakietów Core EFEF Core Package Manager Console Tools

Uruchom narzędzia konsoli Menedżera pakietów EF Core (PMC) w programie Visual Studio przy użyciu narzędzia NuGet Konsola Menedżera pakietów.The EF Core Package Manager Console (PMC) Tools run inside of Visual Studio using NuGet's Package Manager Console. Te narzędzia Praca z projektami zarówno .NET Framework i .NET Core.These tools work with both .NET Framework and .NET Core projects.

Porada

Nie używasz programu Visual Studio?Not using Visual Studio? EF podstawowe narzędzia wiersza polecenia są międzyplatformowa i uruchamiane w wierszu polecenia.The EF Core Command-line Tools are cross-platform and run inside a command prompt.

Instalowanie narzędziInstalling the tools

Zainstaluj narzędzia konsoli Menedżera pakietów Core EF, instalując pakiet Microsoft.EntityFrameworkCore.Tools NuGet.Install the EF Core Package Manager Console Tools by installing the Microsoft.EntityFrameworkCore.Tools NuGet package. Można ją zainstalować, wykonując następujące polecenie w Konsola Menedżera pakietów.You can install it by executing the following command inside Package Manager Console.

Install-Package Microsoft.EntityFrameworkCore.Tools

Jeśli wszystko działało poprawnie, należy uruchomić to polecenie:If everything worked correctly, you should be able to run this command:

Get-Help about_EntityFrameworkCore

Porada

Jeśli Twój projekt startowy jest przeznaczony dla platformy .NET Standard między celem obsługiwanych struktur przed użyciem narzędzia.If your startup project targets .NET Standard, cross-target a supported framework before using the tools.

Ważne

Jeśli używasz uniwersalnych systemu Windows lub Xamarin, Przenieś swój kod EF do .NET Standard biblioteki klas i między celem obsługiwanych struktur przed użyciem narzędzia.If you're using Universal Windows or Xamarin, move your EF code to a .NET Standard class library and cross-target a supported framework before using the tools. Określ biblioteki klas jako projekt startowy.Specify the class library as your startup project.

Korzystając z narzędziUsing the tools

Przy każdym wywołaniu polecenia obejmuje dwa projekty:Whenever you invoke a command, there are two projects involved:

Projekt docelowy jest w przypadku, gdy zostaną dodane wszystkie pliki (lub w niektórych przypadkach usunięte).The target project is where any files are added (or in some cases removed). Domyślnie projektu docelowego domyślny projekt wybrany w konsoli Menedżera pakietów, ale można również określić za pomocą parametru - projektu.The target project defaults to the Default project selected in Package Manager Console, but can also be specified using the -Project parameter.

Projekt startowy jest emulowane przez narzędzia podczas wykonywania kodu projektu.The startup project is the one emulated by the tools when executing your project's code. Domyślnie jedną Ustaw jako projekt startowy w Eksploratorze rozwiązań.It defaults to one Set as StartUp Project in Solution Explorer. Można również określić, za pomocą parametru - StartupProject.It can also be specified using the -StartupProject parameter.

Wspólne parametry:Common parameters:

-Kontekst <ciąg >-Context <String> DbContext do użycia.The DbContext to use.
-Projektu <ciąg >-Project <String> Projekt do użycia.The project to use.
-StartupProject <ciąg >-StartupProject <String> Projekt startowy do użycia.The startup project to use.
-Verbose-Verbose Pokaż pełne dane wyjściowe.Show verbose output.

Aby wyświetlić Pomoc informacje dotyczące polecenia, za pomocą programu PowerShell w Get-Help polecenia.To show help information about a command, use PowerShell's Get-Help command.

Porada

Parametry kontekstu, projektu i StartupProject obsługuje kartę rozszerzenia.The Context, Project, and StartupProject parameters support tab-expansion.

Porada

Ustaw env:ASPNETCORE_ENVIRONMENT przed uruchomieniem do określenia środowiska ASP.NET Core.Set env:ASPNETCORE_ENVIRONMENT before running to specify the ASP.NET Core environment.

PoleceniaCommands

Dodaj migracjiAdd-Migration

Dodaje nowe migracji.Adds a new migration.

Parametry:Parameters:

-Nazwa <ciąg >-Name <String> Nazwa migracji.The name of the migration.
-OutputDir <ciąg >-OutputDir <String> Katalog (i przestrzeni nazw sub) do użycia.The directory (and sub-namespace) to use. Ścieżki są względem katalogu projektu.Paths are relative to the project directory. Wartość domyślna to "Migracji".Defaults to "Migrations".

Uwaga

Parametry w bold są wymagane i w italics są pozycyjnych.Parameters in bold are required, and ones in italics are positional.

Baza danych listyDrop-Database

Odrzuca bazy danych.Drops the database.

Parametry:Parameters:

-WhatIf-WhatIf Pokaż bazę danych, która będą pomijane, ale nie jej porzucić.Show which database would be dropped, but don't drop it.

Get-DbContextGet-DbContext

Pobiera informacje o typie DbContext.Gets information about a DbContext type.

Usuń migracjiRemove-Migration

Usuwa ostatniej migracji.Removes the last migration.

Parametry:Parameters:

-Force.-Force Nie Sprawdź, czy migracja zostały zastosowane do bazy danych.Don't check to see if the migration has been applied to the database.

Szkieletu DbContextScaffold-DbContext

Rusztowania DbContext i jednostki typy dla bazy danych.Scaffolds a DbContext and entity types for a database.

Parametry:Parameters:

-Połączenia <ciąg >-Connection <String> Parametry połączenia z bazą danych.The connection string to the database.
-Dostawca <ciąg >-Provider <String> Dostawca do użycia.The provider to use. (Np.(E.g. Microsoft.EntityFrameworkCore.SqlServer)Microsoft.EntityFrameworkCore.SqlServer)
-OutputDir <ciąg >-OutputDir <String> Umieścić pliki katalogu.The directory to put files in. Ścieżki są względem katalogu projektu.Paths are relative to the project directory.
-Kontekst <ciąg >-Context <String> Nazwa typu DbContext w celu wygenerowania.The name of the DbContext to generate.
-Schematy <String [] >-Schemas <String[]> Schematy tabele, aby wygenerować typy jednostek.The schemas of tables to generate entity types for.
-Tabele <String [] >-Tables <String[]> Tabele, aby wygenerować typy jednostek.The tables to generate entity types for.
-DataAnnotations-DataAnnotations Użyj atrybutów, aby skonfigurować model (jeśli będzie to możliwe).Use attributes to configure the model (where possible). Przypadku jego pominięcia jest używana tylko interfejsu API fluent.If omitted, only the fluent API is used.
-UseDatabaseNames-UseDatabaseNames Użyj nazwy tabel i kolumn bezpośrednio z bazy danych.Use table and column names directly from the database.
-Force.-Force Zastąpienie istniejących plików.Overwrite existing files.

Skrypt migracjiScript-Migration

Generuje skrypt SQL z migracji.Generates a SQL script from migrations.

Parametry:Parameters:

-From <ciąg >-From <String> Początkowy migracji.The starting migration. Wartość domyślna to 0 (początkowej bazy danych).Defaults to 0 (the initial database).
— Do <ciąg >-To <String> Końcowy migracji.The ending migration. Domyślnie ostatni migracji.Defaults to the last migration.
-Idempotentności-Idempotent Generuj skrypt, który może być używany z bazy danych w każdej migracji.Generate a script that can be used on a database at any migration.
-Output <ciąg >-Output <String> Plik można zapisać wynik.The file to write the result to.

Porada

Do z, i parametry wyjściowe obsługuje kartę rozszerzenia.The To, From, and Output parameters support tab-expansion.

Update-DatabaseUpdate-Database

-Migration <ciąg >-Migration <String> Migracja docelowych.The target migration. W przypadku wartości "0" wszystkich migracji zostaną cofnięte.If '0', all migrations will be reverted. Domyślnie ostatni migracji.Defaults to the last migration.

Porada

Parametr migracji obsługuje kartę rozszerzenia.The Migration parameter supports tab-expansion.