FineFormat

1.0.0

ru-ru/FineFormat-help.xml

<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml" xmlns="http://msh">
  <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>Format-Fine</command:name>
      <command:verb>Format</command:verb>
      <command:noun>Fine</command:noun>
      <maml:description>
        <maml:para>Форматирует и фильтрует вывод.</maml:para>
      </maml:description>
    </command:details>
    <maml:description>
      <maml:para>Командлет используется для форматирования и фильтрации вывода с использованием различных условий.</maml:para>
      <maml:para>Если командлет используется без указания параметров, то он не оказывает никакого влияния на обрабатываемые объекты.</maml:para>
      <maml:para>Командлет также можно вызвать с использованием его алиаса: ff.</maml:para>
    </maml:description>
    <command:syntax>
      <command:syntaxItem>
        <maml:name>Format-Fine</maml:name>
        <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="0" aliases="none">
          <maml:name>InputObject</maml:name>
          <maml:description>
            <maml:para>Задает объекты для обработки.</maml:para>
            <maml:para>Этот параметр поддерживает получение объектов по конвейеру.</maml:para>
          </maml:description>
          <command:parameterValue required="true" variableLength="false">Object</command:parameterValue>
          <dev:type>
            <maml:name>Object</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="HaveValue, NotNullOrEmpty">
          <maml:name>HasValue</maml:name>
          <maml:description>
            <maml:para>Параметр указывает, что отображаться должны только те свойства объектов, которые имеют значения, отличные от пустых или $null.</maml:para>
            <maml:para>Aliases: HaveValue, NotNullOrEmpty</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="none">
          <maml:name>CompactNumbers</maml:name>
          <maml:description>
            <maml:para>Отображает числа в виде KB, MB, GB, TB или PB в зависимости от их величины.</maml:para>
            <maml:para>Если число меньше 1KB, то оно отображается без изменений.</maml:para>
            <maml:para>Параметр отличается от параметра -NumbersAs в том, что параметр -NumbersAs использует указанные единицы измерения (KB, MB и т. д.), а параметр -CompactNumbers определяет подходящий вариант на основе величины числа.</maml:para>
            <maml:para>Этот параметр имеет приоритет перед параметром -NumbersAs.</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="none">
          <maml:name>NumberGroupSeparator</maml:name>
          <maml:description>
            <maml:para>Отображает числа с разделителями групп цифр.</maml:para>
            <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="NullOrEmpty">
          <maml:name>NoValue</maml:name>
          <maml:description>
            <maml:para>Параметр указывает, что отображаться должны только те свойства объектов, значения которых пусты или равны $null.</maml:para>
            <maml:para>Alias: NullOrEmpty</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="none">
          <maml:name>NumbersAs</maml:name>
          <maml:description>
            <maml:para>Отображает числа в виде KB, MB, GB, TB или PB.</maml:para>
            <maml:para>Если число меньше, чем указанная единица измерения, то оно отображается без изменений.</maml:para>
            <maml:para>Параметр отличается от параметра -CompactNumbers в том, что параметр -NumbersAs использует указанные единицы измерения (KB, MB и т. д.), а параметр -CompactNumbers определяет подходящий вариант на основе величины числа.</maml:para>
            <maml:para>Параметр -CompactNumbers имеет приоритет перед этим параметром.</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>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>NumericTypes</maml:name>
          <maml:description>
            <maml:para>Параметр указывает, что отображаться должны только те свойства объектов, значения которых являются числовым типом (Int, Double и т. д.).</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="none">
          <maml:name>SymbolicTypes</maml:name>
          <maml:description>
            <maml:para>Параметр указывает, что отображаться должны только те свойства объектов, значения которых являются символьным типом (String, Char).</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="none">
          <maml:name>ValueFilter</maml:name>
          <maml:description>
            <maml:para>Задает скриптблок, который будет использоваться для фильтрации свойств по их значениям.</maml:para>
            <maml:para>Например: -ValueFilter {$PSItem -like "somevalue"}</maml:para>
          </maml:description>
          <command:parameterValue required="true" variableLength="false">ScriptBlock</command:parameterValue>
          <dev:type>
            <maml:name>ScriptBlock</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
        <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
          <maml:name>TypeNameFilter</maml:name>
          <maml:description>
            <maml:para>Задает скриптблок, который будет использоваться для фильтрации свойств по типам данных.</maml:para>
            <maml:para>Например: -TypeNameFilter {$PSItem -like "datatype"}</maml:para>
          </maml:description>
          <command:parameterValue required="true" variableLength="false">ScriptBlock</command:parameterValue>
          <dev:type>
            <maml:name>ScriptBlock</maml:name>
            <maml:uri />
          </dev:type>
          <dev:defaultValue>None</dev:defaultValue>
        </command:parameter>
      </command:syntaxItem>
    </command:syntax>
    <command:parameters>
      <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="True (ByValue)" position="0" aliases="none">
        <maml:name>InputObject</maml:name>
        <maml:description>
          <maml:para>Задает объекты для обработки.</maml:para>
          <maml:para>Этот параметр поддерживает получение объектов по конвейеру.</maml:para>
        </maml:description>
        <command:parameterValue required="true" variableLength="false">Object</command:parameterValue>
        <dev:type>
          <maml:name>Object</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="HaveValue, NotNullOrEmpty">
        <maml:name>HasValue</maml:name>
        <maml:description>
          <maml:para>Параметр указывает, что отображаться должны только те свойства объектов, которые имеют значения, отличные от пустых или $null.</maml:para>
          <maml:para>Aliases: HaveValue, NotNullOrEmpty</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>CompactNumbers</maml:name>
        <maml:description>
          <maml:para>Отображает числа в виде KB, MB, GB, TB или PB в зависимости от их величины.</maml:para>
          <maml:para>Если число меньше 1KB, то оно отображается без изменений.</maml:para>
          <maml:para>Параметр отличается от параметра -NumbersAs в том, что параметр -NumbersAs использует указанные единицы измерения (KB, MB и т. д.), а параметр -CompactNumbers определяет подходящий вариант на основе величины числа.</maml:para>
          <maml:para>Этот параметр имеет приоритет перед параметром -NumbersAs.</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>NumberGroupSeparator</maml:name>
        <maml:description>
          <maml:para>Отображает числа с разделителями групп цифр.</maml:para>
          <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="NullOrEmpty">
        <maml:name>NoValue</maml:name>
        <maml:description>
          <maml:para>Параметр указывает, что отображаться должны только те свойства объектов, значения которых пусты или равны $null.</maml:para>
          <maml:para>Alias: NullOrEmpty</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>NumbersAs</maml:name>
        <maml:description>
          <maml:para>Отображает числа в виде KB, MB, GB, TB или PB.</maml:para>
          <maml:para>Если число меньше, чем указанная единица измерения, то оно отображается без изменений.</maml:para>
          <maml:para>Параметр отличается от параметра -CompactNumbers в том, что параметр -NumbersAs использует указанные единицы измерения (KB, MB и т. д.), а параметр -CompactNumbers определяет подходящий вариант на основе величины числа.</maml:para>
          <maml:para>Параметр -CompactNumbers имеет приоритет перед этим параметром.</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>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>NumericTypes</maml:name>
        <maml:description>
          <maml:para>Параметр указывает, что отображаться должны только те свойства объектов, значения которых являются числовым типом (Int, Double и т. д.).</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>SymbolicTypes</maml:name>
        <maml:description>
          <maml:para>Параметр указывает, что отображаться должны только те свойства объектов, значения которых являются символьным типом (String, Char).</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>ValueFilter</maml:name>
        <maml:description>
          <maml:para>Задает скриптблок, который будет использоваться для фильтрации свойств по их значениям.</maml:para>
          <maml:para>Например: -ValueFilter {$PSItem -like "somevalue"}</maml:para>
        </maml:description>
        <command:parameterValue required="true" variableLength="false">ScriptBlock</command:parameterValue>
        <dev:type>
          <maml:name>ScriptBlock</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
      <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none">
        <maml:name>TypeNameFilter</maml:name>
        <maml:description>
          <maml:para>Задает скриптблок, который будет использоваться для фильтрации свойств по типам данных.</maml:para>
          <maml:para>Например: -TypeNameFilter {$PSItem -like "datatype"}</maml:para>
        </maml:description>
        <command:parameterValue required="true" variableLength="false">ScriptBlock</command:parameterValue>
        <dev:type>
          <maml:name>ScriptBlock</maml:name>
          <maml:uri />
        </dev:type>
        <dev:defaultValue>None</dev:defaultValue>
      </command:parameter>
    </command:parameters>
    <command:inputTypes>
      <command:inputType>
        <dev:type>
          <maml:name>System.Object</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:inputType>
    </command:inputTypes>
    <command:returnValues>
      <command:returnValue>
        <dev:type>
          <maml:name>System.Object</maml:name>
        </dev:type>
        <maml:description>
          <maml:para></maml:para>
        </maml:description>
      </command:returnValue>
    </command:returnValues>
    <maml:alertSet>
      <maml:alert>
        <maml:para></maml:para>
      </maml:alert>
    </maml:alertSet>
    <command:examples>
      <command:example>
        <maml:title>Example 1: Свойства со значениями, отличными от пустых или $null</maml:title>
        <dev:code>Get-CimInstance -ClassName Win32_NetworkAdapterConfiguration -Filter "Index=10" | ff -HasValue
 
