New-Variable
Yeni bir değişken oluşturun.
Syntax
New-Variable
[-Name] <String>
[[-Value] <Object>]
[-Description <String>]
[-Option <ScopedItemOptions>]
[-Visibility <SessionStateEntryVisibility>]
[-Force]
[-PassThru]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
cmdlet'i New-Variable
PowerShell'de yeni bir değişken oluşturur. Değişkeni oluştururken değişkene bir değer atayabilir veya oluşturulduktan sonra değeri atayabilir veya değiştirebilirsiniz.
parametresini New-Variable
kullanarak değişkenin özelliklerini ayarlayabilir, bir değişkenin kapsamını ayarlayabilir ve değişkenlerin ortak mı yoksa özel mi olduğunu belirleyebilirsiniz.
Genellikle, değişken adını ve değerini (gibi $Var = 3
) yazarak yeni bir değişken oluşturursunuz, ancak cmdlet'ini kullanarak parametrelerini kullanabilirsiniz New-Variable
.
Örnekler
Örnek 1: Değişken oluşturma
New-Variable days
Bu komut days adlı yeni bir değişken oluşturur. Name parametresini yazmanız gerekmez.
Örnek 2: Değişken oluşturma ve değer atama
New-Variable -Name "zipcode" -Value 98033
Bu komut zipcode adlı bir değişken oluşturur ve 98033 değerini atar.
Örnek 3: ReadOnly seçeneğiyle değişken oluşturma
PS C:\> New-Variable -Name Max -Value 256 -Option ReadOnly
PS C:\> New-Variable -Name max -Value 1024
New-Variable : A variable with name 'max' already exists.
At line:1 char:1
+ New-Variable -Name max -Value 1024
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : ResourceExists: (max:String) [New-Variable], SessionStateException
+ FullyQualifiedErrorId : VariableAlreadyExists,Microsoft.PowerShell.Commands.NewVariableCommand
PS C:\> New-Variable -Name max -Value 1024 -Force
Bu örnekte, bir değişkenin ReadOnly
üzerine yazılmasını korumak için seçeneğinin New-Variable
nasıl kullanılacağı gösterilmektedir.
İlk komut Max adlı yeni bir değişken oluşturur ve değerini 256 olarak ayarlar. Option parametresini değeriyle ReadOnly
kullanır.
İkinci komut, aynı ada sahip ikinci bir değişken oluşturmaya çalışır. Değişkende salt okunur seçeneği ayarlandığından bu komut bir hata döndürür.
Üçüncü komut, değişkendeki salt okunur korumayı geçersiz kılmak için Force parametresini kullanır. Bu durumda, aynı ada sahip yeni bir değişken oluşturma komutu başarılı olur.
Örnek 4: Bir değişkene birden çok seçenek atama
New-Variable -Name 'TestVariable' -Value 'Test Value' -Option AllScope,Constant
Bu örnek bir değişken oluşturur ve ve Constant
seçeneklerini atayarak AllScope
değişkenin geçerli kapsamda kullanılabilir olmasını ve oluşturulan yeni kapsamların değiştirilememesini veya silinememesini sağlar.
Örnek 5: Özel değişken oluşturma
Bu komut bir modüldeki özel değişkenin davranışını gösterir. Modülü, Counter adlı özel değişkeni olan cmdlet'ini içerir Get-Counter
. komutu, değişkenini oluşturmak için Private değeriyle Visibility parametresini kullanır.
PS C:\> New-Variable -Name counter -Visibility Private
#Effect of private variable in a module.
PS C:\> Get-Variable c*
Name Value
---- -----
Culture en-US
ConsoleFileName
ConfirmPreference High
CommandLineParameters {}
PS C:\> $counter
"Cannot access the variable '$counter' because it is a private variable"
At line:1 char:1
+ $counter
+ ~~~~~~~~
+ CategoryInfo : PermissionDenied: (counter:String) [], SessionStateException
+ FullyQualifiedErrorId : VariableIsPrivate
PS C:\> Get-Counter
Name Value
---- -----
Counter1 3.1415
...
Örnek çıktı, özel değişkenin davranışını gösterir. Modülü yükleyen kullanıcı Counter değişkeninin değerini görüntüleyemez veya değiştiremez, ancak Sayaç değişkeni modüldeki komutlar tarafından okunabilir ve değiştirilebilir.
Örnek 6: Boşlukla değişken oluşturma
Bu örnekte boşluklu değişkenlerin oluşturulabileceği gösterilmektedir. Değişkenlere cmdlet kullanılarak Get-Variable
veya bir değişken küme ayraçları ile sınırlandırılarak doğrudan erişilebilir.
PS C:\> New-Variable -Name 'with space' -Value 'abc123xyz'
PS C:\> Get-Variable -Name 'with space'
Name Value
---- -----
with space abc123xyz
PS C:\> ${with space}
abc123xyz
Parametreler
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Değişkenin açıklamasını belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Cmdlet'in var olan bir salt okunur değişkenle aynı ada sahip bir değişken oluşturduğunu gösterir.
Varsayılan olarak, değişkenin veya Constant
seçenek değeri ReadOnly
olmadığı sürece değişkenin üzerine yazabilirsiniz. Daha fazla bilgi için Option parametresine bakın.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Yeni değişken için bir ad belirtir.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Option
Değişkenin Options özelliğinin değerini belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
None
- Seçenek belirlemez.None
varsayılan değerdir.ReadOnly
- Silinebilir. Force parametresinin kullanılması dışında değiştirilemez.Private
- Değişken yalnızca geçerli kapsamda kullanılabilir.AllScope
- Değişken, oluşturulan tüm yeni kapsamlara kopyalanır.Constant
- Silinemez veya değiştirilemez.Constant
yalnızca bir değişken oluştururken geçerlidir. Var olan bir değişkenin seçeneklerini olarakConstant
değiştiremezsiniz.
Bu değerler, bayrak tabanlı bir numaralandırma olarak tanımlanır. Bu parametreyi kullanarak birden çok bayrak ayarlamak için birden çok değeri birlikte birleştirebilirsiniz. Değerler Option parametresine bir değer dizisi veya bu değerlerin virgülle ayrılmış dizesi olarak geçirilebilir. cmdlet'i bir ikili OR işlemi kullanarak değerleri birleştirir. Değerleri dizi olarak geçirmek en basit seçenektir ve değerler üzerinde sekme tamamlama özelliğini kullanmanıza da olanak tanır.
Oturumdaki tüm değişkenlerin Options özelliğini görmek için yazın Get-Variable | Format-Table -Property name, options -AutoSize
.
Type: | ScopedItemOptions |
Accepted values: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Üzerinde çalıştığınız öğeyi temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Yeni değişkenin kapsamını belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
Global
- Genel kapsamda oluşturulan değişkenlere PowerShell işleminin her yerinde erişilebilir.Local
- Yerel kapsam geçerli kapsama başvurur, bağlama bağlı olarak herhangi bir kapsam olabilir.Local
, kapsam parametresi belirtilmediğinde varsayılan kapsamdır.Script
- Betik kapsamında oluşturulan değişkenlere yalnızca oluşturuldukları betik dosyası veya modül içinde erişilebilir.- Geçerli kapsama göre bir sayı (0, 0'ın geçerli kapsam olduğu, 1'in üst, 2'nin üst kapsamın üst öğesi olduğu kapsam sayısına kadar vb.). Negatif sayılar kullanılamaz.
Not
parametresi değerini de kabul eder Private
. Private
aslında bir kapsam değil, değişken için isteğe bağlı bir ayardır. Ancak, değeri bu cmdlet ile kullanmak Private
değişkenin görünürlüğünü değiştirmez. Daha fazla bilgi için bkz . about_Scopes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Değişkenin ilk değerini belirtir.
Type: | Object |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Visibility
Değişkenin oluşturulduğu oturumun dışında görünür olup olmadığını belirler. Bu parametre, diğer kullanıcılara teslim edilecek betiklerde ve komutlarda kullanılmak üzere tasarlanmıştır. Bu parametrenin kabul edilebilir değerleri şunlardır:
Public
- Değişken görünür durumdadır.Public
varsayılan değerdir.Private
- Değişken görünür değil.
Bir değişken özel olduğunda, tarafından döndürülenler Get-Variable
gibi değişken listelerinde veya sürücünün görüntülerinde Variable:
görünmez. Özel değişkenin değerini okumak veya değiştirmek için komutlar hata döndürür. Ancak, komutlar değişkenin tanımlandığı oturumda yazılmışsa, kullanıcı özel değişken kullanan komutları çalıştırabilir.
Type: | SessionStateEntryVisibility |
Accepted values: | Public, Private |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
Herhangi bir nesneyi adresine yöneltebilirsiniz New-Variable
.
Çıkışlar
None
Varsayılan olarak, bu cmdlet çıkış döndürmez.
PassThru parametresini kullandığınızda, bu cmdlet yeni değişkeni temsil eden bir PSVariable nesnesi döndürür.
Notlar
PowerShell için aşağıdaki diğer adları New-Variable
içerir:
- Tüm platformlar:
nv
İlişkili Bağlantılar
PowerShell
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin