Глава 2. Считывание и запись вывода

Откройте PowderShell

Выполните Get-UICulture, а затем Get-Process. Обратите внимание что получаемый по умолчанию для этих двух cmdlet выглядит похожим на табличный, что демонстрируется ниже:

 

Рисунок 2-1

Выполните Get-TimeZone, а следом Get-Uptime. На этот раз назначенное по умолчанию форматирование вывода выглядит перечнем, как показано далее:

 

Рисунок 2-2

Теперь исполните Get-ChildItem -Path *DoesNotExist*. Для этого cmdlet вы можете и вовсе не получать вывод.

Наконец, запустите New-Item -Name file -Value 'Test file'. Хотя этот cmdlet и не применяет соответствующий глагол Get, он всё ещё возвращает некий вывод для своей обработки.

Наберите Get-Help about_Variables.

для создания новых переменных выполните три следующих строки:

$timestamp = Get-Date
$processes = Get-Process
$nothing = $null
 	   

Запуск вашей переменной просто повторяет вывод:

$timestamp
 	   

Введите $timestamp., а затем нажмите клавишу Tab в CLI, либо Ctrl + Space в CLI и VS Code. Ознакомьтесь с различными свойствами и методами, которые тут могут применяться.

Попробуйте вомпользоваться $timestamp.DayOfWeek и $timestamp.IsDaylightSavingTime().

Также прекрасно работает доступ к свойствам и методам в списках. Попробуйте выполнить следующее:

$processes.Name
$processes.Refresh()
 	   

Будьте внимательными при использовании не инициализированных переменных, так как результат потенциально может быть разрушительным:

# Значением свойства также может быть и $null
$nothing.SomeProperty

# Вызовы метода способны вызывать ошибку
$nothing.SomeMethod()

# Особенной аккуратности требуют cmdlets подобные Get-ChildItem!
# Значением пути по умолчанию выступает текущий рабочий каталог
Get-ChildItem -Path $nothing -File | Remove-Item -WhatIf
 	   

Наконец, вам не требуется вовсе создавать некую переменную если вам всего лишь один раз требуется получить доступ к некому свойству или методу:

# Accessing properties and methods while discarding the
# original object requires expressions, $( )
$(Get-TimeZone).BaseUtcOffset
$(Get-Process).ToString()
 	   

Попробуйте выполнить такой блок кода:

$true = $false
$pid = 0
$Error = "Я никогда не ошибаюсь!"
 	   

Чтобы понять почему Шаг 1 не сработал как ожидалось выполните следующий cmdlet:

Get-Variable | Where-Object -Property Options -like *Constant*
 	   

При помощи cmdlet variable вы имеете возможность создавать собственные доступные только для чтения и не изменяемые переменные:

# Создание доступных только для чтения и не изменяемых переменных требует cmdlet переменных
$logPath = 'D:\Logs'
Set-Variable -Name logPath -Option ReadOnly
 	   

Изменение доступных только для чтения переменных всё ещё возможно при помощи параметра -Force:

Set-Variable -Name logPath -Value '/var/log' -Force
 	   

Значение Option параметра также полезно и для иных целей, например, для создания частных и глобальных переменных:

Get-Help -Name New-Variable -Parameter Option
 	   

Выполните слудующий блок кода:

$outerScope = 'Variable outside function'

function Foo
{
    Write-Host $outerScope
    $outerScope = 'Variable inside function'
    Write-Host $outerScope
}

Foo
Write-Host $outerScope
 	   

Вы должны получить такой вывод:

 

Рисунок 2-3

Слегка измените свой код, применяя модификаторы области действия private, script и local, а потом попробуйте снова:

<#
  Определяя область действия в явном виде, вы можете изменять значение состояние практически любой переменной
  Доступны следующие области действия. Ко внутренним областям действия могут выполнять доступ переменные из внешних областей
  global: Самая внешняя область действия, т.е. ваш текущий сеанс
  script: Значение области действия сценария или модуля
  local: Значение области действия внутри некого блока сценария
  private: В любой области действия, скрывая от дочерних областей действия
  using: Это особый случай.
#>
$outerScope = 'Переменная вне function'
$private:invisible = 'Не видимая из дочерних областей'

function Foo
{
    Write-Host $outerScope
    $script:outerScope = 'Переменная внутри function'
    $local:outerScope = 'Могут существовать обе'
    Write-Host "Доступ к содержимому переменной private не может быть осуществлён: $invisible"
    Write-Host $outerScope
}