Caption : [00000010] Hyper-V Virtual Switch Extension Adapter
Description : Hyper-V Virtual Switch Extension Adapter
SettingID : {946D7DBF-BE1D-4236-80AC-45892A467346}
DHCPEnabled : False
Index : 10
InterfaceIndex : 9
IPEnabled : False
ServiceName : VMSMP
CimClass : root/cimv2:Win32_NetworkAdapterConfiguration
CimInstanceProperties : {Caption, Description, SettingID, ArpAlwaysSourceRoute…}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties</dev:code>
        <dev:remarks>
          <maml:para>Получение только тех свойств объектов, которые имеют значения, отличные от пустых или $null.</maml:para>
          <maml:para/>
          <maml:para/>
        </dev:remarks>
      </command:example>
      <command:example>
        <maml:title>- Example 2: Свойства, значения которых пусты или равны $null -</maml:title>
        <dev:code>Get-CimInstance -ClassName Win32_NetworkAdapterConfiguration -Filter "Index=10" | ff -NoValue
 
ArpAlwaysSourceRoute :
ArpUseEtherSNAP :
DatabasePath :
DeadGWDetectEnabled :
DefaultIPGateway :
DefaultTOS :
DefaultTTL :
DHCPLeaseExpires :
DHCPLeaseObtained :
DHCPServer :
DNSDomain :
DNSDomainSuffixSearchOrder :
...</dev:code>
        <dev:remarks>
          <maml:para>Получение только тех свойств объектов, значения которых пусты или равны $null.</maml:para>
          <maml:para/>
          <maml:para/>
        </dev:remarks>
      </command:example>
      <command:example>
        <maml:title> Example 3: Свойства, значения которых являются числовым типом </maml:title>
        <dev:code>Get-CimInstance -ClassName Win32_NetworkAdapterConfiguration -Filter "Index=10" | ff -NumericTypes
 
