New-Variable
Yeni bir değişken oluşturur.
Syntax
Default (Varsayılan)
New-Variable
[-Name] <String>
[[-Value] <Object>]
[-Description <String>]
[-Option <ScopedItemOptions>]
[-Visibility <SessionStateEntryVisibility>]
[-Force]
[-PassThru]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-Variable cmdlet'i 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.
Değişkenin özelliklerini ayarlamak, bir değişkenin kapsamını ayarlamak ve değişkenlerin genel mi yoksa özel mi olduğunu belirlemek için New-Variable parametrelerini kullanabilirsiniz.
Genellikle, değişken adını ve değerini yazarak yeni bir değişken oluşturursunuz, örneğin
Örnekler
Örnek 1: Değişken oluşturma
PS C:\> New-Variable days
Bu komut days adlı yeni bir değişken oluşturur. Adı parametresini yazmanız gerekmez.
Örnek 2: Değişken oluşturma ve değer atama
PS C:\> 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 üzerine yazılmasını korumak için New-Variable
İlk komut Max adlı yeni bir değişken oluşturur ve değerini 256 olarak ayarlar. ReadOnly değeriyle Option parametresini 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: Özel değişken oluşturma
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
...
Bu komut bir modüldeki özel değişkenin davranışını gösterir. Modülü, Counter adlı özel değişkeni olan Get-Counter cmdlet'ini içerir. Komutu, değişkeni oluşturmak için Private değeriyle Görünürlük parametresini kullanır.
Ö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 5: Boşlukla değişken oluşturma
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
Bu komut, boşluklu değişkenlerin oluşturulabileceğini gösterir. Değişkenlere Get-Variable cmdlet'i kullanılarak veya bir değişken küme ayraçları ile sınırlandırılarak doğrudan erişilebilir.
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 |
-Description
Değişkenin açıklamasını belirtir.
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: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 ReadOnly veya Constant seçenek değeri olmadığı sürece değişkenin üzerine yazabilirsiniz. Daha fazla bilgi için Option parametresine bakın.
Parametre özellikleri
| Tür: | SwitchParameter |
| 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: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Name
Yeni değişken için bir ad belirtir.
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 |
-Option
Değişkenin Options özelliğinin değerini belirtir. Bu parametre için kabul edilebilir değerler şunlardır:
- Yok. Seçenek belirlemez. (Hiçbiri varsayılandır.)
- ReadOnly. Silinebilir. Zorla parametresinin kullanılması dışında değiştirilemez.
- Özel. değişkeni yalnızca geçerli kapsamda kullanılabilir.
- Tüm Kapsam. Değişken, oluşturulan tüm yeni kapsamlara kopyalanır.
- Sabit. Silinemez veya değiştirilemez. Sabit yalnızca değişken oluştururken geçerlidir. Var olan bir değişkenin seçeneklerini Sabit olarak değiştiremezsiniz.
Oturumdaki tüm değişkenlerin Seçenekleri özelliğini görmek için Get-Variable | Format-Table -Property name, options -autosizeyazın.
Parametre özellikleri
| Tür: | ScopedItemOptions |
| Default value: | None |
| Kabul edilen değerler: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
| 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: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| 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: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Scope
Yeni değişkenin kapsamını belirtir. Bu parametre için kabul edilebilir değerler şunlardır:
- Küresel. Genel kapsamda oluşturulan değişkenlere PowerShell işleminin her yerinde erişilebilir.
- Yerel. Yerel kapsam geçerli kapsama başvurur; bağlama bağlı olarak herhangi bir kapsam olabilir.
- Betik. Betik kapsamında oluşturulan değişkenlere yalnızca oluşturuldukları betik dosyası veya modül içinde erişilebilir.
- Özel. Özel kapsamda oluşturulan değişkenlere, bulundukları kapsamın dışında erişilemez. Başka bir kapsamda aynı ada sahip bir öğenin özel sürümünü oluşturmak için özel kapsamı kullanabilirsiniz.
- 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.
Kapsam parametresi belirtilmediğinde yerel varsayılan kapsamdır.
Daha fazla bilgi için bkz. about_Scopes.
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: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Value
Değişkenin ilk değerini belirtir.
Parametre özellikleri
| Tür: | Object |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | True |
| Ö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 |
-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 parametre için kabul edilebilir değerler şunlardır:
- Ortak. Değişken görünür durumdadır. (Genel varsayılandır.)
- Özel. Değişken görünür değil.
Bir değişken özel olduğunda, Get-Variable tarafından döndürülenler gibi değişken listelerinde veya Değişken: sürücüsünün ekranlarında 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.
Parametre özellikleri
| Tür: | SessionStateEntryVisibility |
| Default value: | None |
| Kabul edilen değerler: | Public, Private |
| 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: | 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ılmaz.
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
Object
Yeni Değişken
Çıkışlar
None or System.Management.Automation.PSVariable
PassThru parametresini kullandığınızda New-Variable, yeni değişkeni temsil eden bir System.Management.Automation.PSVariable nesnesi oluşturur. Aksi takdirde, bu cmdlet herhangi bir çıkış oluşturmaz.