Free Press

Modul: Microsoft.PowerShell.Core

Syntaks

Where-Object <String> <Object>] 

Where-Object <ScriptBlock> 

Where-Object <String> <Object>] -Match 

Where-Object <String> <Object>] -CEQ 

Where-Object <String> <Object>] -NE 

Where-Object <String> <Object>] -CNE 

Where-Object <String> <Object>] -GT 

Where-Object <String> <Object>] -CGT 

Where-Object <String> <Object>] -LT 

Where-Object <String> <Object>] -CLT 

Where-Object <String> <Object>] -GE 

Where-Object <String> <Object>] -CGE 

Where-Object <String> <Object>] -LE 

Where-Object <String> <Object>] -CLE 

Where-Object <String> <Object>] -Like 

Where-Object <String> <Object>] -CLike 

Where-Object <String> <Object>] -NotLike 

Where-Object <String> <Object>] -CNotLike 

Where-Object <String> <Object>] -CMatch 

Where-Object <String> <Object>] -NotMatch 

Where-Object <String> <Object>] -CNotMatch 

Where-Object <String> <Object>] -Contains 

Where-Object <String> <Object>] -CContains 

Where-Object <String> <Object>] -NotContains 

Where-Object <String> <Object>] -CNotContains 

Where-Object <String> <Object>] -CNotContains 

Where-Object <String> <Object>] -In 

Where-Object <String> <Object>] -CIn 

Where-Object <String> <Object>] -NotIn 

Where-Object <String> <Object>] -CNotIn 

Where-Object <String> <Object>] -Is 

Where-Object <String> <Object>] -IsNot 

Where-Object <String> -Not 

Description

Cmdletten Where-Object vælger objekter, der har bestemte egenskabsværdier, fra samlingenaf objekter, der er overgivet til den. Du kan f.eks. bruge Where-Object-cmdletten til at vælge filer, der er oprettet efter en bestemt dato, hændelser med et bestemt ID eller computere, der bruger en bestemt version af Windows.

Der er to forskellige måder at opbygge en Where-Object-kommando på i Windows PowerShell 3.0.

• Scriptblok. Du kan bruge en scriptblok til at angive egenskabsnavnet, en sammenligningsoperator og en egenskabsværdi. Where-Object returnerer alle objekter, for hvilke scriptblokanvisningen er sand.

  Den følgende kommando henter f.eks. processer i prioritetsklassen Normal, dvs. processer, hvor værdien af egenskaben PriorityClass er lig med Normal.

  Get-Process | Where-Object {$_.PriorityClass -eq "Normal"}

  Alle PowerShell-sammenligningsoperatorer er gyldige i scriptblokformatet. Du kan finde flere oplysninger om sammenligningsoperatorer underom_Comparison_Operators.

• Sammenligningsanvisning. Du kan også skrive en sammenligningsangivelse, som er meget mere ligenaturligt sprog. Sammenligningsangivelser blev indført i Windows PowerShell 3.0.

  De følgende kommandoer får f.eks. også processer, der har prioritetsklassen Normal, med. Dissekommandoer er ækvivalente og kan bruges i flæng.

  Get-Process | Where-Object -Property PriorityClass -eq -Value "Normal"

  Get-Process | Where-Object PriorityClass -eq "Normal"

  Start i Windows PowerShell 3.0, Where-Object tilføjer sammenligningsoperatorer som parametre i enWhere-Object-kommando. Medmindre det er angivet, er alle operatorer ikke afgørende for store og små bogstaver. Før WindowsPowerShell 3.0 kunne sammenligningsoperatorer i PowerShell-sproget kun bruges i scriptblokke.

Når du angiver en enkelt egenskab til Where-Object, behandles værdien af egenskaben som et boolsk udtryk. Når værdien af Længde ikke er nul, evalueres udtrykket tilTrue. For eksempel: ('hi', '', 'there') | Where-Object Length

Det foregående eksempel svarer funktionelt til:

('hi', '', 'there') | Where-Object Length -GT 0 ('hi', '', 'there') | Where-Object {$_.Length -gt 0}

Eksempler

Eksempel 1: Hent stoppede tjenester

Disse kommandoer får en liste over alle tjenester, der i øjeblikket er stoppet. Den automatiske variabel $_ repræsenterer hvert objekt, der overføres til cmdlet Where-Object.

Den første kommando bruger scriptblokformatet, mens den anden kommando bruger formatet med sammenligningsangivelse. Kommandoerne er ækvivalente og kan bruges i flæng.

Get-Service | Where-Object {$_.Status -eq "Stopped"}Get-Service | where Status -eq "Stopped"

Eksempel 2: Hent processer baseret på arbejdssæt

Disse kommandoer viser en liste over processer, der har et arbejdssæt på mere end 250 megabyte (KB). Syntaksen for scriptblok og erklæring er ækvivalente og kan bruges i flæng.

Get-Process | Where-Object {$_.WorkingSet -GT 250MB}Get-Process | Where-Object WorkingSet -GT (250MB)

Eksempel 3: Hent processer baseret på procesnavn

Disse kommandoer henter de processer, der har en ProcessName-egenskabsværdi, som begynder med bogstavet p. Med operatoren Match kan du bruge regulære udtryksmatches.

Scriptblock- og statement-syntaksen er ækvivalente og kan bruges i flæng.

Get-Process | Where-Object {$_.ProcessName -Match "^p.*"}Get-Process | Where-Object ProcessName -Match "^p.*"

Eksempel 4: Brug formatet for sammenligningsanvisninger

Dette eksempel viser, hvordan du bruger det nye format for sammenligningsanvisninger i cmdlet Where-Object.

Den første kommando bruger formatet for sammenligningsanvisningen. i denne kommando bruges der ingen aliaser, og alle parametre indeholder parameternavnet.

Den anden kommando er den mere naturlige brug af formatet for sammenligningsanvisningen. Aliasset where erstattes af Where-Object cmdletnavnet, og alle valgfrie parameternavne udelades.

Get-Process | Where-Object -Property Handles -GE -Value 1000Get-Process | where Handles -GE 1000

Eksempel 5: Hent kommandoer baseret på egenskaber

Dette eksempel viser, hvordan man skriver kommandoer, der returnerer elementer, der er sande eller falske eller har en hvilken som helst værdi for en angivet egenskab. Hvert eksempel viser både scriptblok- og sammenligningsangivelsesformatet for kommandoen.

# Use Where-Object to get commands that have any value for the OutputType property of the command.# This omits commands that do not have an OutputType property and those that have an OutputType property, but no property value.Get-Command | where OutputTypeGet-Command | where {$_.OutputType}# Use Where-Object to get objects that are containers.# This gets objects that have the **PSIsContainer** property with a value of $True and excludes all others.Get-ChildItem | where PSIsContainerGet-ChildItem | where {$_.PSIsContainer}# Finally, use the Not operator (!) to get objects that are not containers.# This gets objects that do have the **PSIsContainer** property and those that have a value of $False for the **PSIsContainer** property.Get-ChildItem | where {!$_.PSIsContainer}# You cannot use the Not operator (!) in the comparison statement format of the command.Get-ChildItem | where PSIsContainer -eq $False

Eksempel 6: Brug flere betingelser

Get-Module -ListAvailable | where {($_.Name -notlike "Microsoft*" -and $_.Name -notlike "PS*") -and $_.HelpInfoUri}

Dette eksempel viser, hvordan du opretter en Where-Object-kommando med flere betingelser.

Denne kommando henter ikke-kernemoduler, der understøtter funktionen Opdaterbar hjælp. Kommandoen bruger parameterenListAvailable i cmdlet Get-Module til at hente alle moduler på computeren. Enipeline-operator (|) sender modulerne til cmdlet Where-Object, som henter moduler, hvis navn ikke begynder med Microsoft eller PS og har en værdi for HelpInfoURI-egenskaben, som fortæller PowerShell, hvor der skal findes opdaterede hjælpefiler for modulet. Sammenligningsangivelserne er forbundet med den logiske operatør And.

Eksemplet bruger kommandoblokformatet scriptblok. Logiske operatorer, f.eks. And og Or, er kun gyldige i scriptblokke. Du kan ikke bruge dem i formatet for sammenligningsanvisninger i enWhere-Object-kommando.

• For yderligere oplysninger om logiske PowerShell-operatører henvises til about_Logical_Operators.
• For yderligere oplysninger om funktionen Opdaterbar hjælp henvises til about_Updatable_Help.

Parameters