ForwardBufferMemory :
Index : 10
InterfaceIndex : 9
IPConnectionMetric :
IPXMediaType :
KeepAliveInterval :
KeepAliveTime :
MTU :
NumForwardPackets :
TcpipNetbiosOptions :
TcpMaxConnectRetransmissions :
TcpMaxDataRetransmissions :
TcpNumConnections :
TcpWindowSize :</dev:code>
        <dev:remarks>
          <maml:para>Получение только тех свойств объектов, значения которых являются числовым типом (Int, Double и т. д.).</maml:para>
          <maml:para/>
          <maml:para/>
        </dev:remarks>
      </command:example>
      <command:example>
        <maml:title>Example 4: Свойства, значения которых являются символьным типом</maml:title>
        <dev:code>Get-CimInstance -ClassName Win32_NetworkAdapterConfiguration -Filter "Index=10" | ff -SymbolicTypes
 
Caption : [00000010] Hyper-V Virtual Switch Extension Adapter
Description : Hyper-V Virtual Switch Extension Adapter
SettingID : {946D7DBF-BE1D-4236-80AC-45892A467346}
DatabasePath :
DHCPServer :
DNSDomain :
DNSHostName :
IPXAddress :
IPXVirtualNetNumber :
MACAddress :
ServiceName : VMSMP
WINSHostLookupFile :
WINSPrimaryServer :
WINSScopeID :
WINSSecondaryServer :
PSComputerName :</dev:code>
        <dev:remarks>
          <maml:para>Получение только тех свойств объектов, значения которых являются символьным типом (String, Char).</maml:para>
          <maml:para/>
          <maml:para/>
        </dev:remarks>
      </command:example>
      <command:example>
        <maml:title>------ Example 5: Отображение чисел с разделителями групп ------</maml:title>
        <dev:code>Get-CimInstance -ClassName Win32_LogicalDisk -Filter "DeviceID='C:'" | ff -HasValue -NumericTypes -NumberGroupSeparator
 