Foo
Write-Host $outerScope
 	   

На этот раз вы можете заметить, что вы можете создавать множество переменных с одним и тем же самым названием в различных областях действия.

Для того чтобы увидеть как работает применение области действия попробуйте далее такой код:

$processName = 'pwsh'
$credential = New-Object -TypeName pscredential -ArgumentList 'user',$('password' | ConvertTo-SecureString -AsPlainText -Force)
Start-Job -ScriptBlock { Get-Process -Name $processName} | Wait-Job | Receive-Job # Ошибка
Start-Job -ScriptBlock { Get-Process -Name $using:processName} | Wait-Job | Receive-Job # Работает
Start-Job -ScriptBlock { $($using:credential).GetNetworkCredential().Password } | Wait-Job | Receive-Job # Также работает
 	   

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

Испробуйте следующие cmdlet и просмотрите полученный результат:

# Данная команда вернёт как ошибку, так и один объект вывода
Get-Item -Path $home,'doesnotexist'

# Обычно данная команда ничего не возвращает. Параметр Verbose однако включает другой поток.
Remove-Item -Path $(New-TemporaryFile) -Verbose
 	   

Параметр Verbose на самом деле был частью общих параметров. Выполните следующие строки и посмотрите что произойдёт теперь:

Get-Item -Path $home,'doesnotexist' -ErrorAction SilentlyContinue -OutVariable file -ErrorVariable itemError
$file.FullName # Да, это ваш файл
$itemError.Exception.GetType().FullName # Это точно выглядит как ваша ошибка
 	   

Наравне с потоками Verbose и Debug, по умолчанию поток Information невидим. Попробуйте выполнить наш следующий код чтобы увидеть универсальность такого информационного потока.

function Get-AllTheInfo
{
    [CmdletBinding()]param()

    Write-Information -MessageData $(Get-Date) -Tags Dev,CIPipelineBuild
    if ($(Get-Date).DayOfWeek -notin 'Saturday','Sunday')
    {
        Write-Information -MessageData "Get to work, you slacker!" -Tags Encouragement,Automation
    }
}

# Как и потоки Verbose с Debug, Information по умолчанию не виден
# Раьота с этой информацией намного улучшается теми cmdlet которые в действительности обрабатывают имеющиеся теги
Get-AllTheInfo -InformationVariable infos
Get-AllTheInfo -InformationAction Continue

# Информация может фильтроваться и обрабкатываться, делая сообщения ваших сценариев более выразительными
$infos | Where-Object -Property Tags -contains 'CIPipelineBuild'
 	   

Потоками также можно управлять глобально через переменные Preference, как это показано в примере ниже:

$ErrorActionPreference = 'SilentlyContinue'
$VerbosePreference = 'Continue'
Import-Module -Name Microsoft.PowerShell.Management -Force
Get-Item -Path '/somewhere/over/the/rainbow'
 	   

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

Remove-Item -Path (New-TemporaryFile) -Confirm
Remove-Item -Path (New-TemporaryFile) -WhatIf

# Автоматическими переменными также обслуживаются WhatIf и Confirm
$WhatIfPreference = $true
New-TemporaryFile

$WhatIfPreference = $false # Сброс в установленное по умолчанию значение
$ConfirmPreference = 'Low' # None,Low,Medium,High
New-TemporaryFile
 	   

Для записи в различные потоки в качестве разработчика попробуйте применять cmdlet Write (за исключением Write-Host):

Write-Warning -Message 'Предостережение выглядит так'
Write-Error -Message 'В то время как ошибка представляется так'
Write-Verbose -Message 'Verbose, Debug и Information по умолчанию скрыты'
 	   

Переназначать можно все потоки, тем самым создавая некий новый файл как в таком примере:

Get-Item -Path $home,'nonexistant' 2> error.txt 1> success.txt
Get-Content -Path error.txt, success.txt
 	   

Вы также можете добавлять различные потоки в конец файлов применяя соответствующий оператор >>:

Get-Item -Path $home,'nonexistant' 2>> error.txt 1>> success.txt
Get-Content -Path error.txt, success.txt
 	   

Потоки также можно сочетать в общий вывод при помощи оператора >&1:

# Это, к примеру, помогает при плохо ведущих себя внешних приложениях
Get-Module -Verbose -List -Name 'PackageManagement','nonexistant' 2>&1 4>&1
 	   

Однако сочетание потоков в общем выводе переполнит такой вывод:

