Top > Импорт данных > Импорт с помощью PowerShell > Параметры, используемые командлетом

Параметры, используемые командлетом

Следующая таблица содержит список параметров, используемых командлетом. К ним относятся параметры, связанные с импортом данных, а также некоторые общие реализованные параметры PowerShell. Параметры также можно поместить в отдельном источнике, например CSV-файле, который можно указать в командлете. Некоторые примеры использования этих параметров приведены в разделе Примеры выполнения командлета.

 

Параметр

Тип

Описание

Name

Относится к импорту

(Обязательный параметр) Имя существующего шаблона (в Data Management), который будет использоваться во время импорта. Безымянный параметр, позиция 1.

ПРИМЕЧАНИЕ. Этот параметр не принимает значения, переданные из файла.

OnErrorAction

Относится к импорту

Действие, выполняемое при возникновении ошибки во время обработки данных. Доступные значения: Abort и Skip. При использовании недопустимого значения скрипт применяет значение по умолчанию Abort. (Оно не переопределяет параметр PowerShell по умолчанию — ErrorAction и никак не связано с ним). Безымянный параметр, позиция 2.

ПРИМЕЧАНИЕ. Этот параметр не принимает значения, переданные из файла.

LiteralPath

Импорт CSV-файла

(Обязательный параметр) Полный путь из корневого каталога к исходному CSV-файлу, включая имя файла.

SqlServer

Импорт данных SQL Server

(Обязательный параметр) Сервер, на котором установлена исходная база данных SQL. Сервер должен быть доступен с текущими учетными данными пользователя на компьютере, на котором выполняется скрипт.

SqlDatabase

Импорт данных SQL Server

(Обязательный параметр) Имя исходной базы данных SQL. База данных должна быть доступна с текущими учетными данными пользователя на компьютере, на котором выполняется скрипт.

Sqlquery

Импорт данных SQL Server

(Обязательный параметр) Запрос, извлекающий исходные данные из базы данных. Если запрос содержит Escape-символы, заключите их в одиночные кавычки. Одиночные кавычки указывают, что средство Windows PowerShell не должно интерпретировать символы как Escape-последовательность.

Verbose

PowerShell

Включает отображение сообщений WriteVerbose, включенных в командлет. Ход выполнения командлета отображается следующим образом: время запуска, конечное время, прочитано записей, создано записей и обновлено записей.

Debug

PowerShell

Включает отображение сообщений WriteDebug, включенных в командлет. Предоставляет дополнительные сведения о значениях, возвращенных после вызова.

ErrorAction

PowerShell

Управляет тем, как PowerShell обрабатывает сообщения WriteError от командлета. Доступны следующие значения.

 Continue — PowerShell уведомляет об ошибке и продолжает выполнение командлета.

 Inquire — PowerShell приостанавливает командлет и спрашивает пользователя о дальнейших действиях.

SilentlyContinue — PowerShell продолжает выполнение командлета, не уведомляя пользователя об ошибке.

 Stop — PowerShell обрабатывает ошибку как
TerminatingError и останавливает обработку командлета.

ПРИМЕЧАНИЕ. Этот параметр не принимает значения, переданные из файла.

ErrorVariable

PowerShell

Предоставляет определяемую пользователем переменную для хранения сообщений WriteError вместо переменной $error по умолчанию. Если имя переменной дополнено префиксом +, сообщения накапливаются, в противном случае она содержит только последнее сообщение об ошибке. Синтаксис: -ErrorVariable myErr или -ErrorVariable +myErr, где myErr — пользовательская переменная.