New-PSDrive
アイテム データ ストア内の場所に関連付けられている一時ドライブと永続ドライブを作成します。
構文
New-PSDrive
[-Name] <String>
[-PSProvider] <String>
[-Root] <String>
[-Description <String>]
[-Scope <String>]
[-Persist]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]説明
コマンドレットは New-PSDrive 、ネットワーク ドライブ、ローカル コンピューター上のディレクトリ、レジストリ キーなど、データ ストア内の場所にマップまたは関連付けられている一時および永続的なドライブ、およびリモート コンピューター上のファイル システムの場所に関連付けられている永続的な Windows マップド ネットワーク ドライブを作成します。
一時ドライブは、現在の PowerShell セッションと、現在のセッションで作成したセッションにのみ存在します。 PowerShell で有効な任意の名前を指定でき、任意のローカル リソースまたはリモート リソースにマップできます。 マップされたネットワーク ドライブと同様に、一時的な PowerShell ドライブを使用して、関連付けられているデータ ストア内のデータにアクセスできます。 を使用してドライブに場所を変更し、 または Get-ChildItemを使用Set-LocationGet-Itemしてドライブの内容にアクセスできます。
一時ドライブは PowerShell でのみ認識されるため、エクスプローラー、Windows Management Instrumentation (WMI)、コンポーネント オブジェクト モデル (COM)、Microsoft .NET Framework、などのnet useツールを使用してアクセスすることはできません。
PowerShell 3.0 では、次の機能が に New-PSDrive 追加されました。
- 割り当て済みのネットワーク ドライブ の Persist パラメーター
New-PSDriveを使用して、Windows マップされたネットワーク ドライブを作成できます。 一時的な PowerShell ドライブとは異なり、Windows マップされたネットワーク ドライブはセッション固有のドライブとは異なります。 これらは Windows に保存され、エクスプローラーやネットユースなどの標準的な Windows ツールを使用して管理できます。 マップ済みネットワーク ドライブは、ドライブ文字名を持ち、リモート ファイル システムの場所に接続されている必要があります。 コマンドのスコープがローカルにあり、ドット ソーシングがない場合、 Persist パラメーターは、コマンドが実行されているスコープを超えて PSDrive の作成を永続化しません。 スクリプト内で実行New-PSDriveしていて、ドライブを無期限に保持する場合は、スクリプトをドット ソースにする必要があります。 最良の結果を得るには、新しいドライブを強制的に無期限に保持するには、 コマンドに Scope パラメーターを追加し、その値を Global に設定します。 ドット ソーシングの詳細については、「 about_Scripts」を参照してください。 - 外部ドライブ。 外部ドライブがコンピューターに接続されると、PowerShell によって、新しいドライブを表す PSDrive がファイル システムに自動的に追加されます。 PowerShell を再起動する必要はありません。 同様に、外部ドライブがコンピューターから切断されると、削除されたドライブを表す PSDrive が PowerShell によって自動的に削除されます。
- 汎用名前付け規則 (UNC) パスの資格情報。
Root パラメーターの値が UNC パス ( など\\Server\Share) の場合、Credential パラメーターの値で指定された資格情報を使用して PSDrive を作成します。 それ以外の 場合、資格情報 は、新しいファイル システム ドライブを作成するときに有効ではありません。
一部のコード サンプルでは、スプラッティングを使用して行の長さを短くし、読みやすさを向上させます。 詳細については、「 about_Splatting」を参照してください。
注意
Scope パラメーターを使用しない限り、PSDrive はコマンドが実行されるNew-PSDriveスコープに作成されます。
例
例 1: ネットワーク共有にマップされた一時ドライブをCreateする
この例では、ネットワーク共有にマップされる一時的な PowerShell ドライブを作成します。
New-PSDrive -Name "Public" -PSProvider "FileSystem" -Root "\\Server01\Public"
Name Provider Root
---- -------- ----
Public FileSystem \\Server01\PublicNew-PSDriveName パラメーターを使用して、 という名前Publicの PowerShell ドライブを指定し、PSProvider パラメーターを使用して PowerShell FileSystem プロバイダーを指定します。 Root パラメーターは、ネットワーク共有の UNC パスを指定します。
PowerShell セッションからコンテンツを表示するには: Get-ChildItem -Path Public:
例 2: ローカル ディレクトリにマップされた一時ドライブをCreateする
この例では、ローカル コンピューター上のディレクトリへのアクセスを提供する一時的な 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\DocumentsSplatting では、パラメーター キーと値が作成されます。 Name パラメーターは、ドライブ名 MyDocs を指定します。 PSProvider パラメーターは、PowerShell FileSystem プロバイダーを指定します。 ルート は、ローカル コンピューターのディレクトリを指定します。 Description パラメーターは、ドライブの目的を説明します。 New-PSDrive では、splatted パラメーターを使用してドライブを MyDocs 作成します。
PowerShell セッションからコンテンツを表示するには: Get-ChildItem -Path MyDocs:
例 3: レジストリ キーの一時ドライブをCreateする
この例では、レジストリ キーへのアクセスを提供する一時的な PowerShell ドライブを作成します。 レジストリ キーにマップされる MyCompany という名前のドライブが HKLM:\Software\MyCompany 作成されます。
New-PSDrive -Name "MyCompany" -PSProvider "Registry" -Root "HKLM:\Software\MyCompany"
Name Provider Root
---- -------- ----
MyCompany Registry HKLM:\Software\MyCompanyNew-PSDriveName パラメーターを使用して、 という名前MyCompanyの PowerShell ドライブを指定し、PSProvider パラメーターを使用して PowerShell Registry プロバイダーを指定します。 Root パラメーターは、レジストリの場所を指定します。
PowerShell セッションからコンテンツを表示するには: Get-ChildItem -Path MyCompany:
例 4: 資格情報を使用して永続的なマップされたネットワーク ドライブをCreateする
この例では、ドメイン サービス アカウントの資格情報で認証されたネットワーク ドライブをマップします。 資格情報を格納する 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注意
スクリプトで上記のスニペットを使用する場合は、ドライブが現在のスコープ外に保持されるように 、Scope パラメーターの値を "Global" に設定します。
変数には $cred 、サービス アカウントの資格情報を含む PSCredential オブジェクトが格納されます。 Get-CredentialSecureString に格納されているパスワードを入力するように求められます。
New-PSDrive では、複数のパラメーターを使用してマップされたネットワーク ドライブが作成されます。 Name は、Windows が S 受け入れるドライブ文字を指定します。 と Root は、 \\Server01\Scripts リモート コンピューター上の場所として定義されます。 Persist を使用すると、ローカル コンピューターに保存される Windows マップされたネットワーク ドライブが作成されます。 PSProvider は プロバイダーを FileSystem 指定します。 Credential では、 変数を $cred 使用して、認証用のサービス アカウントの資格情報を取得します。
マップされたドライブは、PowerShell セッション、エクスプローラー、および net use などのツールを使用して、ローカル コンピューターで表示できます。 PowerShell セッションからコンテンツを表示するには: Get-ChildItem -Path S:
例 5: 永続ドライブと一時ドライブをCreateする
この例では、永続的なマップされたネットワーク ドライブと、同じネットワーク共有にマップされる一時的な 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: スクリプトで永続ドライブをCreateする
PSDrive は、コマンドが実行されるスコープに New-PSDrive 作成されます。 コマンドがスクリプト内で実行されると、ドライブマッピングはスクリプトに対してローカルになります。 スクリプトが終了すると、ドライブは使用できなくなります。
New-PSDrive -Persist -Name "X" -PSProvider "FileSystem" -Root "\\Server01\Public" -Scope Globalスクリプトの外部でドライブを使用できるようにするには、 Scope パラメーターを使用して グローバル スコープにドライブを作成する必要があります。
パラメーター
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
このアクションを実行するアクセス許可を持つユーザー アカウントを指定します。 既定値は現在のユーザーです。
PowerShell 3.0 以降では、 Root パラメーターの値が UNC パスの場合、資格情報を使用してファイル システム ドライブを作成できます。
User01 や Domain01\User01 などのユーザー名を入力するか、コマンドレットによって生成された PSCredential オブジェクトをGet-Credential入力します。 ユーザー名を入力すると、パスワードの入力を求められます。
資格情報は PSCredential オブジェクトに格納され、パスワードは SecureString として格納されます。
注意
SecureString データ保護の詳細については、SecureString のセキュリティ保護に関するページを参照してください。
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Description
ドライブの簡単な説明テキストを指定します。 任意の文字列を入力します。
すべてのセッションのドライブの説明を表示するには、 Get-PSDrive | Format-Table Name, Descriptionを参照してください。
特定のドライブの説明を表示するには、「」と入力します (Get-PSDrive <DriveName>).Description。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
新しいドライブの名前を指定します。 永続的なマップされたネットワーク ドライブの場合は、ドライブ文字を使用します。 一時的な PowerShell ドライブの場合は、ドライブ文字に限定されず、有効な文字列を使用します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Persist
このコマンドレットによって、Windows マップされたネットワーク ドライブが作成されることを示します。 Persist パラメーターは、Windows でのみ使用できます。
マップ済みネットワーク ドライブは、ローカル コンピューターの Windows に保存されます。 これらはセッション固有ではなく永続的であり、エクスプローラーやその他のツールで表示および管理できます。
ドット ソーシングを使用せずにコマンドのスコープをローカルに設定した場合、 Persist パラメーターは、コマンドを実行するスコープを超えて PSDrive の作成を永続化しません。 スクリプト内でを実行 New-PSDrive し、新しいドライブを無期限に保持する場合は、スクリプトをドット ソースにする必要があります。 最良の結果を得るには、新しいドライブを強制的に永続化するには、Scope パラメーターの値として Global を指定し、コマンドに Persist を含めます。
ドライブの名前は、 や EなどのD文字である必要があります。 Root パラメーターの値は、別のコンピューターの UNC パスである必要があります。 PSProvider パラメーターの値は であるFileSystem必要があります。
Windows マップ済みネットワーク ドライブを切断するには、Remove-PSDrive コマンドレットを使用します。 Windows マップ済みネットワーク ドライブを切断すると、マッピングは現在のセッションから削除されるだけでなく、コンピューターから完全に削除されます。
マップ済みネットワーク ドライブは、ユーザー アカウントに固有です。 別のユーザーの資格情報を使用して管理者特権のセッションまたはセッションで作成されたマップされたドライブは、異なる資格情報を使用して開始されたセッションには表示されません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PSProvider
この種類のドライブをサポートする PowerShell プロバイダーを指定します。
たとえば、ドライブがネットワーク共有またはファイル システム ディレクトリに関連付けられている場合、PowerShell プロバイダーは になります FileSystem。 ドライブがレジストリ キーに関連付けられている場合、プロバイダーは です Registry。
一時的な PowerShell ドライブは、任意の PowerShell プロバイダーに関連付けることができます。 マップされたネットワーク ドライブは、プロバイダーにのみ関連付 FileSystem けることができます。
PowerShell セッションでプロバイダーの一覧を表示するには、 コマンドレットを Get-PSProvider 使用します。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Root
PowerShell ドライブのマップ先となるデータ ストアの場所を指定します。
たとえば、 などの \\Server01\Publicネットワーク共有、などのローカル ディレクトリ、 C:\Program Filesレジストリ キー (など HKLM:\Software\Microsoft) を指定します。
一時的な PowerShell ドライブは、サポートされている任意のプロバイダー ドライブ上のローカルまたはリモートの場所に関連付けることができます。 マップ済みネットワーク ドライブは、リモート コンピューター上のファイル システムの場所だけに関連付けることができます。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Scope
ドライブのスコープを指定します。 このパラメーターに使用できる値は、 Global、 Local、 Script、または現在のスコープに対する相対的な数値です。 スコープの数は 0 からスコープの数です。 現在のスコープ番号は 0 で、その親は 1 です。 詳細については、「 about_Scopes」を参照してください。
| Type: | String |
| Position: | Named |
| Default value: | Local |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
None
このコマンドレットへの入力をパイプライン処理することはできません。
出力
メモ
New-PSDrive は、任意のプロバイダーによって公開されるデータを操作するように設計されています。 セッションで使用できるプロバイダーを一覧表示するには、 を使用 Get-PSProviderします。 プロバイダーの詳細については、「 about_Providers」を参照してください。
マップ済みネットワーク ドライブは、ユーザー アカウントに固有です。 別のユーザーの資格情報を使用して管理者特権のセッションまたはセッションで作成されたマップされたドライブは、異なる資格情報を使用して開始されたセッションには表示されません。