New-PSDrive
Bir öğe veri deposundaki bir konumla ilişkili geçici ve kalıcı sürücüler oluşturur.
Syntax
All
New-PSDrive
[-Name] <String>
[-PSProvider] <String>
[-Root] <String>
[-Description <String>]
[-Scope <String>]
[-Persist]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Description
New-PSDrive cmdlet'i ağ sürücüsü, yerel bilgisayardaki dizin veya kayıt defteri anahtarı gibi bir veri deposundaki bir konuma eşlenen veya bu konumla ilişkilendirilmiş geçici ve kalıcı sürücüler ve uzak bilgisayardaki bir dosya sistemi konumuyla ilişkilendirilmiş kalıcı Windows eşlenmiş ağ sürücüleri oluşturur.
Geçici sürücüler yalnızca geçerli PowerShell oturumunda ve geçerli oturumda oluşturduğunuz oturumlarda bulunur. PowerShell'de geçerli olan herhangi bir ada sahip olabilirler ve herhangi bir yerel veya uzak kaynağa eşlenebilirler. Eşlenen herhangi bir ağ sürücüsünde olduğu gibi, ilişkili veri deposundaki verilere erişmek için geçici PowerShell sürücülerini kullanabilirsiniz.
Set-Locationkullanarak sürücüdeki konumları değiştirebilir ve Get-Item veya Get-ChildItemkullanarak sürücünün içeriğine erişebilirsiniz.
Geçici sürücüler yalnızca PowerShell tarafından bilindiğinden, Dosya Gezgini, Windows Yönetim Araçları (WMI), Bileşen Nesne Modeli (COM), Microsoft .NET Framework veya net usegibi araçlarla bu sürücülere erişemezsiniz.
PowerShell 3.0'da New-PSDrive aşağıdaki özellikler eklendi:
- Eşlenen ağ sürücüleri. windows eşlenmiş ağ sürücüleri oluşturmak için
New-PSDriveparametresini kullanabilirsiniz. Geçici PowerShell sürücülerinin aksine, Windows eşlenen ağ sürücüleri oturuma özgü değildir. Bunlar Windows'a kaydedilir ve Dosya Gezgini ve net usegibi standart Windows araçları kullanılarak yönetilebilir. Eşlenen ağ sürücülerinin bir sürücü harfi adı olmalıdır ve uzak bir dosya sistemi konumuna bağlı olmalıdır. Komutunuzun kapsamı yerel olarak belirlenmişse, nokta kaynağını belirleme olmadığında Kalıcı parametresi, PSDrive oluşturma işlemini komutun çalıştığı kapsamın dışında kalıcı hale getirmiyor.New-PSDrivebir betik içinde çalıştırıyorsanız ve sürücünün süresiz olarak kalıcı olmasını istiyorsanız, betiği noktalı kaynak olarak oluşturmanız gerekir. En iyi sonuçları elde etmek için, yeni bir sürücüyü süresiz olarak kalıcı hale getirmek için Scope parametresini komutunuza ekleyin ve değerini genel olarak ayarlayın. Nokta kaynağını belirleme hakkında daha fazla bilgi için bkz. about_Scripts. - Dış sürücüler. Bilgisayara bir dış sürücü bağlandığında PowerShell, yeni sürücüyü temsil eden dosya sistemine otomatik olarak bir PSDrive ekler. PowerShell'i yeniden başlatmanız gerekmez. Benzer şekilde, bir dış sürücünün bilgisayar bağlantısı kesildiğinde PowerShell, kaldırılan sürücüyü temsil eden PSDrive otomatik olarak siler.
- Evrensel Adlandırma Kuralı (UNC) yolları için kimlik bilgileri.
Kök parametresinin değeri \\Server\Sharegibi bir UNC yolu olduğunda, Kimlik Bilgisi parametresinin değerinde belirtilen kimlik bilgileri PSDriveoluşturmak için kullanılır. Aksi takdirde, Kimlik Bilgisi yeni dosya sistemi sürücüleri oluştururken etkili olmaz.
Bazı kod örnekleri, satır uzunluğunu azaltmak ve okunabilirliği geliştirmek için sıçramayı kullanır. Daha fazla bilgi için bkz. about_Splatting.
Uyarı
Kapsamı parametresini kullanmadığınız sürece, PSDrive'lar New-PSDrive komutunun çalıştırıldığı kapsamda oluşturulur.
Örnekler
Örnek 1: Ağ paylaşımına eşlenmiş geçici bir sürücü oluşturma
Bu örnek, bir ağ paylaşımına eşlenmiş geçici bir PowerShell sürücüsü oluşturur.
New-PSDrive -Name "Public" -PSProvider "FileSystem" -Root "\\Server01\Public"
Name Provider Root
---- -------- ----
Public FileSystem \\Server01\Public
New-PSDrive, adlı PowerShell sürücüsünü belirtmek için Public parametresini ve PowerShell sağlayıcısını belirtmek için FileSystem parametresini kullanır.
Kök parametresi, ağ paylaşımının UNC yolunu belirtir.
PowerShell oturumundaki içeriği görüntülemek için: Get-ChildItem -Path Public:
Örnek 2: Yerel dizine eşlenmiş geçici bir sürücü oluşturma
Bu örnek, yerel bilgisayardaki bir dizine erişim sağlayan geçici bir PowerShell sürücüsü oluşturur.
$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 parametre anahtarlarını ve değerlerini oluşturur.
Adı parametresi, MyDocs sürücü adını belirtir.
PSProvider parametresi PowerShell FileSystem sağlayıcısını belirtir.
Kök yerel bilgisayarın dizinini belirtir.
Açıklaması parametresi sürücünün amacını açıklar.
New-PSDrive, MyDocs sürücüsünü oluşturmak için sıçramış parametreleri kullanır.
PowerShell oturumundaki içeriği görüntülemek için: Get-ChildItem -Path MyDocs:
Örnek 3: Kayıt defteri anahtarı için geçici sürücü oluşturma
Bu örnek, bir kayıt defteri anahtarına erişim sağlayan geçici bir PowerShell sürücüsü oluşturur.
HKLM:\Software\MyCompany kayıt defteri anahtarına eşlenen MyCompany adlı bir sürücü oluşturur.
New-PSDrive -Name "MyCompany" -PSProvider "Registry" -Root "HKLM:\Software\MyCompany"
Name Provider Root
---- -------- ----
MyCompany Registry HKLM:\Software\MyCompany
New-PSDrive, adlı PowerShell sürücüsünü belirtmek için MyCompany parametresini ve PowerShell sağlayıcısını belirtmek için Registry parametresini kullanır.
Kök parametresi kayıt defteri konumunu belirtir.
PowerShell oturumundaki içeriği görüntülemek için: Get-ChildItem -Path MyCompany:
Örnek 4: Kimlik bilgilerini kullanarak kalıcı eşlenmiş bir ağ sürücüsü oluşturma
Bu örnek, bir etki alanı hizmet hesabının kimlik bilgileriyle kimliği doğrulanmış bir ağ sürücüsünü eşler. Kimlik bilgilerini depolayan PSCredential nesnesi ve parolaların SecureStringolarak nasıl depolandığı hakkında daha fazla bilgi için Kimlik Bilgisi parametresinin açıklamasına bakın.
$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
Uyarı
Yukarıdaki kod parçacığını bir betikte kullanırsanız, sürücünün geçerli kapsamın dışında kalmasını sağlamak için Kapsam parametre değerini "Genel" olarak ayarlayın.
$cred değişkeni, hizmet hesabının kimlik bilgilerini içeren bir PSCredential nesnesi depolar.
Get-Credential bir SecureStringiçinde depolanan parolayı girmenizi ister.
New-PSDrive birkaç parametre kullanarak eşlenmiş ağ sürücüsünü oluşturur.
Adı, Windows'un kabul S sürücü harfini belirtir. ve Kök uzak bilgisayardaki konum olarak \\Server01\Scripts tanımlar.
Kalıcı yerel bilgisayara kaydedilmiş bir Windows eşlenmiş ağ sürücüsü oluşturur.
PSProviderFileSystem sağlayıcısını belirtir.
Kimlik Bilgisi, kimlik doğrulaması için hizmet hesabı kimlik bilgilerini almak için $cred değişkenini kullanır.
Eşlenen sürücü PowerShell oturumlarında, Dosya Gezgini'nde ve net use gibi araçlarla yerel bilgisayarda görüntülenebilir. PowerShell oturumundaki içeriği görüntülemek için: Get-ChildItem -Path S:
Örnek 5: Kalıcı ve geçici sürücüler oluşturma
Bu örnek, kalıcı eşlenmiş bir ağ sürücüsü ile aynı ağ paylaşımına eşlenen geçici bir PowerShell sürücüsü arasındaki farkı gösterir.
PowerShell oturumunu kapatıp yeni bir oturum açarsanız geçici PSDrive: kullanılamaz, ancak kalıcı X: sürücüsü kullanılabilir. Ağ sürücülerini eşlemek için hangi yöntemi kullanacağınıza karar verirken sürücüyü nasıl kullanacağınızı göz önünde bulundurun. Örneğin, kalıcı olması gerekip gerekmediği ve sürücünün diğer Windows özelliklerine görünür olması gerekip gerekmediği.
# 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
Örnek 6: Betikte kalıcı sürücü oluşturma
PSDrive'lar, New-PSDrive komutunun çalıştırıldığı kapsamda oluşturulur. Komut bir betik içinde çalıştırıldığında, sürücü eşlemesi betikte yereldir. Betik çıktığında, sürücü artık kullanılamaz.
New-PSDrive -Persist -Name "X" -PSProvider "FileSystem" -Root "\\Server01\Public" -Scope Global
Sürücünün betik dışında kullanılabilir olduğundan emin olmak için Kapsamı parametresini kullanarak sürücüyü Genel kapsamında oluşturmanız gerekir.
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
Bu eylemi yapma izni olan bir kullanıcı hesabı belirtir. Varsayılan değer mevcut kullanıcıdır.
PowerShell 3.0'dan bu yana, Kök parametresinin değeri bir UNC yolu olduğunda, dosya sistemi sürücüleri oluşturmak için kimlik bilgilerini kullanabilirsiniz.
User01 veya Domain01\User01gibi bir kullanıcı adı yazın veya cmdlet'i tarafından oluşturulan Get-Credential nesnesi girin. Bir kullanıcı adı yazarsanız parolayı girmeniz istenir.
Kimlik bilgileri bir PSCredential nesnesinde depolanır ve parola SecureStringolarak depolanır.
Uyarı
SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | Current user |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Description
Sürücünün kısa bir metin açıklamasını belirtir. Herhangi bir dize yazın.
Tüm oturum sürücülerinin açıklamalarını görmek için Get-PSDrive | Format-Table Name, Description.
Belirli bir sürücünün açıklamasını görmek için (Get-PSDrive <DriveName>).Descriptionyazın.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Name
Yeni sürücü için bir ad belirtir. Kalıcı eşlenmiş ağ sürücüleri için bir sürücü harfi kullanın. Geçici PowerShell sürücüleri için sürücü harfleriyle sınırlı değilsiniz, geçerli bir dize kullanın.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Persist
Bu cmdlet'in Windows eşlenmiş bir ağ sürücüsü oluşturduğunu gösterir. Kalıcı parametresi yalnızca Windows'ta kullanılabilir.
Eşlenen ağ sürücüleri yerel bilgisayarda Windows'a kaydedilir. Bunlar oturuma özgü değil kalıcıdır ve Dosya Gezgini'nde ve diğer araçlarda görüntülenebilir ve yönetilebilir.
Komutun kapsamını nokta kaynağını belirlemeden yerel olarak yaptığınızda, Kalıcı parametresi, PSDrive oluşturma işlemini komutu çalıştırdığınız kapsamın dışında kalıcı yapmaz.
New-PSDrive bir betik içinde çalıştırırsanız ve yeni sürücünün süresiz olarak kalıcı olmasını istiyorsanız, betiği noktalı kaynak olarak oluşturmanız gerekir. En iyi sonuçları elde etmek için, yeni bir sürücüyü kalıcı hale getirmek için Kapsamı parametresinin değeri olarak Genel belirtin ve Kalıcı komutuna ekleyin.
Sürücünün adı, D veya Egibi bir harf olmalıdır.
Kök parametresinin değeri farklı bir bilgisayarın UNC yolu olmalıdır.
PSProvider parametresinin değeri FileSystemolmalıdır.
Windows eşlenmiş ağ sürücüsünün bağlantısını kesmek için Remove-PSDrive cmdlet'ini kullanın. Windows eşlenen bir ağ sürücüsünün bağlantısını kestiğiniz zaman, eşleme yalnızca geçerli oturumdan değil bilgisayardan kalıcı olarak silinir.
Eşlenen ağ sürücüleri bir kullanıcı hesabına özeldir. Başka bir kullanıcının kimlik bilgileri kullanılarak yükseltilmiş oturumlarda veya oturumlarda oluşturulan eşlenmiş sürücüler, farklı kimlik bilgileri kullanılarak başlatılan oturumlarda görünmez.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-PSProvider
Bu tür sürücüleri destekleyen PowerShell sağlayıcısını belirtir.
Örneğin, sürücü bir ağ paylaşımı veya dosya sistemi diziniyle ilişkiliyse PowerShell sağlayıcısı FileSystem. Sürücü bir kayıt defteri anahtarıyla ilişkiliyse sağlayıcı Registry.
Geçici PowerShell sürücüleri herhangi bir PowerShell sağlayıcısıyla ilişkilendirilebilir. Eşlenen ağ sürücüleri yalnızca FileSystem sağlayıcısıyla ilişkilendirilebilir.
PowerShell oturumunuzda sağlayıcıların listesini görmek için Get-PSProvider cmdlet'ini kullanın.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Root
PowerShell sürücüsünün eşlendiği veri deposu konumunu belirtir.
Örneğin, \\Server01\Publicgibi bir ağ paylaşımı, C:\Program Filesgibi yerel bir dizin veya HKLM:\Software\Microsoftgibi bir kayıt defteri anahtarı belirtin.
Geçici PowerShell sürücüleri desteklenen herhangi bir sağlayıcı sürücüsündeki yerel veya uzak bir konumla ilişkilendirilebilir. Eşlenen ağ sürücüleri yalnızca uzak bilgisayardaki bir dosya sistemi konumuyla ilişkilendirilebilir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 2 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Scope
Sürücü için bir kapsam belirtir. Bu parametre için kabul edilebilir değerler şunlardır: Genel, Yerelve Betikveya geçerli kapsama göre bir sayı. Kapsam sayısı üzerinden 0 numaralı kapsamlar. Geçerli kapsam numarası 0 ve üst öğesi 1'dir. Daha fazla bilgi için bkz. about_Scopes.
Parametre özellikleri
| Tür: | String |
| Default value: | Local |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-UseTransaction
Komutunu etkin işleme ekler. Bu parametre yalnızca bir işlem devam ederken geçerlidir. Daha fazla bilgi için bkz. about_Transactions.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | usetx |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz
Çıkışlar
PSDriveInfo
Bu cmdlet, oluşturulan sürücüyü temsil eden bir PSDriveInfo nesnesi döndürür.
Notlar
Windows PowerShell, New-PSDriveiçin aşağıdaki diğer adları içerir:
mountndr
New-PSDrive, herhangi bir sağlayıcı tarafından sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için Get-PSProviderkullanın. Sağlayıcılar hakkında daha fazla bilgi için bkz. about_Providers.
Eşlenen ağ sürücüleri bir kullanıcı hesabına özeldir. Başka bir kullanıcının kimlik bilgileri kullanılarak yükseltilmiş oturumlarda veya oturumlarda oluşturulan eşlenmiş sürücüler, farklı kimlik bilgileri kullanılarak başlatılan oturumlarda görünmez.
