about_Type_Operators

简短说明

描述使用 Microsoft .NET 类型的运算符。

详细说明

布尔类型运算符(-is-isnot)指示对象是否是指定 .NET 类型的实例。 如果类型匹配,则 -is 运算符返回值为 TRUE;否则返回值为 FALSE。 如果类型匹配,则 -isnot 运算符返回 FALSE 的值;否则返回值为 true TRUE

-as 运算符尝试将输入对象转换为指定的 .NET 类型。 如果成功,它将返回转换的对象。 如果失败,则返回 $null。 它不返回错误。

PowerShell 具有以下类型运算符:

  • -is |当输入是指定 .NET 类型的实例时返回 TRUE。

    (Get-Date) -is [datetime]     # Result is True
    
  • -isnot|当输入不是 specified.NET 类型的实例时返回 TRUE。

    (Get-Date) -isnot [datetime]  # Result is False
    
  • -as |将输入转换为指定的 .NET 类型。

    "5/7/07" -as [datetime]       # Result is Monday, May 7, 2007 12:00:00 AM
    

类型运算符的语法如下所示:

<input> <operator> [.NET type]

还可以使用以下语法:

<input> <operator> ".NET type"

.NET 类型可以在方括号或字符串中编写为类型名称,例如 [datetime]"DateTime"System.DateTime。 如果类型不在系统命名空间的根目录中,请指定对象类型的全名。 可以省略“System.”。 例如,若要指定 System.Diagnostics.Process ,请输入 [System.Diagnostics.Process][Diagnostics.Process]"Diagnostics.Process"

类型运算符始终以整体方式对输入对象进行作。 也就是说,如果输入对象是集合,则它是测试的 集合 类型,而不是集合 元素的类型

-is/is/isot 运算符

即使输入是对象的集合,布尔 类型运算符(-is-isnot)始终返回 布尔 值。

如果 <input> 的类型与 .NET 类型 派生 的类型相同,则 -is 运算符返回 $true

例如,DirectoryInfo 类型派生自 FileSystemInfo 类型。 因此,这两个示例都返回 True

PS> (Get-Item /) -is [System.IO.DirectoryInfo]
True
PS> (Get-Item /) -is [System.IO.FileSystemInfo]
True

如果 -is 在比较中实现接口,<input> 运算符还可以匹配接口。 在此示例中,输入是一个数组。 数组实现 System.Collections.IList 接口。

PS> 1, 2 -is [System.Collections.IList]
True

-as 运算符

-as 运算符尝试将输入对象转换为指定的 .NET 类型。 如果成功,它将返回转换的对象。 如果失败,它将返回 $null。 它不返回错误。

如果 <input>.NET 类型派生 的类型,-as传递 返回未更改的输入对象。 例如,DirectoryInfo 类型派生自 FileSystemInfo 类型。 因此,对象类型在以下示例中保持不变:

PS> $fsroot = (Get-Item /) -as [System.IO.FileSystemInfo]
PS> $fsroot.GetType().FullName
System.IO.DirectoryInfo

转换 DateTime 类型区分区域性

与类型转换不同,使用 [datetime] 运算符转换为 -as 类型仅适用于根据当前区域性规则设置格式的字符串。

PS> [cultureinfo]::CurrentCulture = 'fr-FR'
PS> '13/5/20' -as [datetime]

mercredi 13 mai 2020 00:00:00

PS> '05/13/20' -as [datetime]
PS> [datetime]'05/13/20'

mercredi 13 mai 2020 00:00:00

PS> [datetime]'13/05/20'
InvalidArgument: Cannot convert value "13/05/20" to type "System.DateTime".
Error: "String '13/05/20' was not recognized as a valid DateTime."

若要查找对象的 .NET 类型,请使用 Get-Member cmdlet。 或者,将所有对象的 GetType 方法与此方法的 FullName 属性一起使用。 例如,以下语句获取 Get-Culture 命令的返回值的类型:

PS> (Get-Culture).GetType().FullName
System.Globalization.CultureInfo

例子

以下示例显示了类型运算符的一些用法:

PS> 32 -is [float]
False

PS> 32 -is "int"
True

PS> (Get-Date) -is [datetime]
True

PS> "12/31/2007" -is [datetime]
False

PS> "12/31/2007" -is [string]
True

PS> (Get-Process powershell)[0] -is [System.Diagnostics.Process]
True

PS> (Get-Command Get-Member) -is [System.Management.Automation.CmdletInfo]
True

下面的示例显示,当输入是对象的集合时,匹配类型是集合的 .NET 类型,而不是集合中各个对象的类型。

在此示例中,尽管 Get-CultureGet-UICulture cmdlet 都返回 System.Globalization.CultureInfo 对象,但这些对象的集合是 System.Object 数组。

PS> (Get-Culture) -is [System.Globalization.CultureInfo]
True

PS> (Get-UICulture) -is [System.Globalization.CultureInfo]
True

PS> (Get-Culture), (Get-UICulture) -is [System.Globalization.CultureInfo]
False

PS> (Get-Culture), (Get-UICulture) -is [array]
True

PS> (Get-Culture), (Get-UICulture) | foreach {
  $_ -is [System.Globalization.CultureInfo])
}
True
True

PS> (Get-Culture), (Get-UICulture) -is [Object]
True

以下示例演示如何使用 -as 运算符。

PS> "12/31/07" -is [datetime]
False

PS> "12/31/07" -as [datetime]
Monday, December 31, 2007 12:00:00 AM

PS> $date = "12/31/07" -as [datetime]

C:\PS>$a -is [datetime]
True

PS> 1031 -as [System.Globalization.CultureInfo]

LCID      Name      DisplayName
----      ----      -----------
1031      de-DE     German (Germany)

以下示例显示,当 -as 运算符无法将输入对象转换为 .NET 类型时,它将返回 $null

PS> 1031 -as [System.Diagnostics.Process]
PS>

另请参阅