$modules = Get-Module -Verbose -List -Name 'PackageManagement','nonexistant' 2>&1 4>&1
$modules.Count # Это должно содержать лишь один...
$modules[0] # Это несомненно не выглядит как модуль
 	   

Как только вы запустите PowerShell Core, имеющийся поставщик файловой системы начинает работать и импортирует ваши смонтированные устройства. Обычно вас помещают в ваш собственный каталог home или - когда вы системный администратор - в корне вашей системы.

Взгляните на вывод Get-PSProvider чтобы посмотреть на всех доступных поставщиков, как это показано ниже:

 

Рисунок 2-4

Для просмотра того, какие cmdlet поддерживаются поставщиками, выполните следующий код:

# те cmdlet, которые работают с поставщиками
Get-Command -Noun Location, Item, ItemProperty, ChildItem, Content, Path
 	   

По умолчанию различные поставщики соответствуют различным устройствам. Посмотрите на некоторых из них, выполнив такой код:

# Поставщики обычно автоматически монтируют свои устройства
Get-PSDrive
 	   

New-Item $home\hidden\testfile,$home\hidden\.hiddentestfile -ItemType File -Force
$(Get-Item $home\hidden\.hiddentestfile -Force).Attributes = [System.IO.FileAttributes]::Hidden
Get-ChildItem -Path $home\hidden # .hiddentestfile не появится
Get-ChildItem -Path $home\hidden -Hidden # Покажет лишь скрытый файл
Get-ChildItem -Path $home\hidden -Force # Возвратит все файлы
 	   

Параметры Include и Exclude могут оказаться мощными опциями фильтрации для Get-ChildItem:

# Параметры Include и Exclude могут служить полезными фильтрами
# / в установках Windows по умолчанию для системных устройств
# Делая возможной более сложные филтрации чем обычный параметр Filter
Get-ChildItem -Path $pshome -Recurse -Include *.dll,*.json -Exclude deps.ps1
 	   

cmdlet content позволяют что- нибудь изменять. Для определённой файловой системы вы как правило используете их для считывания и измененеия содержимого файла:

