ru-ru/sthTools.psm1-Help.xml
<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml"> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Test-sthWindowsUpdateRebootRequired</command:name> <command:verb>Test</command:verb> <command:noun>sthWindowsUpdateRebootRequired</command:noun> <maml:description> <maml:para>Функция для проверки необходимости перезагрузки компьютеров после установки обновлений, и, в случае надобности, ее инициализация. </maml:para> </maml:description> </command:details> <maml:description> <maml:para>Функция для проверки необходимости перезагрузки локального или удаленных компьютеров после установки обновлений. </maml:para> <maml:para>Функция проверяет существование ключа реестра в ветви Component Based Servicing - HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\RebootPending, а также ключа в ветви Windows Update - HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired. </maml:para> <maml:para>Кроме того, функция позволяет инициировать перезагрузку тех удаленных (но не локального) компьютеров, которые в ней нуждаются, путем указания параметров -Restart и -YesRestart. Перезагрузка локального компьютера на выполняется (локальный компьютер может быть обозначен любым из следующих способов: 'localhost', 'hostname' или 'hostname.domainname.com') </maml:para> <maml:para>По умолчанию функция не выводит результаты для компьютеров, которые на момент ее выполнения были недоступны. Для того, чтобы увидеть, к каким компьютерам функция не смогла получить доступ, укажите параметр -ShowInaccessible. </maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Test-sthWindowsUpdateRebootRequired</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="0" aliases="none"> <maml:name>ComputerName</maml:name> <maml:Description> <maml:para>Имена компьютеров, подлежащих проверке на необходимость перезагрузки. </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>localhost</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Restart</maml:name> <maml:Description> <maml:para>Указание параметра инициирует перезагурзку компьютеров (только удаленных), которые в ней нуждаются. </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>YesRestart</maml:name> <maml:Description> <maml:para>Подтверждение выполнения перезагурзки (должен быть указан вместе с -Restart). </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ShowInaccessible</maml:name> <maml:Description> <maml:para>Вывод информации о недоступных компьютерах среди результатов выполнения. </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="0" aliases="none"> <maml:name>ComputerName</maml:name> <maml:Description> <maml:para>Имена компьютеров, подлежащих проверке на необходимость перезагрузки. </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>localhost</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>Restart</maml:name> <maml:Description> <maml:para>Указание параметра инициирует перезагурзку компьютеров (только удаленных), которые в ней нуждаются. </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>YesRestart</maml:name> <maml:Description> <maml:para>Подтверждение выполнения перезагурзки (должен быть указан вместе с -Restart). </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"> <maml:name>ShowInaccessible</maml:name> <maml:Description> <maml:para>Вывод информации о недоступных компьютерах среди результатов выполнения. </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>Test-sthWindowsUpdateRebootRequired ComputerName ComponentBasedServicing WindowsUpdate ------------ ----------------------- ------------- localhost False False </dev:code> <dev:remarks> <maml:para/> <maml:para>Проверка локального компьютера на необходимость перезагрузки. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>Test-sthWindowsUpdateRebootRequired -ComputerName comp-1, comp-2, localhost ComputerName ComponentBasedServicing WindowsUpdate ------------ ----------------------- ------------- comp-1 False False comp-2 True True localhost False False </dev:code> <dev:remarks> <maml:para/> <maml:para>Проверка нескольких компьютеров путем указания их имен в качестве аргументов параметра -ComputerName. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title> -------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>'comp-1', 'comp-2', 'localhost' | Test-sthWindowsUpdateRebootRequired ComputerName ComponentBasedServicing WindowsUpdate ------------ ----------------------- ------------- comp-1 False False comp-2 True True localhost False False </dev:code> <dev:remarks> <maml:para/> <maml:para>Проверка нескольких компьютеров путем передачи их имен функции по конвейеру. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 4 --------------------------</maml:title> <dev:code>Test-sthWindowsUpdateRebootRequired -ComputerName comp-1,comp-2,localhost,Inaccessiblecomputer -ShowInaccessible ComputerName ComponentBasedServicing WindowsUpdate ------------ ----------------------- ------------- comp-1 False False comp-2 True True localhost False False Inaccessiblecomputer Inaccessible Inaccessible </dev:code> <dev:remarks> <maml:para/> <maml:para>Проверка нескольких компьютеров с использованием параметра -ComputerName. </maml:para> <maml:para/> <maml:para>Кроме того, использование параметра -ShowInaccessible приводит к тому, что будут выведены имена тех компьютеров, доступ к которым получить не удалось. (По умолчанию информация о недоступных компьютерах не выводится). </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 5 --------------------------</maml:title> <dev:code>Test-sthWindowsUpdateRebootRequired -ComputerName comp-1,comp-2,localhost -Restart -YesRestart ComputerName ComponentBasedServicing WindowsUpdate ------------ ----------------------- ------------- comp-1 False False comp-2 True True localhost True True </dev:code> <dev:remarks> <maml:para/> <maml:para>Выполняем проверку нескольких компьютеров и выполняем перезагрузку тех из них, кто в этом нуждается. (Локальный компьютер перезагружен не будет.) В этом примере будет перезагружен comp-2. </maml:para> <maml:para/> <maml:para>Для инициализации перезагрузки должны быть указаны оба параметра: -Restart и -YesRestart. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> </command:examples> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Remove-sthPreviousModuleVersions</command:name> <command:verb>Remove</command:verb> <command:noun>sthPreviousModuleVersions</command:noun> <maml:description> <maml:para>Функция для удаления предыдущих версий модулей, установленных из PowerShell Gallery. </maml:para> </maml:description> </command:details> <maml:description> <maml:para>Функция для удаления предыдущих версий модулей, установленных из PowerShell Gallery. </maml:para> <maml:para>Функция предназначена для удаления предыдущих версий модулей после их обновления до текущих версий при помощи командлета Update-Module. </maml:para> <maml:para>Вы можете указать имена одного или нескольких модулей при помощи параметра -ModuleName. </maml:para> <maml:para>Если параметр -ModuleName не указан, произойдет удаление предыдущих версий всех модулей, установленных из PowerShell Gallery </maml:para> <maml:para>Для вывода результатов функция использует командлет Write-Output, что позволяет передавать результаты ее выполнения в текстовый файл. Например: Remove-sthPreviousModuleVersions -ModuleName AzureRM.profile, AzureRM.Resources >> c:\log.txt </maml:para> <maml:para>Кроме того, функция поддерживает параметры -WhatIf и -Confirm. </maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Remove-sthPreviousModuleVersions</maml:name> <command:parameter required="false" variableLength="true" globbing="true" pipelineInput="False" position="0" aliases="none"> <maml:name>ModuleName</maml:name> <maml:Description> <maml:para>Имена модулей, предыдущие версии которых требуется удалить. </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>*</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"> <maml:name>Confirm</maml:name> <maml:Description> <maml:para>Запрос на подтверждение перед выполнением функции. </maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"> <maml:name>WhatIf</maml:name> <maml:Description> <maml:para>Показывает, что произойдет при запуске функции. Сама функция выполнена не будет. </maml:para> </maml:Description> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <command:parameter required="false" variableLength="true" globbing="true" pipelineInput="false" position="0" aliases="none"> <maml:name>ModuleName</maml:name> <maml:Description> <maml:para>Имена модулей, предыдущие версии которых требуется удалить. </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String[]</command:parameterValue> <dev:type> <maml:name>String[]</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>*</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"> <maml:name>Confirm</maml:name> <maml:Description> <maml:para>Запрос на подтверждение перед выполнением функции. </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"> <maml:name>WhatIf</maml:name> <maml:Description> <maml:para>Показывает, что произойдет при запуске функции. Сама функция выполнена не будет. </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type> <maml:name>SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>Remove-sthPreviousModuleVersions -ModuleName AzureRM.profile, AzureRM.Resources Module: AzureRM.profile Latest version: 3.1.0 Removing version: 3.0.1 Removing version: 3.0.0 Module: AzureRM.Resources Latest version: 4.1.0 Removing version: 4.0.1 Removing version: 4.0.0 </dev:code> <dev:remarks> <maml:para/> <maml:para>Удаление предыдущих версий модулей AzureRM.profile и AzureRM.Resources. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>Remove-sthPreviousModuleVersions</dev:code> <dev:remarks> <maml:para/> <maml:para>Удаление предыдущих версий всех модулей, установленных из PowerShell Gallery. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title> -------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>Remove-sthPreviousModuleVersions >> c:\logs\log.txt</dev:code> <dev:remarks> <maml:para/> <maml:para>Удаление предыдущих версий всех модулей, установленных из PowerShell Gallery и передача результатов выполнения функции в текстовый файл для целей журналирования. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 4 --------------------------</maml:title> <dev:code>Remove-sthPreviousModuleVersions -ModuleName AzureRM.profile, AzureRM.Resources -WhatIf What if: Module: AzureRM.profile Latest version: 3.1.0 Removing Version: 3.0.1 Removing Version: 3.0.0 What if: Module: AzureRM.Resources Latest version: 4.1.0 Removing Version: 4.0.1 Removing Version: 4.0.0 </dev:code> <dev:remarks> <maml:para/> <maml:para>Вывод имен и версий модулей, которые будут удалены при вызове команды без параметра -WhatIf. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 5 --------------------------</maml:title> <dev:code>Remove-sthPreviousModuleVersions -ModuleName AzureRM.profile, AzureRM.Resources -Confirm Confirm Are you sure you want to perform this action? Module: AzureRM.profile Latest version: 3.1.0 Removing Version: 3.0.1 Removing Version: 3.0.0 [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y Module: AzureRM.profile Latest version: 3.1.0 Removing version: 3.0.1 Removing version: 3.0.0 Confirm Are you sure you want to perform this action? Module: AzureRM.Resources Latest version: 4.1.0 Removing Version: 4.0.1 Removing Version: 4.0.0 [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y Module: AzureRM.Resources Latest version: 4.1.0 Removing version: 4.0.1 Removing version: 4.0.0 </dev:code> <dev:remarks> <maml:para/> <maml:para>Запрос подтверждения перед удалением предыдущих версий модулей. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> </command:examples> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details> <command:name>Get-sthLDAPComputersByOperatingSystem</command:name> <command:verb>Get</command:verb> <command:noun>sthLDAPComputersByOperatingSystem</command:noun> <maml:description> <maml:para>Функция для получения всех действующих (атрибут Enabled равен $True) объектов компьютеров из Active Directory при помощи ADSI и группировка их по операционной системе с использованием свойств пользовательского объекта: XP, Seven, Eight и Ten. </maml:para> </maml:description> </command:details> <maml:description> <maml:para>Функция выполняет запрос относительно контекста имен текущего домена Active Directory с использованием ADSI и возвращает пользовательский объект (PSCustomObject), содержащий объекты действующих (Enabled = $True) компьютеров, сгруппированных по операционной системе. </maml:para> <maml:para>Содержимое этого объекта может быть использовано в качестве ввода для командлетов и функций, затрагивающих множество компьютеров и принимающих их имена или другую информацию в виде значений параметров. </maml:para> <maml:para>Возвращаемый функцией пользовательский объект состоит из четырех основных свойств: XP, Seven, Eight and Ten. Эти свойства представляют из себя массивы, содержащие объекты компьютеров со всеми атрибутами, полученными в результате запроса к Active Directory. </maml:para> <maml:para/> <maml:para>Вы можете использовать функцию следующим образом: </maml:para> <maml:para>$Comps = Get-sthLDAPComputersByOperatingSystem </maml:para> <maml:para>Затем, вы можете получить объекты всех компьютеров с Windows XP: $Comps.XP </maml:para> <maml:para>Windows 7: $Comps.Seven </maml:para> <maml:para>"Windows 8" и "Windows 8.1": $Comps.Eight </maml:para> <maml:para>"Windows 10": $Comps.Ten </maml:para> <maml:para>По умолчанию для объектов компьютеров выводятся только те из атрибутов, что возвращает командлет Get-ADComputer без использования параметра -Properties. Для того, чтобы вывести объекты компьютеров со всеми их атрибутами, введите: $Comps.Ten | Format-List * </maml:para> <maml:para/> <maml:para>Кроме того, пользовательский объект содержит два дополнительных свойства, определенных в файле типов: All и Summary. </maml:para> <maml:para/> <maml:para>Свойство All содержит все объекты компьютеров из четырех основных свойств: XP, Seven, Eight и Ten, для того, чтобы вы могли работать сразу со всеми содержащимися в пользовательском объекте компьютерами. </maml:para> <maml:para>Свойство Summary содержит строку (а точнее here-string), в которой отображены имена всех компьтеров в виде нескольких столбцов, по одному для каждой операционной системы. Именно это свойство используется в представлении по умолчанию, заданном в файле формата. </maml:para> </maml:description> <command:syntax> <command:syntaxItem> <maml:name>Get-sthLDAPComputersByOperatingSystem</maml:name> </command:syntaxItem> </command:syntax> <command:parameters/> <command:examples> <command:example> <maml:title>-------------------------- EXAMPLE 1 --------------------------</maml:title> <dev:code>$Comps = Get-sthLDAPComputersByOperatingSystem $Comps </dev:code> <dev:remarks> <maml:para/> <maml:para>Вывод сокращенной информации обо всех действующих компьютерах, полученных в результате запроса. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 2 --------------------------</maml:title> <dev:code>$Comps = Get-sthLDAPComputersByOperatingSystem $Comps.Ten </dev:code> <dev:remarks> <maml:para/> <maml:para>Вывод объектов компьютеров, использующих операционную систему Windows 10. </maml:para> <maml:para/> <maml:para>По умолчанию выводятся только следующие свойства: DistinguishedName, DNSHostName, Name, ObjectClass, GUID, SamAccountName и SID. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title> -------------------------- EXAMPLE 3 --------------------------</maml:title> <dev:code>$Comps = Get-sthLDAPComputersByOperatingSystem $Comps.Ten | Format-List * </dev:code> <dev:remarks> <maml:para/> <maml:para>Вывод объектов компьютеров, использующих операционную систему Windows 10. </maml:para> <maml:para/> <maml:para>Указав "*" в качестве параметра командлета Format-List мы получим все свойства объектов компьютеров. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 4 --------------------------</maml:title> <dev:code>$Comps = Get-sthLDAPComputersByOperatingSystem $Comps.Ten.Name </dev:code> <dev:remarks> <maml:para/> <maml:para>Вывод имен действующих компьютеров, использующих операционную систему Windows 10. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> <command:example> <maml:title>-------------------------- EXAMPLE 5 --------------------------</maml:title> <dev:code>$Comps = Get-sthLDAPComputersByOperatingSystem $Comps.Ten.Name | Test-sthWindowsUpdateRebootRequired </dev:code> <dev:remarks> <maml:para/> <maml:para>Проверка, нуждаются ли в перезагрузке какие либо из компьютеров, использующих операционную систему Windows 10. </maml:para> <maml:para/> <maml:para/> </dev:remarks> </command:example> </command:examples> </command:command> </helpItems> |