Что такое windows powershell и с чем его едят? часть 5: доступ к внешним объектам / хабр

Примеры

Пример 1. Добавление команд в журнал другого сеанса

В этом примере команды, введенные в одном сеансе PowerShell, добавляются в журнал другого сеанса PowerShell.

Первая команда получает объекты, представляющие команды в журнале, и экспортирует их в файл.

Вторая команда должна вводится в командной строке другого сеанса. Для импорта объектов в файл используется командлет . Оператор конвейера () передает объекты командлету , который добавляет объекты, представляющие команды в файле, в журнал текущего сеанса.

Пример 2. Импорт и выполнение команд

В этом примере команды импортируются из файла, добавляются в журнал текущего сеанса, а затем выполняются команды в объединенном журнале.

Первая команда использует командлет для импорта журнала команд, экспортированного в файл. Оператор конвейера передает команды командлету , который добавляет команды в текущий журнал сеанса. Параметр PassThru передает объекты, представляющие добавленные команды по конвейеру.

Затем команда использует командлет для применения команды к каждой из команд в объединенном журнале. Команда отформатирована как блок скрипта, заключенный в фигурные скобки (), в соответствии с параметром Process командлета .

Пример 3. Добавление команд в журнал до конца журнала

В этом примере первые пять команд в журнале добавляются в конец списка журнала.

Командлет получает пять команд, заканчивающиеся на команду 5. Оператор конвейера передает их командлету , который добавляет их в текущий журнал. Команда не содержит параметров, но PowerShell связывает объекты, передаваемые через конвейер, с параметром InputObject для .

Пример 4. Добавление команд в файл .csv в текущий журнал

В этом примере команды в файле добавляются в журнал текущего сеанса.

Командлет импортирует команды в файл и сохраняет их содержимое в переменной .

Вторая команда использует командлет для добавления команд из в журнал текущего сеанса. Он использует параметр InputObject для указания переменной и параметр PassThru для создания объекта для отображения в командной строке. Без параметра PassThru командлет не создает никаких выходных данных.

Пример 5. Добавление команд в файл .xml в текущий журнал

В этом примере команды в файле добавляются в журнал текущего сеанса.

Параметр InputObject передает командлету результаты команды в скобках . Команда в скобках, которая выполняется сначала, импортирует файл в PowerShell. Затем командлет добавляет команды из файла в журнал сеанса.

Параметры

-InputObject

Задает массив записей, добавляемых в журнал в качестве объекта HistoryInfo в журнал сеанса.
Этот параметр можно использовать для отправки объекта HistoryInfo , например тех, которые возвращаются командлетами , или , в .

Type:	PSObject
Position:
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Passthru

Указывает, что этот командлет возвращает объект HistoryInfo для каждой записи журнала. По умолчанию этот командлет не создает выходные данные.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Описание

Командлет добавляет записи в конец журнала сеанса, то есть список команд, введенных во время текущего сеанса.

Журнал сеанса — это список команд, введенных за время сеанса. В журнале сеанса представлен порядок выполнения, состояние, время начала и завершения выполнения команды. По мере ввода каждой команды PowerShell добавляет ее в журнал, чтобы ее можно было использовать повторно. Дополнительные сведения об журнале сеансов см. в разделе about_History.

Журнал сеансов управляется отдельно от журнала, поддерживаемого модулем PSReadLine .
Обе истории доступны в сеансах, в которых загружается PSReadLine . Этот командлет работает только с журналом сеансов. Дополнительные сведения см. в разделе about_PSReadLine.

Можно использовать командлет , чтобы получить команды и передать их в , или экспортировать команды в CSV-файл или XML, а затем импортировать команды и передать импортированный файл в . Этот командлет позволяет добавить определенные команды в журнал или создать единый файл журнала, в котором содержатся команды, введенные в течение нескольких сеансов.

Примечания

Журнал сеанса — это список команд, введенных во время сеанса, вместе с идентификатором. В журнале сеанса представлен порядок выполнения, состояние, время начала и завершения выполнения команды. По мере ввода каждой команды PowerShell добавляет ее в журнал, чтобы ее можно было использовать повторно. Дополнительные сведения об журнале сеансов см. в разделе about_History.

Чтобы указать команды, которые нужно добавить в журнал, используйте параметр InputObject. Команда принимает только объекты HistoryInfo , например возвращаемые командлетом для каждой команды. Передать путь и имя файла или список команд по конвейеру нельзя.

Параметр InputObject можно использовать для передачи файла объектов HistoryInfo в . Для этого экспортируйте результаты команды в файл с помощью командлета или , а затем импортируйте файл с помощью командлетов или . Затем вы можете передать файл импортированных объектов HistoryInfo через конвейер или в переменной. Дополнительные сведения см. в примерах.

Файл объектов HistoryInfo , который передается командлету , должен содержать сведения о типе, заголовки столбцов и все свойства объектов HistoryInfo . Если вы планируете передать объекты обратно в , не используйте параметр NoTypeInformation командлета и не удаляйте сведения о типе, заголовки столбцов или любые поля в файле.

Чтобы изменить журнал сеансов, экспортируйте сеанс в CSV- или XML-файл, измените файл, импортируйте файл и используйте для добавления его в текущий журнал сеансов.

Замечания по формату файлов данных для массового экспорта

Прежде чем выполнить операцию массового экспорта с помощью команды bcp , примите во внимание следующее

При экспорте данных в файл команда bcp автоматически создает файл данных, используя указанное имя файла. Если это имя файла уже используется, то в процессе массового копирования в файл данных существующее содержимое файла перезаписывается.
Для массового экспорта из таблицы или представления в файл данных необходимо разрешение SELECT в таблице или представлении, над которым производится операция массового копирования.
Корпорация Майкрософт SQL Server может использовать параллельные проверки для получения данных. Таким образом, строки таблицы, которые массово экспортируются из экземпляра SQL Server, обычно не гарантированно находятся в определенном порядке в файле данных. Чтобы строки таблицы для массового экспорта размещались в файле данных в определенном порядке, примените параметр queryout для массового экспорта из запроса и укажите предложение ORDER BY.

Import Data From Text File Into PowerShell

To import data from a text file into PowerShell we use Get-Content CmdLet. In the example above we read the text file and save the result in variable $computers that will be used later.

The syntax is very simple we call Get-Content and provide value to the Path parameter where our text file has been located.

Here is the result of running only Get-Content CmdLet, the CmdLet simple reads the content of the text file.

Get-Content CmdLet result of reading the text file

Let’s quickly look at what the data type of the result is and what the properties and methods that we can use to manipulate the data are.

As you can see from the screenshot below (open in new Tab if the screen is too small for you), as a result of running Get-Content CmdLet, we got strings as expected and we have all the properties and methods that come with String data type.

Get-Content result data type with properties and methods

Параметры

-First

Получает только указанное количество объектов. Введите количество объектов, которые необходимо получить.

Type:	UInt64
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeTotalCount

Сообщает общее количество объектов в наборе данных, за которыми следуют выбранные объекты. Если командлету не удается определить общее число, отображается неизвестное общее число. Целое число имеет свойство Точность , которое указывает на надежность значения общего счетчика. Значение Точности находится в диапазоне от до , где означает, что командлет не может подсчитать объекты, означает, что счетчик является точным, а значение между и указывает на более надежную оценку.

Type:	SwitchParameter
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LiteralPath

Указывает путь к XML-файлам. В отличие от Path, значение параметра LiteralPath используется точно так же, как он типизированный. Никакие символы не интерпретируются как знаки подстановки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки предписывают PowerShell не интерпретировать какие-либо символы как escape-последовательности.

Type:	String
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

Указывает путь к XML-файлам.

Type:	String
Position:
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Skip

Игнорирует указанное количество объектов, а затем получает оставшиеся объекты. Введите количество объектов, которые необходимо пропустить.

Type:	UInt64
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Параметры

-Delimiter

Задает разделитель для значений свойств в файле CSV. Значение по умолчанию — запятая ().

Введите символ, например двоеточие (). Чтобы указать точку с запятой (), заключите ее в одинарные кавычки. Чтобы указать экранированные специальные символы, такие как tab (), заключите их в двойные кавычки.

