登录  |  注册
当前位置：网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] Clear-Variable (Microsoft.PowerShell.Utility)

作者：精品下载站 日期：2024-12-14 02:08:43 浏览：14 分类：玩电脑

Clear-Variable (Microsoft.PowerShell.Utility)

Clear-Variable

模块 ：Microsoft.PowerShell.Utility

删除变量的值。

句法

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

描述

Clear-Variable cmdlet 可删除变量中存储的数据，但不会删除变量。结果，变量的值为 NULL（空）。如果变量具有指定的数据或对象类型，则此 cmdlet 会保留存储在变量中的对象的类型。

示例

示例 1：删除以搜索字符串开头的全局变量的值

Clear-Variable my* -Scope Global

此命令删除名称以 my 开头的全局变量的值。

示例 2：清除子作用域中的变量，但不清除父作用域中的变量

$a=3
&{ Clear-Variable a }
$a

3

这些命令演示清除子作用域中的变量不会清除父作用域中的值。第一个命令将变量 $a 的值设置为 3。第二个命令使用调用运算符 (&) 来运行 Clear-Variable 在新范围内执行命令。该变量在子作用域中被清除（尽管它不存在），但在本地作用域中并未被清除。第三条命令获取$a的值，显示值3不受影响。

示例3：删除指定变量的值

Clear-Variable -Name "Processes"

此命令删除名为 Processes 的变量的值。 cmdlet 完成操作后，名为 Processes 的变量仍然存在，但值为 null。

参数

-Confirm

在运行 cmdlet 之前提示您进行确认。

类型 ：

SwitchParameter

别名：

cf

位置：

命名

默认值：

False

必需的：

False

接受管道输入：

False

接受通配符：

False

-Exclude

指定此 cmdlet 在操作中省略的项目数组。此参数的值限定 Name 参数。输入名称元素或模式，例如“s*”。允许使用通配符。

类型 ：

String[]

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

True

-Force

允许 cmdlet 清除变量，即使它是只读的。即使使用 Force 参数，cmdlet 也无法清除常量。

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Include

指定此 cmdlet 在操作中包含的项目数组。此参数的值限定 Name 参数。输入名称元素或模式，例如“s*”。允许使用通配符。

类型 ：

String[]

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

True

-Name

指定要清除的变量的名称。允许使用通配符。此参数是必需的，但参数名称 Name 是可选的。

类型 ：

String[]

位置：

0

默认值：

None

必需的：

True

接受管道输入：

True

接受通配符：

True

-PassThru

返回一个代表您正在使用的项目的对象。默认情况下，此 cmdlet 不生成任何输出。

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Scope

指定该别名的有效范围。

该参数可接受的值为：

    Global
    Local
    Script

    您还可以使用相对于当前作用域的数字（0 到作用域数量，其中 0 是当前作用域，1 是其父作用域）。本地是默认值。有关详细信息，请参阅 about_Scopes。

    类型 ：

    String

    位置：

    命名

    默认值：

    None

    必需的：

    False

    接受管道输入：

    False

    接受通配符：

    False

    -WhatIf

    显示 cmdlet 运行时会发生什么情况。该 cmdlet 未运行。

    类型 ：

    SwitchParameter

    别名：

    wi

    位置：

    命名

    默认值：

    False

    必需的：

    False

    接受管道输入：

    False

    接受通配符：

    False

    输入

    无

    您无法通过管道将对象传递到此 cmdlet。

    输出

    无

    默认情况下，此 cmdlet 不返回任何输出。

    PS变量

    当您使用 PassThru 参数时，此 cmdlet 将返回一个表示已清除变量的 PSVariable 对象。

    笔记

    PowerShell 包含以下 Clear-Variable 别名：

    • 所有平台：

        clv

    • 要删除变量及其值，请使用 Remove-Variable 或 Remove-Item。

      即使您使用 Force 参数，此 cmdlet 也不会删除设置为常量或系统拥有的变量值。

      如果您要清除的变量不存在，则 cmdlet 不起作用。它不会创建具有空值的变量。

      • 猜你还喜欢

      您需要 登录账户 后才能发表评论

      取消回复欢迎 你 发表评论:

      精品推荐！
      欢迎 访客 登录没有账号？
      • 最新文章
      • 热门文章
      • 热评文章
      最新评论
        热门tag
        友情链接

        关灯