about_Using

项目
05/09/2024

简短说明

允许指定要在会话中使用的命名空间。

长说明

语句 using 允许指定要在会话中使用的命名空间。添加命名空间可简化 .NET 类和成员的使用，并允许从脚本模块和程序集导入类。

语句 using 必须先于脚本或模块中的任何其他语句。任何未注释的语句都不能位于它前面，包括参数。

语句 using 不得包含任何变量。

语句 using 与变量的范围 using: 修饰符不同。有关详细信息，请参阅 about_Remote_Variables。

命名空间语法

解析 .NET 命名空间中的类型：

using namespace <.NET-namespace>

指定命名空间可以更轻松地按短名称引用类型。

示例 - 为 typename 解析添加命名空间

以下脚本获取“Hello World”字符串的加密哈希。

请注意和 using namespace System.Textusing namespace System.IO 如何简化中 System.Text 和 [Stream] 中System.IO对 [UnicodeEncoding] 的[MemoryStream]引用。

using namespace System.Text
using namespace System.IO

[string]$string = "Hello World"
## Valid values are "SHA1", "SHA256", "SHA384", "SHA512", "MD5"
[string]$algorithm = "SHA256"

[byte[]]$stringBytes = [UnicodeEncoding]::Unicode.GetBytes($string)

[Stream]$memoryStream = [MemoryStream]::new($stringBytes)
$getFileHashSplat = @{
    InputStream = $memoryStream
    Algorithm   = $algorithm
}
$hashFromStream = Get-FileHash @getFileHashSplat
$hashFromStream.Hash.ToString()

模块语法

若要从 PowerShell 模块加载类和枚举，请执行以下操作：

using module <module-name>

的值 <module-name> 可以是模块名称、完整模块规范或模块文件的路径。

当 <module-name> 是路径时，该路径可以是完全限定的，也可以是相对路径。相对路径相对于具有 using 语句的脚本解析。

当 <module-name> 是名称或模块规范时，PowerShell 在 PSModulePath 中 搜索指定的模块。

模块规范是具有以下键的哈希表。

ModuleName - 必填指定模块名称。
GUID - 选指定模块的 GUID。
还需要指定以下三个键中的至少一个。
- ModuleVersion - 指定模块的最低可接受版本。
- MaximumVersion - 指定模块的最大可接受版本。
- RequiredVersion - 指定模块的确切所需版本。这不能与其他版本密钥一起使用。

Import-Module#requires和语句仅导入模块定义的模块函数、别名和变量。不会导入类和枚举。

语句 using module 从根模块导入类和枚举， (ModuleToProcess 脚本模块或二进制模块的) 。它不会一致地导入嵌套模块或以点源到根模块的脚本中定义的类或枚举。定义想要直接在根模块中供模块外部用户使用的类和枚举。

在脚本模块开发期间，通常会更改代码，然后使用 Force 参数加载新版本的模块Import-Module。这仅适用于对根模块中函数的更改。 Import-Module 不会重新加载任何嵌套模块。此外，无法加载任何更新的类或枚举。

若要确保运行最新版本，必须启动新会话。无法在 PowerShell 中定义并使用语句导入 using 的类和枚举进行卸载。

示例 - 从脚本模块加载类

在此示例中，名为 CardGames 的 PowerShell 脚本模块定义了以下类：

幻灯片组
卡片

Import-Module#requires和语句仅导入模块定义的模块函数、别名和变量。不会导入类。命令 using module 导入模块并加载类定义。

using module CardGames

[Deck]$deck = [Deck]::new()
$deck.Shuffle()
[Card[]]$hand1 = $deck.Deal(5)
[Card[]]$hand2 = $deck.Deal(5)
[Card[]]$hand3 = $deck.Deal(5)

程序集语法

以下语法在执行开始时将 .NET 类型从程序集加载到脚本中。必须使用程序集文件的完全限定路径。

using assembly <.NET-assembly-path>

语句 using assembly 类似于使用 Add-Type cmdlet。但是， Add-Type cmdlet 会在执行时 Add-Type 添加类型，而不是在脚本执行开始时添加类型。有关详细信息，请参阅 Add-Type。

示例 - 从程序集加载类型

此示例加载程序集，以便在处理数据时可以使用其类。以下脚本将数据转换为 YAML 格式。

using assembly './YamlDotNet.dll'
using namespace YamlDotNet

$yamlSerializer = [Serialization.Serializer]::new()

$info = [ordered]@{
  Inventory = @(
    @{ Name = 'Apples' ; Count = 1234 }
    @{ Name = 'Bagels' ; Count = 5678 }
  )
  CheckedAt = [datetime]'2023-01-01T01:01:01'
}

$yamlSerializer.Serialize($info)

Inventory:
- Name: Apples
  Count: 1234
- Name: Bagels
  Count: 5678
CheckedAt: 2023-01-01T01:01:01.0000000

通过