New-PSDrive

リファレンス

モジュール:: Microsoft.PowerShell.Management

アイテムデータストア内の場所に関連付けられている一時ドライブと永続ドライブを作成します。

構文

New-PSDrive
   [-Name] <String>
   [-PSProvider] <String>
   [-Root] <String>
   [-Description <String>]
   [-Scope <String>]
   [-Persist]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-PSDrive コマンドレットは、ネットワークドライブ、ローカルコンピューター上のディレクトリ、レジストリキー、リモートコンピューター上のファイルシステムの場所に関連付けられている永続的な Windows マップドネットワークドライブなど、データストア内の場所にマップまたは関連付けられている一時ドライブと永続ドライブを作成します。

一時ドライブは、現在の PowerShell セッションと、現在のセッションで作成したセッションにのみ存在します。 PowerShell で有効な任意の名前を持ち、任意のローカルリソースまたはリモートリソースにマップできます。マップされたネットワークドライブと同様に、一時的な PowerShell ドライブを使用して、関連付けられているデータストア内のデータにアクセスできます。 Set-Locationを使用してドライブ内の場所を変更し、Get-ItemまたはGet-ChildItemを使用してドライブの内容にアクセスできます。

一時ドライブは PowerShell でのみ認識されるため、エクスプローラー、Windows Management Instrumentation (WMI)、コンポーネントオブジェクトモデル (COM)、Microsoft .NET Framework、または net use などのツールを使用してアクセスすることはできません。

PowerShell 3.0 の New-PSDrive には、次の機能が追加されました。

割り当て済みのネットワークドライブ New-PSDriveの Persist パラメーターを使用して、Windows マップトネットワークドライブを作成できます。一時的な PowerShell ドライブとは異なり、Windows マップされたネットワークドライブはセッション固有ではありません。これらは Windows に保存され、エクスプローラーや net の使用など、標準の Windows ツールを使用して管理できます。マップ済みネットワークドライブは、ドライブ文字名を持ち、リモートファイルシステムの場所に接続されている必要があります。コマンドのスコープがローカルにあり、ドットソーシングがない場合、Persist パラメーターは、コマンドが実行されているスコープを超えてPSDrive の作成を保持しません。スクリプト内で New-PSDrive を実行していて、ドライブを無期限に保持する場合は、スクリプトをドットソースにする必要があります。最適な結果を得るには、新しいドライブを強制的に無期限に保持するには、コマンドに Scope パラメーターを追加し、その値を Global に設定します。ドットソーシングの詳細については、 about_Scriptsを参照してください。
外部ドライブ。外部ドライブがコンピューターに接続されると、PowerShell は新しいドライブを表すファイルシステムに PSDrive を自動的に追加します。 PowerShell を再起動する必要はありません。同様に、外部ドライブがコンピューターから切断されると、削除されたドライブを表す PSDrive が自動的に削除されます。
汎用名前付け規則 (UNC) パスの資格情報。

Root パラメーターの値が \\Server\Share などの UNC パスの場合、Credential パラメーターの値で指定された資格情報を使用して、PSDrive を作成します。それ以外の場合、 Credential は、新しいファイルシステムドライブを作成するときに有効ではありません。

一部のコードサンプルでは、スプラッティングを使用して行の長さを短くし、読みやすさを向上させます。詳細については、「 about_Splatting」を参照してください。

Note

Scope パラメーターを使用しない限り、psDrive は、New-PSDrive コマンドを実行するスコープ内に作成されます。

例

例 1: ネットワーク共有にマップされた一時ドライブを作成する

この例では、ネットワーク共有にマップされる一時的な PowerShell ドライブを作成します。

New-PSDrive -Name "Public" -PSProvider "FileSystem" -Root "\\Server01\Public"

Name       Provider      Root
----       --------      ----
Public     FileSystem    \\Server01\Public

New-PSDrive では、 Name パラメーターを使用して Public という名前の PowerShell ドライブを指定し、 PSProvider パラメーターを使用して PowerShell FileSystem プロバイダーを指定します。 Root パラメーターは、ネットワーク共有の UNC パスを指定します。

PowerShell セッションから内容を表示するには: Get-ChildItem -Path Public:

例 2: ローカルディレクトリにマップされた一時ドライブを作成する

この例では、ローカルコンピューター上のディレクトリへのアクセスを提供する一時的な PowerShell ドライブを作成します。

