Set-Variable

Modül:

Microsoft.PowerShell.Utility Module

Bir değişkenin değerini ayarlar. İstenen ada sahip bir değişken yoksa değişkenini oluşturur.

Sözdizimi

Default EnterprisePublishing

Set-Variable
    [-Name] <String[]>
    [[-Value] <Object>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Description <String>]
    [-Option <ScopedItemOptions>]
    [-Force]
    [-Visibility <SessionStateEntryVisibility>]
    [-PassThru]
    [-Scope <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Set-Variable cmdlet'i belirtilen değişkene bir değer atar veya geçerli değeri değiştirir. Değişken yoksa, cmdlet bunu oluşturur.

Örnekler

Örnek 1: Değişken ayarlama ve değerini alma

Bu komutlar $desc değişkeninin değerini A descriptionolarak ayarlar ve değişkenin değerini alır.

Set-Variable -Name "desc" -Value "A description"
Get-Variable -Name "desc"

Name                           Value
----                           -----
desc                           A description

Örnek 2: Genel, salt okunur değişken ayarlama

Bu örnek, sistemdeki tüm işlemleri içeren genel, salt okunur bir değişken oluşturur ve ardından değişkenin tüm özelliklerini görüntüler.

Set-Variable -Name "processes" -Value (Get-Process) -Option Constant -Scope Global -Description "All processes" -PassThru |
    Format-List -Property *

komutu, değişkeni oluşturmak için Set-Variable cmdlet'ini kullanır. Yeni değişkeni temsil eden bir nesne oluşturmak için PassThru parametresini kullanır ve nesneyi | cmdlet'ine geçirmek için işlem hattı işlecini (Format-List) kullanır. Yeni oluşturulan değişkenin tüm özelliklerini görüntülemek için tümü () değeriyle Format-List* parametresini kullanır.

(Get-Process)değeri, değişkende depolanmadan önce yürütülmesini sağlamak için parantez içine alınır. Aksi takdirde, değişkeni Get-Processsözcüklerini içerir.

Örnek 3: Genel ve özel değişkenleri anlama

Bu örnekte bir değişkenin görünürlüğünü Privateolarak değiştirme gösterilmektedir. Bu değişken, gerekli izinlere sahip betikler tarafından okunabilir ve değiştirilebilir, ancak kullanıcı tarafından görülemez.

New-Variable -Name "counter" -Visibility Public -Value 26
$Counter

26

Get-Variable c*

Name                  Value
----                  -----
Culture               en-US
ConsoleFileName
ConfirmPreference     High
CommandLineParameters {}
Counter               26

Set-Variable -Name "counter" -Visibility Private
Get-Variable c*

Name                  Value
----                  -----
Culture               en-US
ConsoleFileName
ConfirmPreference     High
CommandLineParameters {}

$counter

"Cannot access the variable '$counter' because it is a private variable"

.\use-counter.ps1
#Commands completed successfully.

Bu komut, bir değişkenin görünürlüğünü Özel olarak değiştirme işlemini gösterir. Bu değişken, gerekli izinlere sahip betikler tarafından okunabilir ve değiştirilebilir, ancak kullanıcı tarafından görülemez.

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

-Exclude

Bu cmdlet'in işlemden hariç tutulduğu bir öğe dizisini belirtir. Bu parametrenin değeri, Path parametresini niteler. *.txtgibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
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

Var olan bir salt okunur değişkenle aynı ada sahip bir değişken oluşturmanıza veya salt okunur değişkenin değerini değiştirmenize olanak tanır.

Varsayılan olarak, değişkenin ReadOnly veya Constantseç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:	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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Include

Bu cmdlet'in işleme dahil olduğu bir öğe dizisini belirtir. Bu parametrenin değeri, Adı parametresini niteler. c*gibi bir ad veya ad deseni girin. Joker karakterlere izin verilir.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
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

Değişken adını 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.

Geçerli değerler şunlardır:

• None: Seçenek belirlemez. (None varsayılandır.)
• ReadOnly: Silinebilir. Force parametresinin kullanılması dışında değiştirilemez.
• 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.
• Private: Değişken yalnızca geçerli kapsamda kullanılabilir.
• AllScope: Değişken, oluşturulan tüm yeni kapsamlara kopyalanır.

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.

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

Yeni değişkeni 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:	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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Scope

Değişkenin kapsamını belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

• Global
• Local
• Script
• Private
• Geçerli kapsama göre bir sayı (0, 0'ın geçerli kapsam ve 1'in onun üst kapsamı olduğu kapsam sayısı üzerinden).

Local varsayılan değerdir.

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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Value

Değişkenin 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.

Geçerli değerler şunlardır:

• Public: Değişken görünür durumdadır. (Public varsayılandır.)
• 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 Değişkeni: 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:	Public
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

Değişkenin değerini temsil eden bir nesneyi bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

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

PSVariable

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

Notlar

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

• Tüm platformlar:
  • set
  • sv

İlişkili Bağlantılar

• Temizle-Değişken
• Get-Variable
• Yeni-Değişken
• Değişkeni Kaldır