New-Variable

Modül:: Microsoft.PowerShell.Utility Module

Yeni bir değişken oluşturur.

Sözdizimi

Default EnterprisePublishing

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.

New-Variable parametrelerini 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 yazarak ($Var = 3gibi) yeni bir değişken oluşturursunuz, ancak parametrelerini kullanmak için New-Variable cmdlet'ini kullanabilirsiniz.

Örnekler

Örnek 1: Değişken oluşturma

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

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 ReadOnlyNew-Variable seçeneğinin nasıl kullanılacağı gösterilmektedir.

İlk komut Max adlı yeni bir değişken oluşturur ve değerini 256 olarak ayarlar. değeriyle ReadOnly 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: 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 AllScope ve Constant seçeneklerini atar; böylece değişken geçerli kapsamda kullanılabilir ve oluşturulan yeni kapsamlar değiştirilemez veya silinemez.

Ö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 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.

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 Get-Variable cmdlet'i kullanılarak veya bir değişkeni küme ayraçlarıyla sınırlandırarak 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.

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 seçenek değeri ReadOnly veya Constantolmadığı 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şkeninin Seçenekleri özelliğinin değerini belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

None - Seçenek belirlemez. None varsayılan değerdir.
ReadOnly - Silinebilir. Zorla 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 değişken oluştururken geçerlidir. Var olan bir değişkenin seçeneklerini Constantolarak 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 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:

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ülden 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.

Uyarı

parametresi Privatedeğerini de kabul eder. Private aslında bir kapsam değil, değişken için isteğe bağlı bir ayardır. Ancak, bu cmdlet ile Private değerinin kullanılması değişkenin görünürlüğünü değiştirmez. 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:

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, Get-Variabletarafından döndürülenler gibi değişken listelerinde veya Variable: 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

herhangi bir nesneyi New-Variable.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

PSVariable

PassThru parametresini kullandığınızda, bu cmdlet yeni değişkeni temsil eden bir PSVariable nesnesi döndürür.

Notlar

PowerShell, New-Variableiçin aşağıdaki diğer adları içerir:

Tüm platformlar:
- nv

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Aracılığıyla paylaş

New-Variable

Sözdizimi

Default EnterprisePublishing

Description

Örnekler

Örnek 1: Değişken oluşturma

Örnek 2: Değişken oluşturma ve değer atama

Örnek 3: ReadOnly seçeneğiyle değişken oluşturma

Örnek 4: Bir değişkene birden çok seçenek atama

Örnek 5: Özel değişken oluşturma

Örnek 6: Boşlukla değişken oluşturma

Parametreler

-Confirm

Parametre özellikleri

Parametre kümeleri

-Description

Parametre özellikleri

Parametre kümeleri

-Force

Parametre özellikleri

Parametre kümeleri

-Name

Parametre özellikleri

Parametre kümeleri

-Option

Parametre özellikleri

Parametre kümeleri

-PassThru

Parametre özellikleri

Parametre kümeleri

-Scope

Parametre özellikleri

Parametre kümeleri

-Value

Parametre özellikleri

Parametre kümeleri

-Visibility

Parametre özellikleri

Parametre kümeleri

-WhatIf

Parametre özellikleri

Parametre kümeleri

CommonParameters

Girişler

Object

Çıkışlar

None

PSVariable

Notlar

İlişkili Bağlantılar

Geri Bildirim