# Это также работает и для прочих cmdlet поставщиков
Get-Content -Path $pshome/Modules/PackageManagement/* -Include *.psm1
Set-Content -Path $home\testfile -Value "File content`nMultiple lines"
Add-Content -Path $home\testfile -Value 'Another new line'
Get-Content -Path $home\testfile
 	   

Наконец, выполните следующий код для отображения нового совместного ресурса CIFS с помощью PowerShell:

# Именно поставщик файловой системы является тем, что позволяет монтировать дополнительные устройства поставщика
New-PSDrive -Name onlyInShell -Root \\someserver\someshare -PSProvider FileSystem
Get-ChildItem -Path onlyInShell:
Remove-PSDrive -Name onlyInShell
 	   

Для перечисления всех элементов в определённом улье реестра своей локальной машины выполните такой код:

# Как и для файловой системы, имеется возможность обхода улья локального реестра.
# Применяются ACL, поэтому нередки ошибки AccessDenied
Get-ChildItem HKLM:\SOFTWARE
 	   

Поскольку нет никаких дополнительных фильтров, у вас нет особого контроля над Get-ChildItem, который лишь возвращает ключи реестра и отображает их значения. Попытка перечисления значений следующим обазом завершится отказом:

# По умолчанию Get-ChildItem возвращает ключи и их значения
Get-ChildItem -Recurse -Path 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Run'
 	   

Для перечисления значений реестра применяется cmdlet Get-ItemProperty. Попробуйте такой образец кода:

# Для выборки только свойств вместо этого применяется Get-ItemProperty
# Без предоставления названия, Get-ItemProperty возвращает для данного пути все значения
Get-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion'

# Когда применяется только значение соответствующего свойства
Get-ItemPropertyValue -Path 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name ProductName

# Хотя это применяется преимущественно для доступа к реестру, это также можно применять и к
# файловой системе. Тем не менее, такой подход слишком громоздкий
Get-ItemProperty -Path $(Get-Command -Name pwsh).Source -Name LastWriteTime
 	   

Создание новых элементов рабоатет аналогично файловой системе. Обратите внимеание, что создаются ключи реестра, не значения:

# Вы можете применять New-Item для создания новых ключей
New-Item -Path HKCU:\Software -Name MyProduct
 	   

Для работы со значениями прмиеняются cmdlet ItemProperty. Для того чтобы увидеть как создаются новые значения и изменяются имеющиеся, воспользуйтесь следующим образцом кода:

<#
Для создания новых значений применяйте New-ItemProperty. Значениями для PropertyType могут быть:
String (REG_SZ): Стандартная строка
ExpandString (REG_EXPAND_SZ): Строка с автоматическим расширением переменной среды
Binary (REG_BINARY): Двоичные данные
DWord (REG_DWORD): 32bit ldjbxyjt xbckj
MultiString (REG_MULTI_SZ): Массив строк
QWord (REG_QWORD): 64bit двоичное число
#>
New-ItemProperty -Path HKCU:\Software\MyProduct -Name Version -Value '0.9.9-rc1' -PropertyType String
New-ItemProperty -Path HKCU:\Software\MyProduct -Name SourceCode -Value $([Text.Encoding]::Unicode.GetBytes('Write-Host "Cool, isnt it?"')) -PropertyType Binary

# Проверьте это ;)
[scriptblock]::Create($([Text.Encoding]::Unicode.GetString($(Get-ItemPropertyValue -Path HKCU:\Software\MyProduct -Name SourceCode)))).Invoke()

# Измените некий элемент
Set-ItemProperty -Path HKCU:\Software\MyProduct -Name SourceCode -Value $([Text.Encoding]::Unicode.GetBytes('Stop-Computer -WhatIf'))
[Text.Encoding]::Unicode.GetString($(Get-ItemPropertyValue -Path HKCU:\Software\MyProduct -Name SourceCode))
 	   

Удалять элементы просто. Для того чтобы снова удалить ваш ключ попробуйте следующий образец кода:

# Имеющийся по умолчанию cmdlet удаления работает также
Remove-Item -Path HKCU:\Software\MyProduct -Verbose
 	   

Имейте в виду, что имеющийся поставщик реестра не способен отображать удалённые реестры - чтобы иметь возможность выполнять подобное вам требуется применять .NET.

# Нет возможности применять права доступа
Get-PSProvider -PSProvider Registry

# Отображение локального улья работает отлично
New-PSDrive -Name HKCR -PSProvider Registry -Root HKEY_CLASSES_ROOT
Get-ChildItem -Path HKCR:
Remove-PSDrive -Name HKCR
 	   

Для перечисления хранилищ сертификатов и самих сертификатов внутри хранилища воспользуйтесь таким cmdlet поставщика:

# Ещё один поставщик, применяемый исключительно для Windows, делающий возможным доступ к локальным хранилищам сертификатов
Get-PSProvider -PSProvider Certificate

# И вновь применим установленный по умолчанию cmdlets
# Перечисли все хранилища сертификатов
Get-ChildItem -Path Cert:\CurrentUser

# Перечилим все сертификаты конкретного персонального хранилища пользователя
Get-ChildItem -Path Cert:\CurrentUser\my
 	   

ДРасширяющие параметры cmdlet Get-ChildItem позволяют прмменять дополнительнные фильтры:

# Те параметры, которые предлагаются в Windows PowerShell его потсавщиком сертификатов очень интересны,
# будут доступны дополнительные параметры, такие как -EKU -SslServerAuthentication
Get-ChildItem -Path Cert:\CurrentUser\my -CodeSigningCert
 	   

В PowerShell Core могут использоваться не все параметры Get-ChildItem, с которыми вы знакомы в PowerShell Windows. Where-Object продолжает оставаться вашим другом:

$certificate = Get-ChildItem -Path Cert:\CurrentUser\my | Select-Object -First 1

# Фильтруем по значениям OID. Если невозможно разрешить OID, вместо дружественного названия применяйте ID пречисления объектов!
# Значение OID является более надёжным и не выступает предметом локализации
$certificate.EnhancedKeyUsageList

# в качестве примера поиска по всем сертификатам аутентификации клиентов
Get-ChildItem -Path cert:\currentuser\my | Where-Object -FilterScript {$_.EnhancedKeyUsageList.ObjectId -eq '1.3.6.1.5.5.7.3.2'}

# Не менее важно; фильтрация сертификатов когда доступны частные ключи, т.е. для документов с цифровой подписью
Get-ChildItem -path Cert:\CurrentUser\my | 
    Where-Object -Property HasPrivateKey | 
    Format-table -Property Subject,Thumbprint,@{Label='EKU'; Expression = {$_.EnhancedKeyUsageList.FriendlyName -join ','}}

$certificate.HasPrivateKey