Если в файле указан символ, отличный от фактического разделителя строки, невозможно создать объекты из строк CSV и будут возвращены строки CSV.

Type:	Char
Position:	1
Default value:	comma (,)
Accept pipeline input:	False
Accept wildcard characters:	False

-Encoding

Задает кодировку импортированного CSV-файла. Значение по умолчанию — .

Ниже приведены допустимые значения для этого параметра.

: использует кодировку для 7-разрядной кодировки ASCII.
: кодирует в формате UTF-16 с использованием порядка байтов с большим байтом.
: кодирует в формате UTF-32 с использованием порядка байтов с большим байтом.
: использует кодировку по умолчанию для MS-DOS и консольных программ.
: кодирует в формате UTF-16 с использованием порядка байтов с маленьким порядком байтов.
: кодирует в формате UTF-7.
: кодирует в формате UTF-8.
: кодирует в формате UTF-8 с меткой порядка байтов (BOM)
: кодирует в формате UTF-8 без метки порядка байтов (BOM)
: кодирует в формате UTF-32.

Начиная с PowerShell 6.2, параметр Encoding также разрешает числовые идентификаторы зарегистрированных кодовых страниц (например , ) или строковые имена зарегистрированных кодовых страниц (например , ). Дополнительные сведения см. в документации по .NET для Encoding.CodePage.

Примечание

UTF-7* больше не рекомендуется использовать. В PowerShell 7.1 выдается предупреждение, если вы указываете для параметра Encoding .

Type:	Encoding
Accepted values:	ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32
Position:	Named
Default value:	UTF8NoBOM
Accept pipeline input:	False
Accept wildcard characters:	False

-Header

Указывает альтернативную строку заголовков столбцов для импортируемого файла. Заголовок столбца определяет имена свойств объектов, созданных .

Введите заголовки столбцов в виде разделенного символами списка. Не заключайте в кавычки строку заголовка. Заключите заголовок каждого столбца в одинарные кавычки.

Если ввести меньше заголовков столбцов, чем столбцов данных, остальные столбцы данных будут удалены. Если ввести больше заголовков столбцов, чем столбцов данных, дополнительные заголовки столбцов создаются с пустыми столбцами данных.

При использовании параметра Header удалите исходную строку заголовков из файла CSV. В противном случае создает дополнительный объект из элементов в строке заголовка.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LiteralPath

Указывает путь к импортируемому файлу CSV. В отличие от параметра Path, значение параметра LiteralPath используется в точности так, как вводится. Никакие символы не интерпретируются как знаки подстановки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки предписывают PowerShell не интерпретировать какие-либо символы как escape-последовательности.

Type:	String
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

Указывает путь к импортируемому файлу CSV.
Вы также можете передать путь в .

Type:	String
Position:
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-UseCulture

Использует разделитель списка для текущего языка и региональных параметров в качестве разделителя элементов. Чтобы найти разделитель списка для языка и региональных параметров, используйте следующую команду: .

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Using PowerShell Export-CSV NoClobber

PowerShell Export-CSV file writes output to CSV file and overwrites any existing file if exists on disk.

Using the Export-CSV NoClobber parameter throws an error if trying to overwrite and prevents overwriting the existing CSV file.

Let’s consider the above example to illustrate PowerShell export CSV noclobber functionality.

PS C:\> Get-WmiObject -Class Win32_Bios | Select-Object -Property BIOSVersion,Manufacturer,Version,ReleaseDate | Export-CSV -Path D:\PowerShell\ComputerDetails.csv -NoClobber

In the above PowerShell output to file script, we have used the Export-CSV NoClobber parameter.

If the file already exists on the specified path, it will throw an error and prevent overwriting the output to a CSV file.

The output of the above example to write output to CSV file is:

PowerShell Export-CSV NoClobber Parameter

Using PowerShell Export-CSV Delimiter Parameter

When you export a CSV file, by default values in the CSV file are comma-separated.

You can change the delimiter in a CSV file using the Export-CSV Delimiter parameter.

Using the Delimiter parameter, allows you to specify the delimiter.

For example, referring to the above example to get free disk space using PowerShell, use delimiter as ‘;’ (semicolon) instead of the default ‘,’ (comma).

