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

[玩转系统] New-Alias (Microsoft.PowerShell.Utility)

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

New-Alias (Microsoft.PowerShell.Utility)

New-Alias

模块 ：Microsoft.PowerShell.Utility

创建一个新别名。

句法

New-Alias
   [-Name] <String>
   [-Value] <String>
   [-Description <String>]
   [-Option <ScopedItemOptions>]
   [-PassThru]
   [-Scope <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

描述

New-Alias cmdlet 在当前 PowerShell 会话中创建新别名。退出会话或关闭 PowerShell 后，不会保存使用 New-Alias 创建的别名。您可以使用 Export-Alias cmdlet 将别名信息保存到文件中。您稍后可以使用 Import-Alias 检索已保存的别名信息。

示例

示例 1：为 cmdlet 创建别名

New-Alias -Name "List" Get-ChildItem

此命令创建一个名为 List 的别名来表示 Get-ChildItem cmdlet。

示例 2：为 cmdlet 创建只读别名

此命令创建一个名为 C 的别名来表示 Get-ChildItem cmdlet。它为别名创建“快速 gci 别名”的描述并使其只读。

New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *

HelpUri             : https://go.microsoft.com/fwlink/?LinkID=2096492
ResolvedCommandName : Get-ChildItem
DisplayName         : C -> Get-ChildItem
ReferencedCommand   : Get-ChildItem
ResolvedCommand     : Get-ChildItem
Definition          : Get-ChildItem
Options             : ReadOnly
Description         : quick gci alias
OutputType          : {System.IO.FileInfo, System.IO.DirectoryInfo}
Name                : C
CommandType         : Alias
Source              :
Version             :
Visibility          : Public
ModuleName          :
Module              :
RemotingCapability  : PowerShell
Parameters          : {[Path, System.Management.Automation.ParameterMetadata], [LiteralPath,
                      System.Management.Automation.ParameterMetadata], [Filter,
                      System.Management.Automation.ParameterMetadata], [Include,
                      System.Management.Automation.ParameterMetadata]…}

通过管道传送到 Format-List 的 Get-Alias 命令显示有关新别名的所有信息。

示例 3：为带参数的命令创建别名

function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory

第一个命令创建函数 Set-ParentDirectory，该函数使用 Set-Location 将工作位置设置为父目录。第二个命令使用 New-Alias 创建 .. 别名来调用 Set-ParentDirectory 函数。由于 Value 参数需要 cmdlet、函数或可执行值，因此您必须创建自定义函数来创建使用参数的别名。运行别名 .. 将当前位置更改为父目录。

参数

-Confirm

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

类型 ：

SwitchParameter

别名：

cf

位置：

命名

默认值：

False

必需的：

False

接受管道输入：

False

接受通配符：

False

-Description

指定别名的描述。您可以输入任何字符串。如果描述包含空格，请将其用引号引起来。

类型 ：

String

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Force

指示如果指定的别名已存在，则 cmdlet 的行为类似于 Set-Alias。

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Name

指定新别名。您可以在别名中使用任何字母数字字符，但第一个字符不能是数字。

类型 ：

String

位置：

0

默认值：

None

必需的：

True

接受管道输入：

True

接受通配符：

False

-Option

指定别名的选项属性的值。有效值为：

  • None：别名没有限制（默认值）
  • ReadOnly：别名可以删除，但不能更改，除非使用Force参数
  • 常量：别名无法删除或更改
  • Private：别名仅在当前范围内可用
  • AllScope：别名被复制到创建的任何新范围
  • 未指定：未指定选项

这些值被定义为基于标志的枚举。您可以使用此参数将多个值组合在一起以设置多个标志。这些值可以作为值数组或这些值的逗号分隔字符串传递给 Option 参数。该 cmdlet 将使用二进制 OR 运算组合这些值。将值作为数组传递是最简单的选项，并且还允许您对值使用制表符补全。

要查看会话中所有别名的 Options 属性，请键入 Get-Alias |格式表-属性名称，选项-自动大小。

类型 ：

范围项选项

接受的值：

无、只读、常量、私有、所有范围、未指定

位置：

命名

默认值：

[System.Management.Automation.ScopedItemOptions]::无

必需的：

False

接受管道输入：

False

接受通配符：

False

-PassThru

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

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Scope

指定新别名的范围。该参数可接受的值为：

    Global
    Local
    Script
  • 相对于当前范围的数字（0 到范围数，其中 0 是当前范围，1 是其父范围）。

    • 本地 是默认值。有关详细信息，请参阅 about_Scopes。

    类型 ：

    String

    位置：

    命名

    默认值：

    None

    必需的：

    False

    接受管道输入：

    False

    接受通配符：

    False

    -Value

    指定要设置别名的 cmdlet 或命令元素的名称。

    类型 ：

    String

    位置：

    1

    默认值：

    None

    必需的：

    True

    接受管道输入：

    True

    接受通配符：

    False

    -WhatIf

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

    类型 ：

    SwitchParameter

    别名：

    wi

    位置：

    命名

    默认值：

    False

    必需的：

    False

    接受管道输入：

    False

    接受通配符：

    False

    输入

    无

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

    输出

    无

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

    别名信息

    当您使用 PassThru 参数时，此 cmdlet 将返回表示新别名的 AliasInfo 对象。

    笔记

    PowerShell 包含以下 New-Alias 别名：

    • 所有平台：

        nal

    • 要创建新别名，请使用Set-Alias 或New-Alias。要更改别名，请使用Set-Alias。要删除别名，请使用Remove-Alias。

      • 猜你还喜欢

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

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

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

        关灯