$parameters = @{
    Name = "MyDocs"
    PSProvider = "FileSystem"
    Root = "C:\Users\User01\Documents"
    Description = "Maps to my My Documents folder."
}
New-PSDrive @parameters

Name        Provider      Root
----        --------      ----
MyDocs      FileSystem    C:\Users\User01\Documents

Splatting によって、パラメーターキーと値が作成されます。 Name パラメーターは、ドライブ名MyDocsを指定します。 PSProvider パラメーターは、PowerShell FileSystem プロバイダーを指定します。 ルート ローカルコンピューターのディレクトリを指定します。 Description パラメーターは、ドライブの目的を表します。 New-PSDrive は、スプラッティングされたパラメーターを使用して MyDocs ドライブを作成します。

PowerShell セッションから内容を表示するには: Get-ChildItem -Path MyDocs:

例 3: レジストリキーの一時ドライブを作成する

この例では、レジストリキーへのアクセスを提供する一時的な PowerShell ドライブを作成します。 HKLM:\Software\MyCompany レジストリキーにマップされた MyCompany という名前のドライブが作成されます。

New-PSDrive -Name "MyCompany" -PSProvider "Registry" -Root "HKLM:\Software\MyCompany"

Name           Provider      Root
----           --------      ----
MyCompany      Registry      HKLM:\Software\MyCompany

New-PSDrive では、 Name パラメーターを使用して MyCompany という名前の PowerShell ドライブを指定し、 PSProvider パラメーターを使用して PowerShell Registry プロバイダーを指定します。 Root パラメーターは、レジストリの場所を指定します。

PowerShell セッションから内容を表示するには: Get-ChildItem -Path MyCompany:

例 4: 資格情報を使用して永続的なマップされたネットワークドライブを作成する

この例では、ドメインサービスアカウントの資格情報で認証されたネットワークドライブをマップします。資格情報を格納する PSCredential オブジェクトと、パスワードを SecureString として格納する方法の詳細については、 Credential パラメーターの説明を参照してください。

$cred = Get-Credential -Credential Contoso\ServiceAccount
New-PSDrive -Name "S" -Root "\\Server01\Scripts" -Persist -PSProvider "FileSystem" -Credential $cred
Net Use

Status       Local     Remote                    Network
---------------------------------------------------------
OK           S:        \\Server01\Scripts        Microsoft Windows Network

Note

スクリプトで上記のスニペットを使用する場合は、 Scope パラメーター値を "Global" に設定して、ドライブが現在のスコープ外に保持されるようにします。

$cred変数には、サービスアカウントの資格情報を含むPSCredential オブジェクトが格納されます。 Get-Credential では、 SecureString に格納されているパスワードを入力するように求められます。

New-PSDrive では、複数のパラメーターを使用してマップされたネットワークドライブが作成されます。名前 Windows が受け入れる S ドライブ文字を指定します。と Root は、リモートコンピューター上の場所として \\Server01\Scripts を定義します。 Persist は、ローカルコンピューターに保存されている Windows マップトネットワークドライブを作成します。 PSProvider FileSystem プロバイダーを指定します。 Credential は、 $cred 変数を使用して認証用のサービスアカウント資格情報を取得します。

マップされたドライブは、PowerShell セッション、エクスプローラー、および net use などのツールを使用して、ローカルコンピューターで表示。 PowerShell セッションから内容を表示するには: Get-ChildItem -Path S:

例 5: 永続ドライブと一時ドライブを作成する

この例では、永続的にマップされたネットワークドライブと、同じネットワーク共有にマップされる一時的な PowerShell ドライブの違いを示します。

PowerShell セッションを閉じてから新しいセッションを開くと、一時的な PSDrive: は使用できませんが、永続的な X: ドライブを使用できます。ネットワークドライブのマップに使用する方法を決定する場合は、ドライブの使用方法を検討してください。たとえば、永続的にする必要があるかどうか、ドライブを他の Windows 機能に表示する必要があるかどうかなどです。

# Create a temporary PowerShell drive called PSDrive:
# that's mapped to the \\Server01\Public network share.
New-PSDrive -Name "PSDrive" -PSProvider "FileSystem" -Root "\\Server01\Public"

