Разное

Комментарии powershell: Комментарии в PowerShell

04.09.1985

Содержание

Как добавить комментарий к объекту GPO

Обновлено 23.05.2019

Добрый день! Уважаемые читатели и гости IT блога Pyatilistnik.org. В прошлый раз мы с вами рассмотрели вопрос по отключению тестового режима Windows 10. Сегодня мы поговорим про очень полезную вещь, которая позволит вашей инфраструктуре Active Directory, быть более описанной и задокументированной. В данной заметке пойдет речь, о добавлении комментариев к объектам групповой политики. Будьте профессионалами, не ленитесь делать такие простые вещи.

Нужны комментарии или нет

Лично я всегда придерживался концепции, что если сервис, оборудование или софт позволяет оставить какой-либо комментарий, то нужно не лениться и всегда это делать, по ряду причин:

  • Во первых через какое-то время вы сами можете забыть, что настраивали и за что, это отвечает. В такой ситуации наличие описания, или комментария сильно упростит понимание, что это и для чего, сэкономит вам некоторое время.
  • Во вторых групповые политики не всегда в составе своего имени несут смысл своего назначения, так как в название не запихнешь всего и вот наличие подробного описание в виде комментариев, очень сильно вам поможет с поиском нужной политики или параметров. Я много раз встречал в различных организациях наличие большого количества групповых политик, применяемых к объектам AD, и в большинстве случаев, когда нужно понять из-за какой политики применяется та или иная настройка, администраторы тратили уйму времени, чтобы это отыскать. Элементарные комментарии сильно бы упростили им их задачу.
  • В третьих, когда у вас порядок, то вам проще передавать дела на время отпуска или в связи со сменой работы, согласитесь, что когда приходишь на новое место и входишь в курс дел, так где все службы и настройки задокументированы, проще вникнуть в режим работы инфраструктуры, не желе так, где был безалаберный администратор, который считал, все это своей тайном и чтобы его не удалили, специально не посвящал в детали никого. Это лишь показывает его неуверенность и не профессионализм, за такое отношение они часто попадают в конфликтные ситуации.

Методы позволяющие задать комментарий в GPO

Существует два способа, которые позволят вам оставить комментарии в видео описаний к вашим объектам групповой политики:

  1. Использование оснастки «Управление групповой политикой (GPMC)»
  2. Командлеты PowerShell

Давайте проставим комментарий через графический интерфейс GPMC. Выберите нужную вам политику и щелкните по ней правым кликом, из контекстного меню выберите пункт «Изменить».

Далее вы кликаете по корню и из меню выбираете пункт «Свойства».

В открывшемся окне свойств, перейдите на вкладку «Комментарий» и в примечании введите нужное вам описание. Сохраняем изменения и закрываем окно.

Перейдите теперь на вкладку «Сведения» и проверьте, что у вас появилось описание в комментариях.

Теперь попробуем выполнить то же самое, но с использованием PowerShell. Откройте PowerShell от имени администратора. первым делом мы посмотрим все политики и есть ли у них описание, для этого:

get-gpo -All | FT DisplayName,Description,ID

В итоге я виду, имя объекта GPO, описание (Description) и ID (GUID).

Теперь зная GUID поменяем текст комментария.

(Get-GPO -Guid ’49df37c4-d9af-48d0-85aa-96e91b6cc13a’).Description=’Новое описание политики’

Смотрим все групповые политики и видим, что описание у GPO изменилось.

Или можно изменить по имени политики.

(Get-GPO -Name ‘Управление UIPI’).Description=’Еще раз изменил комментарий’

Как видите, все очень просто, быстро и полезно. Надеюсь, что вы теперь найдете желание и время, чтобы привести в порядок ваше описание политик GPO. С вами был Иван Семин, автор и создатель IT портала Pyatilistnik.org.

Руководство по Windows PowerShell для начинающих

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

PowerShell — это объектно-ориентированный программный движок и скриптовый язык с интерфейсом командной строки, предоставляющий широкие возможности для конфигурирования операционных систем семейства MS Windows. Он предлагает как чисто консольный интерфейс, так и полноценную среду разработки PowerShell ISE (Integrated Scripting Environment, встроенное скриптовое окружение) для скриптов.

Для запуска интерфейса командной строки введите powershell в меню «Выполнить» (WinKey + R). PowerShell ISE запускается с помощью команды «PowerShell ISE» в том же меню. ISE более предпочтительно, так как предоставляет более широкие возможности разработчику благодаря подсветке синтаксиса, функции автозаполнения кода и другим особенностям, присущим многим «большим» IDE.

Среда разработки Windows PowerShell ISE

Написание и запуск скриптов

