Aracılığıyla paylaş

Remove-Variable

Modül:
Microsoft.PowerShell.Utility Module

Bir değişkeni ve değerini siler.

Sözdizimi

Default EnterprisePublishing 

Remove-Variable
    [-Name] <String[]>
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-Scope <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Remove-Variable cmdlet'i, geçerli oturum gibi bir değişkeni ve değerini tanımlandığı kapsamdan siler. Sabit olarak ayarlanan değişkenleri veya sisteme ait olan değişkenleri silmek için bu cmdlet'i kullanamazsınız.

Örnekler

Örnek 1: Değişkeni kaldırma

Remove-Variable Smp

Bu komut $Smp değişkenini siler.

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

-Exclude

Bu cmdlet'in işlemden atlayan öğe dizisini belirtir. Bu parametrenin değeri, Adı parametresini niteler. "s*" gibi bir ad öğesi veya desen 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

Cmdlet'in salt okunur olsa bile değişkeni kaldırdığını gösterir. Force parametresi kullanıldığında bile, cmdlet sabiti kaldıramaz.

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

-Include

Bu cmdlet'in işlemde sileceği öğe dizisini belirtir. Bu parametrenin değeri, Adı parametresini niteler. s* gibi bir ad öğesi veya desen 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

Kaldırılacak değişkenin adını belirtir. Parametre adı (Ad) isteğe bağlıdır. Joker karakterlere izin verilir

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:True
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

-Scope

Yalnızca belirtilen kapsamdaki değişkenleri alır. Bu parametre için kabul edilebilir değerler şunlardır:

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

Yerel varsayılandı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

-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

PSVariable

Bir değişken nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

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

  • Tüm platformlar:

    • rv

  • Değişiklikler yalnızca oturum gibi geçerli kapsamı etkiler. Bir değişkeni tüm oturumlardan silmek için PowerShell profilinize bir Remove-Variable komutu ekleyin.