# Use the Persist parameter of New-PSDrive to create the X: mapped network drive,
# which is also mapped to the \\Server01\Public network share.
New-PSDrive -Persist -Name "X" -PSProvider "FileSystem" -Root "\\Server01\Public"

# Now, you can use the Get-PSDrive drive cmdlet to examine the two drives.
# The drives appear to be the same, although the network share name appears only
# in the root of the PSDrive: drive.
Get-PSDrive -Name "PSDrive", "X"

Name       Provider      Root
----       --------      ----

PsDrive    FileSystem    \\Server01\public
X          FileSystem    X:\

# Get-Member cmdlet shows that the drives have the same object type,
# System.Management.Automation.PSDriveInfo.
Get-PSDrive "PSDrive", "x" | Get-Member

TypeName: System.Management.Automation.PSDriveInfo

Name                MemberType   Definition
----                ----------   ----------
CompareTo           Method       System.Int32 CompareTo(PSDriveInfo drive),
Equals              Method       System.Boolean Equals(Object obj),
GetHashCode         Method       System.Int32 GetHashCode()
...

# Net Use and Get-CimInstance for the Win32_LogicalDisk class,
# and Win32_NetworkConnection class find only the persistent X: drive.
# PowerShell temporary drives are known only to PowerShell.
Net Use
Get-CimInstance Win32_LogicalDisk | Format-Table -Property DeviceID
Get-CimInstance Win32_NetworkConnection

Status       Local     Remote                    Network
--------------------------------------------------------
OK           X:        \\contoso-pc\data         Microsoft Windows Network

deviceid
--------
C:
D:
X:

LocalName    RemoteName              ConnectionState          Status
---------    ----------              ---------------          ------
X:           \\products\public       Disconnected             Unavailable

例 6: スクリプトに永続ドライブを作成する

PSDrive は、 New-PSDrive コマンドが実行されるスコープ内に作成されます。スクリプト内でコマンドを実行すると、ドライブマッピングはスクリプトに対してローカルになります。スクリプトが終了すると、ドライブは使用できなくなります。

New-PSDrive -Persist -Name "X" -PSProvider "FileSystem" -Root "\\Server01\Public" -Scope Global

スクリプトの外部でドライブを使用できるようにするには、 Scope パラメーターを使用して、 Global スコープにドライブを作成する必要があります。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Credential

このアクションを実行するアクセス許可を持つユーザーアカウントを指定します。既定値は現在のユーザーです。

PowerShell 3.0 以降、 Root パラメーターの値が UNC パスの場合は、資格情報を使用してファイルシステムドライブを作成できます。

User01 や Domain01\User01 などのユーザー名を入力するか、Get-Credential コマンドレットによって生成されたPSCredential オブジェクトを入力します。ユーザー名を入力すると、パスワードの入力を求められます。

資格情報は PSCredential オブジェクトに格納され、パスワードは SecureString として格納されます。

Note

SecureString データ保護の詳細については、「 SecureString のセキュリティ保護方法」を参照してください。

型:	PSCredential
配置:	Named
規定値:	Current user
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Description

ドライブの簡単な説明テキストを指定します。任意の文字列を入力します。

セッションのすべてのドライブの説明を表示するには、 Get-PSDrive | Format-Table Name, Descriptionします。

特定のドライブの説明を表示するには、「 (Get-PSDrive <DriveName>).Description」と入力します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

新しいドライブの名前を指定します。永続的なマップされたネットワークドライブの場合は、ドライブ文字を使用します。一時的な PowerShell ドライブの場合、ドライブ文字に限定されるものではなく、任意の有効な文字列を使用します。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Persist

このコマンドレットによって、Windows マップされたネットワークドライブが作成されることを示します。 Persist パラメーターは Windows でのみ使用できます。

マップ済みネットワークドライブは、ローカルコンピューターの Windows に保存されます。これらはセッション固有ではなく永続的であり、エクスプローラーやその他のツールで表示および管理できます。

ドットソーシングを使用せずにコマンドのスコープをローカルに設定すると、Persist パラメーターは、コマンドを実行するスコープを超えてPSDrive の作成を保持しません。スクリプト内 New-PSDrive 実行し、新しいドライブを無期限に保持する場合は、スクリプトをドットソースにする必要があります。最適な結果を得るには、新しいドライブを強制的に永続化するには、Scope パラメーターの値として Global を指定し、コマンドに Persist を含めます。