Get-WmiObject -Class Win32_Bios | Select-Object -Property BIOSVersion,Manufacturer,Version,ReleaseDate | Export-CSV -Path D:\PowerShell\ComputerDetails.csv -NoTypeInformation -Delimiter ';'

In the above PowerShell Export CSV Delimiter example,

It writes output to CSV file separated by delimiter ‘;’ (semicolon)

The output of the above example is:

PowerShell Export CSV Delimiter

Описание

Командлет создает табличные пользовательские объекты из элементов в CSV-файлах. Каждый столбец в CSV-файле становится свойством пользовательского объекта, а элементы в строках — значениями свойств. работает с любым CSV-файлом, включая файлы, созданные командлетом .

С помощью параметров командлета можно указать строку заголовка столбца и разделитель элемента или использовать разделитель списка для текущего языка и региональных параметров в качестве разделителя элементов.

Можно также использовать командлеты и для преобразования объектов в строки CSV (и обратно). Эти командлеты совпадают с командлетами и , за исключением того, что они не работают с файлами.

Если запись строки заголовка в CSV-файле содержит пустое значение или значение NULL, PowerShell вставляет имя строки заголовка по умолчанию и выводит предупреждающее сообщение.

Начиная с PowerShell 6.0 теперь поддерживает расширенный формат файла журнала W3C.

Требования к формату файлов данных для массового импорта

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

Данные должны быть представлены в формате строк и столбцов.

Примечание

Структура файла данных не должна совпадать со структурой таблицы SQL Server, так как столбцы могут быть пропущены или переупорядочены во время процесса массового импорта.

Данные в файле данных должны быть в поддерживаемом формате, например символьном или исходном.

Данные могут быть в символьном или исходном двоичном формате, включая Юникод.

Для импорта данных с использованием команды bcp, инструкции BULK INSERT или инструкции INSERT… SELECT * FROM OPENROWSET(BULK…), целевая таблица должна уже существовать.

Каждое поле в файле данных должно быть совместимо с соответствующим столбцом в целевой таблице. Например, поле типа int нельзя загрузить в столбец типа datetime . Дополнительные сведения см. в статьях «Форматы данных» для массового импорта или массового экспорта (SQL Server) и указания форматов данных для совместимости при использовании bcp (SQL Server).

Примечание
Указать для импорта из файла данных не весь файл, а подмножество строк можно с помощью команды bcp с параметром -Fпервая_строка и параметром -Lпоследняя_строка. Дополнительные сведения см. в разделе bcp Utility.

Чтобы импортировать данные из файлов данных фиксированной длины или с полями фиксированной ширины, используйте файл форматирования. Дополнительные сведения см. в разделе XML-файлы форматирования (SQL Server).

Начиная с SQL Server 2017 года CSV-файл можно использовать в качестве файла данных для массового импорта данных в SQL Server

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

Поля данных не должны содержать признак конца поля.

Или никакие, или все значения в полях данных должны заключаться в кавычки («»).

Для массового импорта данных из файла таблицы Microsoft FoxPro или Visual FoxPro (DBF) или файла листа Microsoft Excel (.xls) необходимо преобразовать данные в CSV-файл, соответствующий предыдущим ограничениям

Этот файл обычно имеет расширение CSV. Затем вы можете использовать файл .csv в качестве файла данных в SQL Server операции массового импорта.
В 32-разрядных системах (SQL Server 2014 и ниже) можно импортировать данные CSV в таблицу SQL Server без оптимизации массового импорта с помощью OPENROWSET с поставщиком OLE DB для Jet. Поставщик Jet обрабатывает текстовые файлы как таблицы со схемой, определенной в файле schema.ini, который расположен в том же каталоге, что и источник данных. Для данных CSV одним из параметров в файле schema.ini будет FORMAT=CSVDelimited. Чтобы использовать это решение, необходимо понять, как работает Jet Text IISAM (синтаксис строки подключения, schema.ini использование, параметры параметров реестра и т. д.). Лучшими источниками этих сведений являются статьи справки Microsoft Access и базы знаний (KB). Дополнительные сведения см. в разделах Инициализация драйвера текстового источника данных, Как использовать распределенный запрос SQL Server 7.0 со связанным сервером для защищенных баз данных Access, Как использовать поставщик Jet OLE DB 4.0 для подключения к базам данных ISAM (на английском языке) и Как открыть текстовые файлы с разделителями с помощью драйвера Text IIsam поставщика Jet (на английском языке).