Скрипты сохраняются в виде файлов с расширением .ps1. Несмотря на то, что PowerShell уже давно является нативной частью ОС Windows, вы не сможете запустить его скрипты простым двойным щелчком. Для этого надо кликнуть правой кнопкой по скрипту и выбрать «Запустить в PowerShell».

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

  • Restricted — выполнение скриптов запрещено. Стандартная конфигурация;
  • AllSigned — можно запускать скрипты, подписанные доверенным разработчиком; перед запуском скрипта PowerShell запросит у вас подтверждение;
  • RemoteSigned — можно запускать собственные скрипты или те, что подписаны доверенным разработчиком;
  • Unrestricted — можно запускать любые скрипты.

Для начала работы необходимо изменить настройку политики запуска на RemoteSigned, используя команду Set-ExecutionPolicy:

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

Командлеты

Командлеты — это команды с предопределённой функцией, подобные условным операторам в языках программирования. У них есть несколько ключевых особенностей:

  • существуют системные, пользовательские и опциональные командлеты;
  • результатом выполнения командлета будет объект или массив объектов;
  • командлеты могут обрабатывать данные и передавать их другим командлетам с помощью конвейеров;
  • командлеты нечувствительны к регистру, так что нет никакой разницы между Get-ADUser, get-aduser и gEt-AdUsEr;
  • в качестве разделителя используется символ ; .

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

  • Get-Process — отобразить текущие процессы, запущенные на компьютере;
  • Get-Service — отобразить список служб и их статус;
  • Get-Content — отобразить содержимое указанного файла, например Get-Content C:\Windows\System32\drivers\etc\hosts.

При необходимости список всех доступных командлетов можно вывести с помощью Get-Help-Category. Запомните эту команду — она крайне важна для тех, кто изучает PowerShell с нуля, так как помогает быстрее начать ориентироваться в его возможностях.

Результат выполнения команды Get-Help-Category

Также можно создавать свои командлеты, но эта тема выходит за рамки нашего руководства по PowerShell для начинающих.

Параметры

У каждого командлета есть несколько параметров, определяющих его работу. PowerShell ISE автоматически предлагает все доступные параметры с отображением их типа. Например,

Get-Service-NameW* выводит список служб, у которых имя начинается с W. Если вы забыли, какие параметры у введённого командлета, воспользуйтесь Get-Member.

Например, Get-Process | Get-Member:

Список параметров командлета Get-Process

Если вы не нашли того, что нужно, или не уверены в том, как правильно задаются параметры, можно даже запросить примеры с помощью параметра -Examples. Встроенное руководство по PowerShell покажет, для чего используются разные параметры:

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

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

Get-Help можно просто написать Help — эта команда также вызовет встроенное руководство по PowerShell.

При написании больших скриптов или коллективной разработке можно пользоваться комментариями. Каждый комментарий начинается с символа #, а блок комментариев ограничивается комбинациями символов <# и #> в начале и в конце соответственно.

Конвейер

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

  • GetService | SortObject -property Status — сортировка запущенных служб по статусу;
  • “Hello World!” | Out-File C:\ps\test.txt
    — запись текста в файл.

Можно использовать несколько конвейеров. Например, следующий скрипт выводит список имён всех служб за исключением остановленных:

Get-Service | WHERE {$_.status -eq “Running”} | SELECT displayname

Заключение

Это руководство для тех, кто изучает PowerShell с нуля, поэтому здесь раскрыты только базовые понятия и приёмы. После его прочтения у вас должно появиться представление о том, что собой представляет этот инструмент. Также мы рассмотрели варианты изменения политики выполнения скриптов, что такое командлет, как они обмениваются данными с помощью конвейера и как получить свойства нужного объекта. Помните, что в случае затруднений можно воспользоваться командлетом Get-Help — это одна из самых важных команд для начинающих изучать PowerShell.

Если пользуетесь не только Windows, но и Linux, посмотрите статью про команды терминала Linux для начинающих. В ней рассказывается про работу с процессами и файлами, навигацию, каналы, xargs, awk и grep.

Перевод статьи «Windows PowerShell Scripting Tutorial for Beginners»

Оценить

Вышла третья ознакомительная версия PowerShell 2.0

Корпорация Microsoft недавно выпустила третью ознакомительную версию PowerShell 2.0. Она значительно усовершенствована по сравнению с предыдущей и дает все основания надеяться, что PowerShell 2.0 в конечном итоге превратится в надежный инструмент системного администрирования, располагающий богатым набором функций уровня предприятия, которые так актуальны для многих организаций. В этой статье Скотт Лоу (Scott Lowe) рассказывает об основных особенностях новой версии.

