#这是一行注释

<#
这是注释块
123ABC
#>

ls #列出当前目录下的文件和文件夹，是Get-ChildItem的别名

#注意下面语句会产生错误
<#块注释由"#>"结尾#>

PS E:> ./MyScript.ps1

无法加载文件 E:MyScript.ps1，因为在此系统中禁止执行脚本。有关详细信息，请参阅 "get-help about_signing"。
所在位置 行:1 字符: 15
+ .MyScript.ps1 < <<<
    + CategoryInfo          : NotSpecified: (:) [], PSSecurityException
    + FullyQualifiedErrorId : RuntimeException

PS E:> MyScript.ps1

无法将“MyScript.ps1”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括
路径，请确保路径正确，然后重试。
所在位置 行:1 字符: 13
+ MyScript.ps1 < <<<
    + CategoryInfo          : ObjectNotFound: (MyScript.ps1:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

Suggestion [3,General]: 未找到命令 MyScript.ps1，但它确实存在于当前位置。Windows PowerShell 默认情况下不从当前位置加载命令。如果信任此命令，请改为键入 "./MyScript.ps1"。有关更多详细信息，请参阅 "get-h
elp about_Command_Precedence"。

PS E:> '"Hello,World!"' > MyScript.ps1
PS E:> ./MyScript.ps1
Hello,World!

PS E:> @'
>> Get-Date
>> $Env:CommonProgramFiles
>> #Script End
>> "files count"
>> (ls).Count
>> #Script Really End
>>
>> '@ > myscript.ps1
>>
PS E:> .MyScript.ps1

2019年3月27日 18:15:10
C:\Program Files\Common Files
files count
20

PS C:/> ${"I"like $}=5.1
PS C:/> ${"I"like $}
5.1

PS C:/> $num=10
PS C:/> $num.gettype() #不区分大小写

IsPublic IsSerial Name                            BaseType
-------- -------- ----                            --------
True     True     Int32                           System.ValueType

$a=0
$a -eq $null
False
del variable:a
$a -eq $null 
True

#使用char
PS D:/>[char]$c="A"
$c
A
#使用bool
PS D:/>$boolean=$true
$boolean
True

#使用enum
enum fruit
{
	apple
	banana
	cherry
	durian
}
[fruit]$en=[fruit]::apple
$en
apple
$item="cherry"
[fruit]$enu=[fruit]::($item)
$enu
cherry

#这种使用方法是错误的
PS D:/> [fruit]$enum=banana

banana : 无法将“banana”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次。
所在位置 行:1 字符: 12
+ [fruit]$en=banana
+            ~~~~~~
    + CategoryInfo          : ObjectNotFound: (banana:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

#当尝试使用非枚举值进行赋值时
PS D:/> [fruit]$en=[fruit]::peach

由于枚举值无效，无法将 Null 转换为类型“fruit”。请指定以下枚举值之一，然后重试。可能的枚举值为“apple,banana,cherry,durian”。
所在位置 行:1 字符: 1
+ [fruit]$en=[fruit]::peach
+ ~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : MetadataError: (:) [], ArgumentTransformationMetadataException
    + FullyQualifiedErrorId : RuntimeException

PS D:/> "\n 123 `n 123"
<#输出
\n 123
 123
#>

PS D:/>$date=get-date
$date
$date.gettype()
<#输出
2019年3月28日 19:32:30

IsPublic IsSerial Name                            BaseType
-------- -------- ----                            --------
True     True     DateTime                        System.ValueType
#>

[int]$num=123 #正确
[int]$num=ls <#错误
无法将“System.Object[]”类型的“System.Object[]”值转换为“System.Int32”类型。
所在位置 行:1 字符: 1
+ [int]$num=ls
+ ~~~~~~~~~~~~
    + CategoryInfo          : MetadataError: (:) [], ArgumentTransformationMetadataException
    + FullyQualifiedErrorId : RuntimeException
#>

PS D:/test> $s=12.56
PS D:/test> [int]$s
13
PS D:/test> [convert]::ToInt32($s)
13

#加 减 乘 除 取余
+ - * / %
#自增、自减运算符，和C#或C++完全一致
++$i
$i++
$i--
--$i
#且
-and
#并
-or
#非
-not
!
#样例
$true -and $false -or -not 0
!$true
#输出
True
False
#等于 (equal to)
-eq
#不等于 (not equal to)
-nq
#大于 (greater than)
-gt
#大于等于 (greater than or equal to)
-ge
#小于 (less than)
-lt
#小于等于 (less than or equal to)
-le

#对于字符串类型，可以在比较运算符前加i或c表示是否区分大小写,
#i表示对大小写不敏感，c表示敏感，不写默认不敏感
"a" -eq "A"
"a" -ceq "A"
#输出
True
False

#判断变量是否为兼容类型(同一类型或其父类型)，类型格式为 [类型名]
-is
#示例
$a=0
$a -is [int]
$b=1,2,3
$b -is [array]
$a -is [ValueType]
#输出
True
True
True # System.Int32类继承自System.ValueType类，因此int是其父类型ValueType的子类型

if($true -and $true) {
	$a=0
}
elseif($a -eq $b) {
	$a=1
}
else {
	$a=2
}

$a="Beijing"
switch($a) 
{
	"Beijing" {$res="北京"}
	"Shanghai" {$res="上海"}
}

$v=18
switch($v)
{
	{$_ -lt 10} {"小于10"} # $_ 表示当前的传入的变量 直接写的字符串会被输出
	10 {"等于10"}
	{$_ -gt 10} {"小于10"}
}
<#输出
大于10
#>

for($i=0;$i -lt 10;$i++)
{
	Write-Output "Hello"
}

do 
{ 
	$n=Read-Host "请输入数字"
} 
while($n -ne 0)
<#输出
请输入数字: 1
请输入数字: 2
请输入数字: s
请输入数字: 0
#>

$n=1
while($n -lt 6)
{
    if($n -eq 4)
    {
        $n=$n+1
        continue
 
    }
    else
    {
        $n
    }
    $n=$n+1
}
1
2
3
5
$n=1
while($n -lt 6)
{
    if($n -eq 4)
    {
        break
    }
    $n
    $n++
}

PS C:/Powershell> $nums=2,0,1,2
PS C:/Powershell> $nums
2
0
1
2

PS C:/Powershell> $nums=1..5
PS C:/Powershell> $nums
1
2
3
4
5

PS C:/Powershell> $array=1,"2019",([Guid]::NewGuid()),(get-date)
PS C:/Powershell> $array
1
2019

Guid
----
ea5f17c6-c0a2-42ba-9de4-e4d03bebffaf

DisplayHint : DateTime
Date        : 2019/3/29 0:00:00
Day         : 29
DayOfWeek   : Friday
DayOfYear   : 88
Hour        : 23
Kind        : Local
Millisecond : 120
Minute      : 23
Month       : 3
Second      : 39
Ticks       : 636894986191207086
TimeOfDay   : 23:23:39.1207086
Year        : 2019
DateTime    : 2019年3月29日 23:23:39

PS C:/Powershell> $array|foreach{$_.gettype()}
#查看数组各元素类型
IsPublic IsSerial Name                                     BaseType
-------- -------- ----                                     --------
True     True     Int32                                    System.ValueType
True     True     String                                   System.Object
True     True     Guid                                     System.ValueType
True     True     DateTime                                 System.ValueType

PS C:/> $a=1..10
PS C:/> $a
1
2
3
4
5
6
7
8
9
10

$a="A","B","C","D","E"
foreach($n in $a)
{
    $n+" "+$n
}
#输出
A A
B B
C C
D D
E E

PS D:/test> ls | Sort-Object -Descending Name | Select-Object Name,Length,LastWriteTime


    目录: D:/test


Name        Length LastWriteTime
----        ------ -------------
out.txt        523 2019/2/24 22:46:35
lang.json     6415 2019/2/16 23:49:24
anapple.txt     65 2019/3/27 15:13:52
4-3.cpp        136 2017/11/24 12:52:28

$array="A","B","C","D","E"
$array|foreach
{
	$_+"s"
}
#输出
As
Bs
Cs
Ds
Es

PS C:/Powershell> $books="1A","2B","3C"
PS C:/Powershell> $books[0]
1A
PS C:/Powershell> $books[1]
2B
PS C:/Powershell> $books[($book.Count-1)]
3C
PS C:/Powershell> $books[-1]
3C

PS C:/Powershell> $books="A1","B2","C3"
PS C:/Powershell> $books+="D4"
PS C:/Powershell> $books
A1
B2
C3
D4

PS C:/Powershell> $num=1..4
PS C:/Powershell> $num
1
2
3
4
PS C:/Powershell> $num=$num[0..1]+$num[3] #相当于删掉了第三项
PS C:/Powershell> $num
1
2
4

PS C:/Powershell> $chs=@("A","B","C")
PS C:/Powershell> $chsBak=$chs
PS C:/Powershell> $chsBak[1]="H"
PS C:/Powershell> $chs
A
H
C
PS C:/Powershell> $chs.Equals($chsBak)
True
PS C:/Powershell> $chsNew=$chs.Clone()
PS C:/Powershell> $chsNew[1]="Good"
PS C:/Powershell> $chs.Equals($chsNew)
False
PS C:/Powershell> $chs
A
H
C

PS C:/Powershell> [int[]] $nums=@()
PS C:/Powershell> $nums+=2012
PS C:/Powershell> $nums+=12.3
PS C:/Powershell> $nums+="999"
PS C:/Powershell> $nums+="can not convert"
Cannot convert value "can not convert" to type "System.Int32". Error: "Input string was not in a correct format."
At line:1 char:6
+ $nums <<<< +="can not convert"
    + CategoryInfo          : MetadataError: (:) [], ArgumentTransformationMetadataException
    + FullyQualifiedErrorId : RuntimeException

PS C:/Powershell> $IPcfg=ipconfig
PS C:/Powershell> $IPcfg
<#输出

Windows IP 配置


以太网适配器 以太网:

   媒体状态  . . . . . . . . . . . . : 媒体已断开连接
   连接特定的 DNS 后缀 . . . . . . . : lan

无线局域网适配器 本地连接* 1:

   媒体状态  . . . . . . . . . . . . : 媒体已断开连接
   连接特定的 DNS 后缀 . . . . . . . :

无线局域网适配器 本地连接* 2:

   连接特定的 DNS 后缀 . . . . . . . :
   本地链接 IPv6 地址. . . . . . . . : ****
   IPv4 地址 . . . . . . . . . . . . : ****
   子网掩码  . . . . . . . . . . . . : ****
   默认网关. . . . . . . . . . . . . :

以太网适配器 VMware Network Adapter VMnet8:

   连接特定的 DNS 后缀 . . . . . . . :
   本地链接 IPv6 地址. . . . . . . . : fe80::f88d:cd97:5343:9713%16
   IPv4 地址 . . . . . . . . . . . . : ****
   子网掩码  . . . . . . . . . . . . : ****
   默认网关. . . . . . . . . . . . . :

无线局域网适配器 WLAN:

   连接特定的 DNS 后缀 . . . . . . . : ****
   本地链接 IPv6 地址. . . . . . . . : fe80::954:3964:3731:997e%18
   IPv4 地址 . . . . . . . . . . . . : ****
   子网掩码  . . . . . . . . . . . . : ****
   默认网关. . . . . . . . . . . . . : ****
#>
PS C:/Powershell> $IPcfg.Count
37

PS C:/Powershell> $ip=ipconfig
PS C:/Powershell> $ip -is [array]
True
PS C:/Powershell> "abac" -is [array]
False
PS C:/Powershell> $str="字符串"
PS C:/Powershell> $str.ToCharArray() -is [array] #转换为字符数组
True

PS D:/test> $list=ls
PS D:/test> $list


    目录: D:/test


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----       2017/11/24     12:52            136 4-3.cpp
-a----        2019/3/27     15:13             65 anapple.txt


PS D:/test> $list.gettype()

IsPublic IsSerial Name                                     BaseType
-------- -------- ----                                     --------
True     True     Object[]                                 System.Array


PS D:/test> foreach($i in $list){$i.name}
4-3.cpp
anapple.txt

PS D:/test> $list[0].gettype()

IsPublic IsSerial Name                                     BaseType
-------- -------- ----                                     --------
True     True     FileInfo                                 System.IO.FileSystemInfo

PS D:/test> $list[0]|fl * 
# "|"符号是管道符，将左边返回结果做参数发送到右侧，fl是Format-List的简称

PSPath            : Microsoft.PowerShell.Core\FileSystem::D:test\4-3.cpp
PSParentPath      : Microsoft.PowerShell.Core\FileSystem::D:\test
PSChildName       : 4-3.cpp
PSDrive           : D
PSProvider        : Microsoft.PowerShell.Core\FileSystem
PSIsContainer     : False
Mode              : -a----
VersionInfo       : File:             D:\test\4-3.cpp
                    InternalName:
                    OriginalFilename:
                    FileVersion:
                    FileDescription:
                    Product:
                    ProductVersion:
                    Debug:            False
                    Patched:          False
                    PreRelease:       False
                    PrivateBuild:     False
                    SpecialBuild:     False
                    Language:

BaseName          : 4-3
Target            : {}
LinkType          :
Name              : 4-3.cpp
Length            : 136
DirectoryName     : D:\test
Directory         : D:\test
IsReadOnly        : False
Exists            : True
FullName          : D:\test\4-3.cpp
Extension         : .cpp
CreationTime      : 2019/3/27 15:07:32
CreationTimeUtc   : 2019/3/27 7:07:32
LastAccessTime    : 2019/3/27 15:07:32
LastAccessTimeUtc : 2019/3/27 7:07:32
LastWriteTime     : 2017/11/24 12:52:28
LastWriteTimeUtc  : 2017/11/24 4:52:28
Attributes        : Archive

function FuncName(args[]) #括号可省略
{
    <#代码段#>
}

PS C:/PowerShell> function cd...{ cd.. ; cd.. }
PS C:/PowerShell> cd...

function get-systemversion
{
	$psversiontable.BuildVersion
}

Get-SystemVersion

Major  Minor  Build  Revision
-----  -----  -----  --------
10     0      17134  590

PS C:/PowerShell> function MyPing
>> {
>> PING.EXE  -n 1 $args
>> }

PS C:/PowerShell> $function:MyPing | Out-File myPing.ps1
PS C:/PowerShell> $function:MyPing

PING.EXE  -n 1 $args

PS C:/PowerShell> $function:MyPing | Out-File myPing.ps1
PS C:/PowerShell> .myPing.ps1
必须指定 IP 地址。
PS C:/PowerShell> notepad.exe $$

function cc{"hello"}
PS C:/> cc
hello
PS C:/> del function:cc
PS C:/> cc
cc : 无法将“cc”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次。
所在位置 行:1 字符: 1
+ cc
+ ~~
    + CategoryInfo          : ObjectNotFound: (cc:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

$name=read-host "请输入你的名字" 
#会把提示信息打印到PS控制台，也可以不写提示信息
<#执行+输入 结果:
请输入你的名字: Nougat 
#>
$name
Nougat

write-host "啊哈" -ForegroundColor White -BackgroundColor Red
啊哈

write-host ACB #无空白字符可以不写引号 
ACB
write "ABC"
ABC
echo "ABD"
ABD

write-host "ABC" "23232"
ABC 23232

write-output "ABC" "23232"
ABC 
23232

function sayHello
{
    if($args.Count -eq 0)
    {
        "No argument!"
    }
    else
    {
        $args | foreach {"Hello,$($_)"}
    }
}
#无参调用
sayhello
#输出
No argument!

#一参调用
sayhello "World!" #也可以写成sayhello("World!")
#输出
Hello,World!


#多参数调用
$str="it's me."
sayhello 123 "aha" $str #如果字符串不包含空白字符(比如空格)，引号可以不写
<#输出
Hello,123
Hello,aha
Hello,it's me.
#>

function Add
{
	$sum=0
	$args | foreach {$sum=$sum+$_}
	$sum
}
Add 10 7 3 100
#120

function subtract([int]$value1,[int]$value2)
{
    return $value1-$value2
}
subtract LN P
#执行结果报错
subtract : 无法处理对参数“value1”的参数转换。无法将值“LN”转换为类型“System.Int32”。错误:“输入字符串的格式不正确。”
所在位置 行:1 字符: 10
+ subtract LN P
+          ~~
    + CategoryInfo          : InvalidData: (:) [subtract]，ParameterBindingArgumentTransformationException
    + FullyQualifiedErrorId : ParameterArgumentTransformationError,subtract

subtract 8.1 7.9
0
<#结果为0，这是因为PowerShell对结果整型化时进行了四舍五入
但是如果将上面的函数的参数定义为Double型#>
function subtract([double]$value1,[double]$value2)
{
    return $value1-$value2
}
subtract 8.1  7.9
0.199999999999999
<#输出 0.199999999999999的原因就是 .NET使用IEEE754标准存储浮点数，
由于这些小数转化二进制会无限循环，会根据一定精度截取尾数，
这个问题引发了这种奇怪的结果，
其实著名的0.1+0.2!=0.3也是这个原因导致的#>

function DayOfWeek([datetime]$date)
{
    return  $date.DayOfWeek
}

DayofWeek '1927-8-1'
Monday

DayofWeek 2008-8-1
Friday

DayofWeek 'abc'
DayOfWeek : 无法处理对参数“date”的参数转换。无法将值“abc”转换为类型“System.DateTime”。错误:“该字符串未被识别为有效的 DateTime。有一个未知单词(从索引 0 处开始)。”
所在位置 行:1 字符: 12
+  DayofWeek 'abc'
+            ~~~~~
    + CategoryInfo          : InvalidData: (:) [DayOfWeek]，ParameterBindingArgumentTransformationException
    + FullyQualifiedErrorId : ParameterArgumentTransformationError,DayOfWeek

function  tryReverse( [switch]$try , [string]$source ) 
#此处switch完全可以换成bool
{
    [string]$target=""
    if($try)
    {
        for( [int]$i = $source.length -1; $i -ge 0 ;$i--)
        {
            $target += $source[$i]
        }
        return $target
    }
    return $source
}
tryReverse -source www.google.com
tryReverse -try $true -source www.google.com
#输出
www.google.com
moc.eloog.www

function Square([double]$num)
{
    return $num*$num
}
#在控制台输出结果
Square 9.87
97.4169
 
#将结果赋值给变量
$value=Square 9.87
$value
97.4169
 
#返回值为Double类型
$value.GetType().FullName
System.Double

function gbMeasure($amount)
{
    "$amount GB=$($amount) GB"
    "$amount GB=$($amount*1gb/1mb) MB"
    "$amount GB=$($amount*1gb/1kb) KB"
    "$amount GB=$($amount*1gb) B"
}
 
#函数返回4个值
gbMeasure 1
1 GB=1 GB
1 GB=1024 MB
1 GB=1048576 KB
1 GB=1073741824 B
 
#将所有的返回值存储在一个变量中
$result=gbMeasure 1
$result
 
1 GB=1 GB
1 GB=1024 MB
1 GB=1048576 KB
1 GB=1073741824 B
 
#所有的返回值会自动存储在一个数组中
$result=gbMeasure 1
$result.GetType().Name
Object[]
 
#通过索引访问每个返回值
$result=gbMeasure 1
$result[3]
1 GB=1073741824 B

function test($num)
{
    1
    9
    return 10
    4
    6
}

test
1
9
10
<# 1 和 9 作为输出会返回
return语句中的10 也会返回
return 语句后的4和6会被忽略#>

function lottery([int]$number=1)
{
    $rand = New-Object system.random
    for ($i=1; $i -le $number; $i++) 
    {
        $rand.next(1,50)
    }
}

# 参数为空时，返回值不是数组:
$result = lottery
$result -is [array]
False

# 如果指定多个随机数时，返回值是数组类型:
$result = lottery 10
$result -is [array]
True
$result.count
10

function Test()
{
    "Try to calculate."
    "3.1415926"
    "Done."
}
 
#保存在变量中输出,
$value=Test
$value
#输出
Try to calculate.
3.1415926
Done.
 
#如果要过滤注释，只输出，不作为返回值，
#可以使用Write-Host命令
function Test()
{
    Write-Host "Try to calculate."
    "3.1415926"
    Write-Host "Done."
}
# 在变量值中保存返回值，在控制台输出注释行
$value=Test
#控制台输出
Try to calculate.
Done.
 
# 测试返回值
$value
3.1415926