Access : 0
FreeSpace : 57,692,909,568
Size : 214,223,253,504
DriveType : 3
MaximumComponentLength : 255
MediaType : 12</dev:code>
        <dev:remarks>
          <maml:para>Использование параметра -NumberGroupSeparator для отображения чисел с разделителями групп.</maml:para>
          <maml:para/>
          <maml:para/>
        </dev:remarks>
      </command:example>
      <command:example>
        <maml:title>------------ Example 6: Отображение чисел в виде MB ------------</maml:title>
        <dev:code>Get-CimInstance -ClassName Win32_LogicalDisk -Filter "DeviceID='C:'" | ff -HasValue -NumericTypes -NumberGroupSeparator -NumbersAs MB
 
Access : 0
FreeSpace : 55,018.6 MB
Size : 204,299.21 MB
DriveType : 3
MaximumComponentLength : 255
MediaType : 12</dev:code>
        <dev:remarks>
          <maml:para>Использование параметра -NumbersAs для отображения чисел в виде MB.</maml:para>
          <maml:para/>
          <maml:para/>
        </dev:remarks>
      </command:example>
      <command:example>
        <maml:title>--- Example 7: Отображение чисел в наиболее компактной форме ---</maml:title>
        <dev:code>Get-CimInstance -ClassName Win32_LogicalDisk -Filter "DeviceID='C:'" | ff -HasValue -NumericTypes -CompactNumbers
 
Access : 0
FreeSpace : 53.73 GB
Size : 199.51 GB
DriveType : 3
MaximumComponentLength : 255
MediaType : 12</dev:code>
        <dev:remarks>
          <maml:para>Отображение чисел в их наиболее компактной форме с использованием таких единиц измерения, как KB, MB, GB, TB и PB.</maml:para>
          <maml:para/>
          <maml:para/>
        </dev:remarks>
      </command:example>
      <command:example>
        <maml:title>---------- Example 8: Свойства с заданными значениями ----------</maml:title>
        <dev:code>Get-CimInstance -ClassName Win32_NetworkAdapterConfiguration -Filter "Index=10" | ff -ValueFilter {$PSItem -like "*adapter"}
 
Caption Description
------- -----------
[00000010] Hyper-V Virtual Switch Extension Adapter Hyper-V Virtual Switch Extension Adapter</dev:code>
        <dev:remarks>
          <maml:para>Получение только тех свойств, чьи значения соответствуют условию.</maml:para>
          <maml:para/>
          <maml:para/>
        </dev:remarks>
      </command:example>
      <command:example>
        <maml:title>-------------- Example 9: Свойства заданного типа --------------</maml:title>
        <dev:code>Get-CimInstance -ClassName Win32_NetworkAdapterConfiguration -Filter "Index=10" | ff -HasValue -TypeNameFilter {$PSItem -like "*int"}
 
Index InterfaceIndex
----- --------------
   10 9</dev:code>
        <dev:remarks>
          <maml:para>Получение только тех свойств, чей тип данных соответствует условию.</maml:para>
        </dev:remarks>
      </command:example>
    </command:examples>
    <command:relatedLinks />
  </command:command>
</helpItems>