Хотя версия 2.0 знаменитого языка сценариев Microsoft PowerShell не дошла еще даже до бета-тестирования, разработчики на днях выпустили уже третью ознакомительную версию оболочки. Хочу уточнить: ознакомительная версия – это ни в коем случае не бета. Она предназначена, как и следует из названия, только для ознакомления с новой технологией, а потому может существенно отличаться от окончательной версии по функциональности. Microsoft особо подчеркивает, что ознакомительные версии не предназначены для повседневного использования и могут иметь радиальные отличия от конечного продукта. Короче говоря, не стоит строить свои расчеты исходя из ознакомительной версии, а потом жаловаться, что расчеты не оправдались.

Что нам готовит PowerShell 2.0?

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

ISE

Самое заметное отличие PowerShell 2.0 от предыдущей версии – наличие интегрированной среды построения сценариев Windows PowerShell (Integrated Scripting Environment, ISE). ISE – это утилита с графическим интерфейсом, которая делает процесс создания и изменения сценариев PowerShell намного проще и удобнее. Разумеется, для этого существуют и приложения сторонних производителей вроде PowerGUI от Quest, но все-таки приятно, что теперь и разработчики PowerShell взялись за дело.


Снимок PowerShell 2.0 ISE

Удаленная работа

В PowerShell 2.0 значительно расширены возможности применения сценариев PowerShell к удаленным системам. Если коротко, администратор получает возможность со своего собственного компьютера направлять команды PowerShell, которые выполняются на удаленных станциях и выводят результаты на экран администратора. Разумеется, для этого на удаленных системах тоже должен быть установлен PowerShell. Прелесть PowerShell 2.0 в том, что удаленные пользователи не видят визуальных признаков выполнения процессов PowerShell – они отражаются только в Диспетчере задач (Task Manager). Согласитесь, если бы посреди рабочего дня на компьютерах ничего не подозревающих удаленных пользователей вдруг ни с того, ни с сего начали бы выскакивать окна непонятных приложений, существование отдела технической поддержки превратилось бы в ад!

Фоновый режим

При внимательном рассмотрении функции удаленного выполнения команд PowerShell 2.0 становится понятным, что все эти команды работают в фоновом режиме незаметно для пользователей. Администратор получает возможность создавать сценарии, которые будут выполняться в фоне, в то время как он сам может продолжать работу в новом окне PowerShell. Позже администратор собирает все полученные в фоновом режиме результаты. Возможность выполнять команды в фоне (асинхронно) позволяет администратору продолжать работу, не дожидаясь завершения выполнения запущенных сценариев.

Транзакции

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

Многострочные комментарии

В первой версии PowerShell добавлять многострочные комментарии вручную (без помощи PowerGUI) было чрезвычайно утомительно, поскольку каждая строка комментария должна была начинаться с символа #. Выпустив этот символ в одной из строк, можно было загубить весь сценарий. В PowerShell 2.0 используются элементы сценария , между которыми можно вставлять многострочные комментарии любой длины. На первый взгляд, усовершенствование незначительное, но функции облегченной обработки многострочных комментариев есть во всех приличных языках сценариев и программирования.

Новые командлеты, параметры, переменные и операторы

Поскольку PowerShell 2.0 – это новая полномасштабная версия языка, в нее включено множество новых командлетов, новых параметров для уже существующих командлетов, новых переменных и операторов. Например, операторы -Split и -Join позволяют при определенных условиях разбивать или объединять строки. Появились новые командлеты для обслуживания транзакций (Start-PSTransaction, Undo-PSTransaction) и задач, выполняемых в фоновом режиме (Start-PSJob, Stop-PSJob), а также для поддержки новых функций отладки PowerShell 2.0 (Set-PSBreakpoint, Get-PSBreakpoint). У старых командлетов, как я уже упоминал, появились новые параметры. Например, у Stop-Process — параметр -force, а у Export-Csv – параметр -Delimiter, позволяющий указать символы для применения. Большинство новых командлетов и параметров предназначено для обслуживания новых функций PowerShell, но многие из них были введены для того, чтобы сделать язык в целом более надежным.

Заключение

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

Автор: Scott Lowe
Перевод: SVET



Оцените статью: Голосов

Запуск скрипта PowerShell — Get-PowerShell

PowerShell весьма мощный язык сценариев для ОС Windows, поэтому на нем очень легко писать вредоносный код. Чтобы не допустить запуска «плохих» сценариев в Windows встроено несколько механизмов защиты.

Для тех ситуаций, когда необходимо все же скрипт запустить выполните эти действия:

  • Запустите сеанс PowerShell. Возможно с правами администратора
  • Чтобы временно отключить защиту наберите эту команду:

Set-ExecutionPolicy Unrestricted -Scope Process

Set-ExecutionPolicy Unrestricted -Scope Process
  • Напишите имя скрипта и полный путь к нему. Используйте клавишу Tab, чтобы быстрее ввести путь. Например:

C:\Users\Administrator\test.ps1

C:\Users\Administrator\test.ps1

Почему необходимо выполнить эти команды?

