Поделиться через


about_Properties

Краткое описание

Описывает использование свойств объекта в PowerShell.

Подробное описание

PowerShell использует структурированные коллекции данных, называемые объектами, для представления элементов в хранилищах данных или состоянии компьютера. Как правило, вы работаете с объектами, которые являются частью Microsoft платформа .NET Framework, но вы также можете создавать пользовательские объекты в PowerShell.

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

Большинство объектов имеют свойства. Свойства — это данные, связанные с объектом. Различные типы объектов имеют разные свойства. Например, объект FileInfo, представляющий файл, имеет свойство IsReadOnly, содержащее$True, если у файла есть атрибут только для чтения и $False если он отсутствует. Объект DirectoryInfo , представляющий каталог файловой системы, имеет свойство Parent , содержащее путь к родительскому каталогу.

Свойства объекта

Чтобы получить свойства объекта, используйте Get-Member командлет. Например, чтобы получить свойства объекта FileInfo, используйте Get-ChildItem командлет, чтобы получить объект FileInfo, представляющий файл. Затем используйте оператор конвейера (|), чтобы отправить объект FileInfo в Get-Member. Следующая команда получает powershell.exe файл и отправляет его Get-Memberв . Автоматическая $PSHOME переменная содержит путь к каталогу установки PowerShell.

Get-ChildItem $PSHOME\powershell.exe | Get-Member

Выходные данные команды перечисляют члены объекта FileInfo . К элементам относятся свойства и методы. При работе в PowerShell у вас есть доступ ко всем членам объектов.

Чтобы получить только свойства объекта, а не методы, используйте параметр Get-Member MemberType командлета со значением Property, как показано в следующем примере.

Get-ChildItem $PSHOME\powershell.exe | Get-Member -MemberType Property
TypeName: System.IO.FileInfo

Name              MemberType Definition
----              ---------- ----------
Attributes        Property   System.IO.FileAttributes Attributes {get;set;}
CreationTime      Property   System.DateTime CreationTime {get;set;}
CreationTimeUtc   Property   System.DateTime CreationTimeUtc {get;set;}
Directory         Property   System.IO.DirectoryInfo Directory {get;}
DirectoryName     Property   System.String DirectoryName {get;}
Exists            Property   System.Boolean Exists {get;}
Extension         Property   System.String Extension {get;}
FullName          Property   System.String FullName {get;}
IsReadOnly        Property   System.Boolean IsReadOnly {get;set;}
LastAccessTime    Property   System.DateTime LastAccessTime {get;set;}
LastAccessTimeUtc Property   System.DateTime LastAccessTimeUtc {get;set;}
LastWriteTime     Property   System.DateTime LastWriteTime {get;set;}
LastWriteTimeUtc  Property   System.DateTime LastWriteTimeUtc {get;set;}
Length            Property   System.Int64 Length {get;}
Name              Property   System.String Name {get;}

После поиска свойств их можно использовать в командах PowerShell.

Значения свойств

Несмотря на то, что все объекты определенного типа имеют одинаковые свойства, значения этих свойств описывают конкретный объект. Например, каждый объект FileInfo имеет свойство CreationTime , но значение этого свойства отличается для каждого файла.

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

Например, следующая команда отображает значение свойства powershell.exe CreationTime файла. Команда Get-ChildItem возвращает объект FileInfo , представляющий powershell.exe fileобъект . Команда заключена в скобки, чтобы убедиться, что она выполняется перед доступом к любым свойствам.

(Get-ChildItem $PSHOME\powershell.exe).CreationTime
Saturday, June 5, 2021 7:07:00 AM

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

$a = Get-ChildItem $PSHOME\powershell.exe
$a.CreationTime
Saturday, June 5, 2021 7:07:00 AM

Вы также можете использовать Select-Object командлеты и Format-List командлеты для отображения значений свойств объекта. Select-Object и Format-List каждый из них имеет параметр Property . Параметр Property можно использовать для указания одного или нескольких свойств и их значений. Или можно использовать подстановочный знак (*) для представления всех свойств.

Например, следующая команда отображает значения всех свойств powershell.exe файла.

Get-ChildItem $PSHOME\powershell.exe | Format-List -Property *
PSPath            : Microsoft.PowerShell.Core\FileSystem::C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
PSParentPath      : Microsoft.PowerShell.Core\FileSystem::C:\Windows\System32\WindowsPowerShell\v1.0
PSChildName       : powershell.exe
PSDrive           : C
PSProvider        : Microsoft.PowerShell.Core\FileSystem
PSIsContainer     : False
Mode              : -a----
VersionInfo       : File:             C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
                    InternalName:     POWERSHELL
                    OriginalFilename: PowerShell.EXE.MUI
                    FileVersion:      10.0.22000.1 (WinBuild.160101.0800)
                    FileDescription:  Windows PowerShell
                    Product:          Microsoft? Windows? Operating System
                    ProductVersion:   10.0.22000.1
                    Debug:            False
                    Patched:          False
                    PreRelease:       False
                    PrivateBuild:     False
                    SpecialBuild:     False
                    Language:         English (United States)

BaseName          : powershell
Target            : {C:\Windows\WinSxS\amd64_microsoft-windows-powershell-exe_31bf3856ad364e35_10.0.22000.1_none_bf599c
                    5a06fbb6f4\powershell.exe}
LinkType          : HardLink
Name              : powershell.exe
Length            : 450560
DirectoryName     : C:\Windows\System32\WindowsPowerShell\v1.0
Directory         : C:\Windows\System32\WindowsPowerShell\v1.0
IsReadOnly        : False
Exists            : True
FullName          : C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe
Extension         : .exe
CreationTime      : 6/5/2021 7:07:00 AM
CreationTimeUtc   : 6/5/2021 12:07:00 PM
LastAccessTime    : 7/18/2022 12:16:17 PM
LastAccessTimeUtc : 7/18/2022 5:16:17 PM
LastWriteTime     : 6/5/2021 7:07:00 AM
LastWriteTimeUtc  : 6/5/2021 12:07:00 PM
Attributes        : Archive

Статические свойства

Статические свойства классов .NET можно использовать в PowerShell. Статические свойства являются свойствами класса, в отличие от стандартных свойств, которые являются свойствами объекта.

Чтобы получить статические свойства класса, используйте статический параметр командлета Get-Member . Например, следующая команда получает статические свойства System.DateTime класса.

Get-Date | Get-Member -MemberType Property -Static
TypeName: System.DateTime

Name     MemberType Definition
----     ---------- ----------
MaxValue Property   static datetime MaxValue {get;}
MinValue Property   static datetime MinValue {get;}
Now      Property   datetime Now {get;}
Today    Property   datetime Today {get;}
UtcNow   Property   datetime UtcNow {get;}

Чтобы получить значение статического свойства, используйте следующий синтаксис.

[<ClassName>]::<Property>

Например, следующая команда получает значение статического свойства System.DateTime UTCNow класса.

[System.DateTime]::UtcNow

Перечисление доступа к членам

Начиная с PowerShell 3.0 при использовании оператора доступа к членам (.) для доступа к свойству, которое не существует в коллекции списков, PowerShell автоматически перечисляет элементы в коллекции и возвращает значение свойства для каждого элемента. Дополнительные сведения см. в разделе about_Member-Access_Enumeration.

Примеры

Эта команда возвращает значение свойства DisplayName каждой службы, возвращаемой Get-Service .

(Get-Service).DisplayName
Application Experience
Application Layer Gateway Service
Windows All-User Install Agent
Application Identity
Application Information
...

Все коллекции имеют свойство Count , которое возвращает количество объектов в коллекции.

(Get-Service).Count
176

Начиная с PowerShell 3.0, можно получить свойство Count или Length объектов singleton, которые не являются коллекциями.

(Get-Service Audiosrv).Count
1

Однако некоторые объекты имеют свойство Length . Например, длина строки — это число символов в строке. Свойство Count — это количество экземпляров объекта.

PS> $str = 'string'
PS> $str.Length
6
PS> $str.Count
1

Если свойство существует в отдельных объектах и коллекции, возвращается только свойство коллекции.

$collection = @(
    [pscustomobject]@{length = "foo"}
    [pscustomobject]@{length = "bar"}
)
# PowerShell returns the collection's Length.
$collection.length
2

См. также