Kategoria: DevOps/Scripting

conditional switch

często zamiast budowy skomplikowanych IFów lepiej jest skorzystać ze switcha. czyli zamienić złożoną składnię bazowaną na wielu 'if-then-else’ dużo czytelniejszym i prostszym blokiem 'switch’. to oczywista oczywistość ale jest coś bardziej 'zaawansowanego’ co jeszcze bardziej ułatwia życie – PowerShellowy Switch pozwala nie tylko na proste porównania, czy definicje wildcardów, które można znaleźć w manualu, ale również na tworzenie złożonych wyrażeń logicznych.

przykład takiego switcha:

test-switch.ps1

param(
    [int]$int
)

switch($int) {
    1 { write-host 'normalka'}
    {2 -or 3} {write-host 'ten sam dla dwóch wartości'}
    {$_ -ge 4} { write-host 'wieksze niz 3'}
    {$_ -ge 5} { write-host 'wieksze niz 4'
        break;
    }
    {$_ -lt 8} {write-host 'mniejsze niz 8 [ale nie wieksze niz 4]'} 
    default { write-host 'wszystkie inne'}
}

uwagę należy zwrócić na:

• zastosowanie 'break’ – standardowo switch wykona *wszystkie* bloki, spełniające warunek. w przypadku wywołania test-switch z parametrem 1 lub 2 pojawi się dodatkowo informacja ’mniejsze niż 4 [ale nie większe niż 2]’ . jeśli liczba będzie większa niż 3, wpadnie w klauzulę z 'break’ i ostatni krok nie zostanie wykonany. dla tego należy pamiętać, że *kolejność ma znaczenie*.
• dzięki temu, że switch wykonuje wszystkie bloki spełniające warunek, można zrobić krok typu 'catch all’ – który wykona się zawsze. ale warto umieścić go jako pierwszy tak, żeby nie przerwał go jakiś break. najlepiej użyć 'switch -wildcard’ -> manual.
• w instrukcji [man switch] można znaleźć bardzo fajne przykłady dla wyrażeń regularnych i wildcardów, dla tego pomijam go w tym prostym przykładzie. ale warto wiedzieć, że można wykonywać również zaawansowane porównania na ciągach znaków.
• to czego zabrakło w manualu to właśnie przykład wyrażenia logicznego. klauzulą może być dowolne wyrażenie zamknięte w nawiasach klamrowych {} . oczywiście dla determinizmu zachowania powinno zwracać true/false.
• PS switch nie pozwala na definiowane tego samego bloku dla kilq wartości [listy] tak, jak to się robi np. w VBS, czyli nie da się zdefiniować ’ 1,2 { blok } ’ . w zamian można użyć warunku logicznego '{1 -or 2} {blok} ’ . trochę mniej wygodne, ale działa tak samo (:

proste i wydajne. proponuję dla gimnastyki rozpisać to sobie na IFach… (;

eN.

logowanie na szybko – commandlet defaults

dobrze jest dodawać jakieś logi do skryptu. można sobie ułatwić to zadanie na wiele sposobów, ale chciałem dorzucić jeszcze jeden, który może przydać się przy innych scenariuszach, jeśli tylko często wykonuje się jakieś polecenie z takimi samymi wartościami parametrów.

jeśli logowanie robimy przekierowując przy pomocy out-file to co chwila będziemy wpisywać:

"message"|out-file -append -path $logPath

niby nie dużo, ale czemu nie skrócić tego zapisu? można ustawić standardowe wartości parametrów dla wszystkich commandletów. robi się przy pomocy zmiennej $PSDefaultParameterValues, a w praktyce wygląda to np. tak:

$logFile="logifilename$(Get-Date -Format yyMMddHHmm).log"
    $PSDefaultParameterValues = @{
        "Out-File:FilePath"=$logFile
        "Out-File:append"=$true
    }
    $startTime = Get-Date
    "starting operation at $startTime"|Out-File
    "second line to test append"|out-file

eN.

prawdziwy PS guru

https://geekeefy.wordpress.com/

eN.

get-MACAddressVendor

adresy MAC to tzw. OUIs – Organizationally Unique Identifier przyznawane przez IEEE. wszystkie można ściągnąć w postaci pliq textowego (1oMB). w związq z tym skrypt, który odpytuje się o MACa może albo wykorzystać jakieś query dostępne w necie, albo ściągną bazę lokalnie i operować na lokalnym pliq.

plik można ściągnąć na kilka sposób. w tym przypadq invoke-webRequest się wywala ze względu na timeout [duża wielkość pliq]. można zmienić timeout, można oprogramować metodę [System.Net.WebClient] … a można wykorzystać BITS.

poniżej prosty skrypcik, do weryfikacji MAC vendor, po uprzednim zassaniu oui.txt lokalnie. to na co warto zwrócić uwagę – to alternatywny sposób na pobieranie pliqw z netu, oraz parametr 'context’ dla select-string.

get-MACAddressVendor.ps1

################################################################################################
#.SYNOPSIS
#   simple script getting NIC vendor by checking MAC address OUI table. 
#   use -webAPI to use remote query. otherwise out.txt file will be download locally.
#.LINKS
#   oui file: http://standards-oui.ieee.org/oui.txt
#   remote query API: http://www.macvendorlookup.com/api
#.NOTES
#   nExoR 2o16
################################################################################################
param([string]$macAddress,[switch]$webAPI) 

$macAddressToVerify=$macAddress.Replace(':','').Replace('-','').ToLower()
$macAddressToVerify=$macAddressToVerify.Substring(0,6)
if($macAddressToVerify -notmatch [regex]'[0-9a-f]{6}') {
    throw 'NOT VALID MAC ADDRESS'   
}

if($webAPI) {
    $result=Invoke-WebRequest "http://www.macvendorlookup.com/api/v2/$macAddressToVerify"
    $result=ConvertFrom-Json $result.Content   
} else {
    if(-not (Test-Path .\oui.txt)) {
        Start-BitsTransfer -Source 'http://standards-oui.ieee.org/oui.txt' -Destination 'oui.txt' -TransferType Download
    }

    $result=Select-String -path .\oui.txt -Pattern $macAddressToVerify -Context 0,4
}

if($result) {
    $result
} else {
    throw "Vendor not found for $macAddress"
}

eN.

what-is-my-ip – kontunuacja

po  komentarzach na FB, zamieszczam prosty skrypt, który pozwala odpytać dwóch różnych stron – whatsmyipaddress, API, które zwraca czysty adres, ale ponieważ:

You may programmatically query that server but limit queries to no more than once per five minutes and include an appropriate user agent that will allow us to contact you if needed

dodałem starą metodę przegrzebującą się przez HTML.

get-ExternalIP.ps1

param( [switch]$alternateServer )

if($alternateServer) {
    $page=Invoke-WebRequest http://whatismyipaddress.com/pl/moj-ip
    [regex]$rxIP='((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)'
    $page.AllElements|? id -eq 'section_left'|%{ $IP=$rxIP.Match($_.outerText)}
} else {

    $result=Invoke-WebRequest ipv4bot.whatismyipaddress.com
    $IP=$result.content
}

Write-Host -BackgroundColor DarkYellow -ForegroundColor Black "EXTERNAL IP ADDRESS OF THE CONNECTION: $IP"

eN.