Во-первых, PowerShell никогда не ищет исполняемые файлы и скрипты в текущем каталоге. Поэтому запуск скрипта PowerShell необходимо производить указывая полный или относительный путь к файлу. Например, если файл расположен в каталоге C:\Users\Administrator\, то его можно выполнить следующим образом:

PS C:\Users\Administrator> .\test.ps1 PS C:\Users\powershell> C:\Users\Administrator\test.ps1

PS C:\Users\Administrator> .\test.ps1

PS C:\Users\powershell> C:\Users\Administrator\test.ps1

Во-вторых, к счастью, по умолчанию запуск всех скриптов запрещен (единственное пока исключение это Windows Server 2012 R2). Поэтому при попытке запуска скрипта PowerShell вы можете увидеть следующие сообщение: Невозможно загрузить файл C:\Users\Administrator\test.ps1, так как выполнение сценариев отключено в этой системе или оно же в английском варианте: File C:\Users\Administrator\test.ps1 cannot be loaded because running scripts is disabled on this system.

В большинстве случаев для разрешения запуска скрипта PowerShell необходимо выполнить с правами администратора данный код:

Set-ExecutionPolicy RemoteSigned

Set-ExecutionPolicy RemoteSigned

Если вдруг вы обычный пользователь, тогда можно посоветовать данную команду:

Set-ExecutionPolicy RemoteSigned -Scope currentuser

Set-ExecutionPolicy RemoteSigned -Scope currentuser

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

И так, чтобы запуск скрипта PowerShell был возможен необходимо один раз запустить Set-ExecutionPolicy RemoteSigned и затем выполнять сам файл указывая относительный или полный путь к файлу.

Устанавливаем PowerShell в старых версиях Windows

Windows Server, Windows Vista, Windows XP, Программное обеспечение
  • Recluse
  • 19.03.2018
  • 12 146
  • 7
  • 04.10.2021
  • 26
  • 25
  • 1
  • Содержание статьи

Установка PowerShell в Windows

PowerShell — это современная замена командной строки в Windows, альтернатива Bash от Microsoft и просто мощный инструмент в умелых руках. Тем не менее, есть он далеко не во всех операционных системах Windows — первой операционной системой, в которой был встроен PowerShell, была Windows 7. К счастью, установить его можно и на более старые системы — такие как Windows XP, Vista и их серверные аналоги. Делается это с помощью установки комплекта Windows Management Framework.

Программная часть компьютера при этом должна соответствовать следующим требованиям:

Операционная система:
Windows XP с установленным Service Pack 3
Windows Server 2003 с установленными Service Pack 2
Windows Vista с установленными Service Pack 1 или Service Pack 2
Windows Server 2008 с установленными Service Pack 1 или Service Pack 2

Установленный Microsoft .NET Framework 2 (так же подходит .NET Framework 3 и .NET Framework 3.5).

Скачать обновления для нужной операционной системы, содержащие в себе Windows Management Framework, в том числе Windows PowerShell 2.0 и WinRM 2.0 можно по следующим ссылкам:

Windows XP и Windows Embedded (обновление KB968930):

Windows Server 2003 (обновление KB968930):

Windows Server 2003 x64 (обновление KB968930):

Windows Vista (обновление KB968930):

Windows Vista x64 (обновление KB968930):

Windows Server 2008 (обновление KB968930):

Windows Server 2008 x64 (обновление KB968930):

После установки, исполняемый файл PowerShell можно будет найти по адресу C:\WINDOWS\system32\WindowsPowerShell\v1.0, а так же в меню Пуск.

Как вы комментируете код в PowerShell?

Как вы комментируете код в PowerShell (1.0 или 2.0)?

835

автор: Peter Mortensen

7 ответов

в PowerShell V1 есть только # чтобы сделать текст после него комментарием.

# This is a comment in Powershell

В PowerShell V2 <# #> можно использовать для комментариев блока и более конкретно для комментариев справки.

#REQUIRES -Version 2.0

<#
.SYNOPSIS
    A brief description of the function or script. This keyword can be used
    only once in each topic.
.DESCRIPTION
    A detailed description of the function or script. This keyword can be
    used only once in each topic.
.NOTES
    File Name      : xxxx.ps1
    Author         : J.P. Blanc ([email protected])
    Prerequisite   : PowerShell V2 over Vista and upper.
    Copyright 2011 - Jean Paul Blanc/Silogix
.LINK
    Script posted over:
    http://silogix.fr
.EXAMPLE
    Example 1
.EXAMPLE
    Example 2
#>
Function blabla
{}

более подробное объяснение .SYNOPSIS и .* посмотреть в разделе about_comment_based_help.

примечание: эти комментарии функции используются Get-Help командлет и может быть поставлен перед ключевым словом Function или внутри {} до или после самого кода.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *