ما هو Windows PowerShell وماذا يأكل؟ الجزء 3: تمرير المعلمات إلى النصوص والوظائف ، وإنشاء أوامر cmdlets

جدول المحتويات:

المعلمات الموضعية

Write-Host " :" $args.count
Write-Host ":" $args

function Print-Args {
    Write-Host " :" $args.count
    Write-Host " 0:" $args[0]
    Write-Host " 1:" $args[1] 
}

كتلة Param ()

function test ($arg0, ..., $argN)
{
       
}

param (
    $arg0, $arg1
)

Write-Host $arg0 $arg1

function test {
     param (
           $arg0, $arg1
     )
}

سمات المعلمات الإضافية

param([int]$arg0)

function test ([int]$arg0) {
}

param(
    [parameter(Argument1=value1, Argument2=value2)]
    $ParameterName
)

param([parameter(Mandatory=$true)][int]$arg0)

function test ([parameter(Mandatory=$true)][int]$arg0) { 
}

function test {
          parameter([parameter(Mandatory=$true)][int]$arg0)
}

param(
                    [parameter(Mandatory=$true, Position=0)]
                    [int]
                    $arg0,

                    [parameter(Position=1)]
                    [string]
                    $arg1,

                    [parameter(Position=2)]
                    [array]
                    $arg2
)

param(
    [parameter(Mandatory=$true)]
    [alias("ARG","ArgumentName")]
    [string[]]
    $arg0
)

param(
    [parameter(Mandatory=$true)]
    [AllowNull()]
    [string]
    $arg0
)

param(
    [parameter(Mandatory=$true)]
    [AllowEmptyString()]
    [string]
    $arg0
)

param(
    [parameter(Mandatory=$true)]
    [AllowEmptyCollection()]
    [string[]]
    $arg0
)

param(
    [parameter(Mandatory=$true)]
    [ValidatePattern("[0-9][0-9][0-9][0-9]")]
    [string[]]
    $arg0
)

param(
    [parameter(Mandatory=$true)]
    [ValidateLength(1,10)]
    [string]
    $arg0
)

تمرير المعلمات عبر خط الأنابيب

Get-Help Stop-Process -Parameter Name

param(
    [parameter(Mandatory=$true,
    ValueFromPipeline=$true)]
    [string[]]
    $Name
)

param(
    [parameter(Mandatory=$true,
    ValueFromPipelineByPropertyName=$true)]
    [string[]]
    $Name
)

param(
    [parameter(Mandatory=$true,
    ValueFromPipeline=$true,
    ValueFromPipelineByPropertyName=$true)]
    [string[]]
    $Name
)

Write-Host $Name

هيكل جسم الوظيفة

function test
{
   param()
   begin {}
   process {}
   end {}
}

function test
{

    param(
        [Parameter(ValueFromPipeline)]
        [string[]]
        $Param1,

        [string]$Param2
    )

    begin
    {
        Write-Host " Begin"
        Write-Host "       ( pipeline):" $Param1
        Write-Host "       ( ):" $Param2
    }

    process {
        Write-Host " Process"
        Write-Host "       ( pipeline):" $Param1
        Write-Host "       ( ):" $Param2
    }

    end
    {
        Write-Host " End"
        Write-Host "       ( pipeline):" $Param1
        Write-Host "       ( ):" $Param2
    }
}

[CmdletBinding ()] السمة والوظائف المتقدمة

function <Name>
{
    [CmdletBinding(ConfirmImpact=<String>,
    DefaultParameterSetName=<String>,
    HelpURI=<URI>,
    SupportsPaging=<Boolean>,
    SupportsShouldProcess=<Boolean>,
    PositionalBinding=<Boolean>)]

    Param ()

    Begin{}
    Process{}
    End{}
}

function Delete-File {
[CmdletBinding(
    ConfirmImpact = 'High',
    SupportsShouldProcess = $true
)]
    param(
        [string]$File,
        [switch]$Force
    )
    if ($Force -or $PSCmdlet.ShouldProcess($File,"Delete file")) {
        Remove-Item $File
    }
}

function Get-Something {
[CmdletBinding()]
    param()
    if ($PSBoundParameters.Verbose) {$VerbosePreference = "Continue"}
    if ($PSBoundParameters.Debug) {$DebugPreference = "Continue"}
    Write-Verbose "Type some verbose information"
    Write-Debug "Type some debug information"
}

وحدات البرنامج النصي وإنشاء أمر Cmdlet