次の方法で共有

about_Using

  • [アーティクル]

簡単な説明

セッションで使用される名前空間を指定できます。

長い説明

usingステートメントを使用すると、セッションで使用する名前空間を指定できます。 名前空間を追加すると、.NET クラスとメンバーの使用が簡略化され、スクリプト モジュールとアセンブリからクラスをインポートできます。

ステートメントは using 、スクリプトまたはモジュール内の他のステートメントの前に記述する必要があります。 パラメーターを含め、コメントされていないステートメントの前に記述することはできません。

ステートメントに using 変数を含めてはいけません。

ステートメントを変数のusingusing:スコープ修飾子と混同しないでください。 詳細については、「 about_Remote_Variables」を参照してください。

名前空間の構文

型の解決元となる .NET 名前空間を指定するには:

using namespace <.NET-namespace>

名前空間を指定すると、短い名前で型を簡単に参照できます。

モジュールの構文

PowerShell モジュールからクラスを読み込むには:

using module <module-name>

の <module-name> 値には、モジュール名、完全なモジュール仕様、またはモジュール ファイルへのパスを指定できます。

がパスの場合 <module-name> 、パスは完全修飾または相対パスにすることができます。 相対パスは、using ステートメントを含むスクリプトを基準にして解決されます。

が名前またはモジュールの指定である場合 <module-name> 、PowerShell は PSModulePath で指定されたモジュールを検索します。

モジュール仕様は、次のキーを持つハッシュ テーブルです。

  • ModuleName - 必須 モジュール名を指定します。
  • GUID - オプション モジュールの GUID を指定します。
  • また、次の 3 つのキーのいずれかを指定する 必要 もあります。 これらのキーを一緒に使用することはできません。
    • ModuleVersion - モジュールの最小許容バージョンを指定します。
    • RequiredVersion - モジュールの正確で必要なバージョンを指定します。
    • MaximumVersion - モジュールの許容される最大バージョンを指定します。

ステートメントは using module 、スクリプト モジュールまたはバイナリ モジュールのルート モジュール (ModuleToProcess) からクラスをインポートします。 入れ子になったモジュールで定義されているクラスや、ドット ソース化されたスクリプトで定義されているクラスをモジュールに一貫してインポートすることはありません。 モジュール外のユーザーが使用できるようにするクラスは、ルート モジュールで定義する必要があります。

スクリプト モジュールの開発中は、コードに変更を加え、Force パラメーターを使用してモジュールの新しいバージョンをImport-Module読み込むのが一般的です。 これは、ルート モジュール内の関数に対する変更に対してのみ機能します。 Import-Module では、入れ子になったモジュールは再読み込みされません。 また、更新されたクラスを読み込む方法はありません。

最新バージョンを確実に実行するには、 コマンドレットを使用してモジュールをアンロードする Remove-Module 必要があります。 Remove-Module は、ルート モジュール、入れ子になったすべてのモジュール、およびモジュールで定義されているすべてのクラスを削除します。 その後、 と ステートメントを使用して Import-Module 、モジュールとクラスを using module 再読み込みできます。

アセンブリ構文

.NET アセンブリから型をプリロードするには:

using assembly <.NET-assembly-path>

アセンブリを読み込むと、解析時にそのアセンブリからスクリプトに .NET 型がプリロードされます。 これにより、事前に読み込まれたアセンブリの型を使用する新しい PowerShell クラスを作成できます。

新しい PowerShell クラスを作成しない場合は、代わりに コマンドレットを Add-Type 使用します。 詳細については、「 Add-Type」を参照してください。

例

例 1 - 型名解決用の名前空間を追加する

次のスクリプトは、"Hello World" 文字列の暗号化ハッシュを取得します。

の と using namespace System.IO の System.Text[Stream] への参照[UnicodeEncoding]を 簡略化する方法using namespace System.Textに[MemoryStream]System.IO注意してください。

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)
$hashfromstream = Get-FileHash -InputStream $memorystream `
  -Algorithm $algorithm
$hashfromstream.Hash.ToString()

例 2 - スクリプト モジュールからクラスを読み込む

この例では、次のクラスを定義する CardGames という名前の PowerShell スクリプト モジュールがあります。

  • CardGames.Deck
  • CardGames.Card

Import-Module ステートメントは、 #requires モジュールによって定義されているモジュール関数、エイリアス、および変数のみをインポートします。 クラスはインポートされません。 コマンドは using module モジュールをインポートし、クラス定義も読み込みます。

using module CardGames
using namespace CardGames

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

例 3 - アセンブリからクラスを読み込む

この例では、新しい PowerShell クラスを作成するためにクラスを使用できるように、アセンブリを読み込みます。 次のスクリプトは、 DirectoryContext クラスから派生した新しい PowerShell クラスを作成します。

using assembly 'C:\Program Files\PowerShell\7\System.DirectoryServices.dll'
using namespace System.DirectoryServices.ActiveDirectory

class myDirectoryClass : System.DirectoryServices.ActiveDirectory.DirectoryContext
{

  [DirectoryContext]$domain

  myDirectoryClass([DirectoryContextType]$ctx) : base($ctx)
  {
    $this.domain = [DirectoryContext]::new([DirectoryContextType]$ctx)
  }

}

$myDomain = [myDirectoryClass]::new([DirectoryContextType]::Domain)
$myDomain

domain                                                    Name UserName ContextType
------                                                    ---- -------- -----------
System.DirectoryServices.ActiveDirectory.DirectoryContext                    Domain