Кроме того, для массового импорта данных из файла данных в таблицу необходимо следующее.

Пользователи должны иметь разрешения INSERT и SELECT в таблице. Пользователи также должны иметь разрешение ALTER TABLE в случае использования параметров, требующих операций DDL, например отмены ограничений.
При массовом импорте данных с помощью ИНСТРУКЦИИ BULK INSERT или INSERT … SELECT * FROM OPENROWSET(BULK…), файл данных должен быть доступен для операций чтения с помощью профиля безопасности процесса SQL Server (если пользователь входит в систему с помощью SQL Server предоставленного имени входа) или имени входа Microsoft Windows, используемого при делегированной безопасности. В дополнение пользователь должен иметь разрешение ADMINISTER BULK OPERATIONS для чтения файла.

Примечание

Массовый импорт в секционированное представление не поддерживается, и попытки массового импорта данных в секционированное представление завершаются неудачно.

Export/Write Data From PowerShell Into Text File

In order to export/write data from PowerShell into the text file, we use Out-File CmdLet usually with the Append parameter together.

INFO: I have written an article that has a great implementation of Out-File CmdLet so please read the section (PROCESS block code) and if you want to learn more about PowerShell Error Handling and writing errors in an external log file please read the whole article How To Log PowerShell Errors And Much More

How To Log PowerShell Errors And Much More

Here is the screenshot from that article and Log file created using Out-File CmdLet.

Example of error logged in an external text file

Примеры

Пример 1. Экспорт строки в XML-файл

В этом примере создается XML-файл, который хранится в текущем каталоге с представлением строки This is a test.

Строка отправляется вниз по конвейеру. использует параметр Path для создания XML-файла с именем в текущем каталоге.

Пример 2. Экспорт объекта в XML-файл

В этом примере показано, как экспортировать объект в XML-файл и затем создать объект путем импорта из XML-файла.

Командлет получает дескриптор безопасности файла. Он отправляет объект по конвейеру для передачи дескриптора безопасности в . Xml-представление объекта хранится в файле с именем .

Командлет создает объект на основе XML в файле . Затем объект сохраняется в переменной .

Пример 3. Шифрование экспортированного объекта учетных данных в Windows

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

Важно!

Экспортирует только зашифрованные учетные данные в Windows. В операционных системах, отличных от Windows, таких как macOS и Linux, учетные данные экспортируются в виде обычного текста, хранящегося в виде массива символов Юникода. Это обеспечивает некоторую запутывание, но не обеспечивает шифрование.

Командлет шифрует объекты учетных данных с помощью API защиты данных Windows. Шифрование гарантирует, что только ваша учетная запись пользователя на этом компьютере может расшифровать содержимое объекта учетных данных.
Экспортируемый файл не может использоваться на другом компьютере или другим пользователем.

В этом примере файл, в котором хранятся учетные данные, представлен с помощью . Замените TestScript именем скрипта, с помощью которого загружаются учетные данные.

Объект учетных данных отправляется по конвейеру в и сохраняется по пути , указанному в первой команде.

Чтобы автоматически импортировать учетные данные в скрипт, выполните последние две команды. Выполните команду , чтобы импортировать защищенный объект учетных данных в скрипт. Такой импорт исключает риск предоставления паролей в виде обычного текста в скрипте.

Пример 4. Экспорт объекта учетных данных в Linux или macOS

В этом примере мы создадим PSCredential в переменной с помощью командлета . Затем мы используем для сохранения учетных данных на диск.

Важно!

Выходные данные в этом примере были усечены, чтобы сосредоточиться на учетных данных в XML-файле

Обратите внимание, что текстовое значение пароля хранится в XML-файле в виде массива символов Юникода, как доказано с помощью. Таким образом, значение закодировано, но не зашифровано