ドライブの名前は、 D や Eなどの文字にする必要があります。 Root パラメーターの値は、別のコンピューターの UNC パスである必要があります。 PSProvider パラメーターの値はFileSystemする必要があります。

Windows マップされたネットワークドライブを切断するには、 Remove-PSDrive コマンドレットを使用します。 Windows マップ済みネットワークドライブを切断すると、マッピングは現在のセッションから削除されるだけでなく、コンピューターから完全に削除されます。

マップ済みネットワークドライブは、ユーザーアカウントに固有です。別のユーザーの資格情報を使用して管理者特権のセッションで作成されたマップされたドライブは、別の資格情報を使用して開始されたセッションには表示されません。

型:	SwitchParameter
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-PSProvider

この種類のドライブをサポートする PowerShell プロバイダーを指定します。

たとえば、ドライブがネットワーク共有またはファイルシステムディレクトリに関連付けられている場合、PowerShell プロバイダーは FileSystem。ドライブがレジストリキーに関連付けられている場合、プロバイダーは Registry。

一時 PowerShell ドライブは、任意の PowerShell プロバイダーに関連付けることができます。マップされたネットワークドライブは、 FileSystem プロバイダーにのみ関連付けることができます。

PowerShell セッションでプロバイダーの一覧を表示するには、 Get-PSProvider コマンドレットを使用します。

型:	String
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Root

PowerShell ドライブのマップ先となるデータストアの場所を指定します。

たとえば、 \\Server01\Publicなどのネットワーク共有、 C:\Program Filesなどのローカルディレクトリ、 HKLM:\Software\Microsoftなどのレジストリキーを指定します。

一時 PowerShell ドライブは、サポートされている任意のプロバイダードライブ上のローカルまたはリモートの場所に関連付けることができます。マップ済みネットワークドライブは、リモートコンピューター上のファイルシステムの場所だけに関連付けることができます。

型:	String
配置:	2
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Scope

ドライブのスコープを指定します。このパラメーターに使用できる値は、 Global、 Local、 Script、または現在のスコープを基準とする数値です。スコープの数は 0 からスコープの数です。現在のスコープ番号は 0 で、親は 1 です。詳細については、「 about_Scopes」を参照してください。

型:	String
配置:	Named
規定値:	Local
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None

このコマンドレットにオブジェクトをパイプすることはできません

出力

PSDriveInfo

このコマンドレットは、作成されたドライブを表す PSDriveInfo オブジェクトを返します。

メモ

PowerShell には、 Get-PSDriveの次のエイリアスが含まれています。

すべてのプラットフォーム:
- ndr
Windows:
- mount

New-PSDrive は、任意のプロバイダーによって公開されるデータを操作するように設計されています。セッションで使用可能なプロバイダーを一覧表示するには、 Get-PSProviderを使用します。プロバイダーの詳細については、「 about_Providers」を参照してください。

次の方法で共有

New-PSDrive

構文

説明

例

例 1: ネットワーク共有にマップされた一時ドライブを作成する

例 2: ローカルディレクトリにマップされた一時ドライブを作成する

例 3: レジストリキーの一時ドライブを作成する

例 4: 資格情報を使用して永続的なマップされたネットワークドライブを作成する

例 5: 永続ドライブと一時ドライブを作成する

例 6: スクリプトに永続ドライブを作成する

パラメーター

-Confirm

-Credential

-Description

-Name

-Persist

-PSProvider

-Root

-Scope

-WhatIf

入力

出力

メモ

その他のリソース

次の方法で共有

New-PSDrive

構文

説明

例

例 1: ネットワーク共有にマップされた一時ドライブを作成する

例 2: ローカル ディレクトリにマップされた一時ドライブを作成する

例 3: レジストリ キーの一時ドライブを作成する

例 4: 資格情報を使用して永続的なマップされたネットワーク ドライブを作成する

例 5: 永続ドライブと一時ドライブを作成する

例 6: スクリプトに永続ドライブを作成する

パラメーター

-Confirm

-Credential

-Description

-Name

-Persist

-PSProvider

-Root

-Scope

-WhatIf

入力

出力

メモ

関連リンク

その他のリソース

例 2: ローカルディレクトリにマップされた一時ドライブを作成する

例 3: レジストリキーの一時ドライブを作成する

例 4: 資格情報を使用して永続的なマップされたネットワークドライブを作成する