Sdílet prostřednictvím

Get-Unique

  • Reference
Modul:
Microsoft.PowerShell.Utility

Vrátí jedinečné položky z seřazeného seznamu.

Syntaxe

Get-Unique
   [-InputObject <PSObject>]
   [-AsString]
   [-CaseInsensitive]
   [<CommonParameters>]
Get-Unique
   [-InputObject <PSObject>]
   [-OnType]
   [-CaseInsensitive]
   [<CommonParameters>]

Description

Rutina Get-Unique porovnává každou položku v seřazeném seznamu s další položkou, eliminuje duplicity a vrací pouze jednu instanci každé položky. Aby rutina správně fungovala, musí být seznam seřazený.

Ve výchozím nastavení Get-Unique rozlišují malá a velká písmena. Výsledkem je, že řetězce, které se liší pouze v písmenech znaků, jsou považovány za jedinečné.

Příklady

Příklad 1: Získání jedinečných slov v textovém souboru

Tyto příkazy najdou počet jedinečných slov v textovém souboru.

$A = $( foreach ($line in Get-Content C:\Test1\File1.txt) {
    $line.ToLower().Split(" ")
  }) | Sort-Object | Get-Unique
$A.Count

První příkaz získá obsah souboru File.txt. Převede každý řádek textu na malá písmena a potom každé slovo rozdělí na samostatný řádek v prostoru (" "). Potom seřadí výsledný seznam abecedně (výchozí) a použije rutinu Get-Unique k odstranění duplicitních slov. Výsledky jsou uloženy v proměnné $A.

Druhý příkaz používá vlastnost Count kolekce řetězců v $A k určení počtu položek v $A.

Příklad 2: Získání jedinečných celých čísel v poli

Tento příkaz najde jedinečné členy sady celých čísel.

1,1,1,1,12,23,4,5,4643,5,3,3,3,3,3,3,3 | Sort-Object | Get-Unique

1
3
4
5
12
23
4643

První příkaz vezme pole celých čísel zadaných na příkazovém řádku, předá je do Sort-Object rutiny, která se má seřadit, a potom je seřadí do Get-Unique, což eliminuje duplicitní položky.

Příklad 3: Získání jedinečných typů objektů v adresáři

Tento příkaz používá rutinu Get-ChildItem k načtení obsahu místního adresáře, který obsahuje soubory a adresáře.

Get-ChildItem | Sort-Object {$_.GetType()} | Get-Unique -OnType

Operátor kanálu (|) odešle výsledky do rutiny Sort-Object. Příkaz $_.GetType() použije metodu GetType pro každý soubor nebo adresář. Potom Sort-Object seřadí položky podle typu. Jiný operátor kanálu odešle výsledky do Get-Unique. Parametr OnType směruje Get-Unique tak, aby vracel pouze jeden objekt každého typu.

Příklad 4: Získání jedinečných procesů

Tento příkaz získá názvy procesů spuštěných v počítači s odstraněnými duplicitními položkami.

Get-Process | Sort-Object | Select-Object ProcessName | Get-Unique -AsString

Příkaz Get-Process získá všechny procesy v počítači. Operátor kanálu (|) předá výsledek Sort-Object, který ve výchozím nastavení seřadí procesy abecedně podle ProcessName. Výsledky se předávají do rutiny Select-Object, která vybere pouze hodnoty ProcessName vlastnosti každého objektu. Výsledky se pak předají tak, aby se Get-Unique eliminovaly duplicity.

Parametr AsString říká Get-Unique, aby s hodnotami ProcessName zacházet jako s řetězci. Bez tohoto parametru Get-Unique považuje ProcessName hodnoty jako objekty a vrátí pouze jednu instanci objektu, tj. název prvního procesu v seznamu.

Příklad 5: Použití porovnání s rozlišováním velkých a malých písmen k získání jedinečných řetězců

Tento příklad používá porovnání bez rozlišování malých a velkých písmen k získání jedinečných řetězců z pole řetězců.

"aa", "Aa", "Bb", "bb", "aa" | Sort-Object -CaseSensitive | Get-Unique

aa
Aa
bb
Bb

Příklad 6: Použití porovnání nerozlišující malá a velká písmena k získání jedinečných řetězců

Tento příklad používá porovnání bez rozlišování malých a velkých písmen k získání jedinečných řetězců z pole řetězců.

"aa", "Aa", "Bb", "bb", "aa" | Sort-Object | Get-Unique -CaseInsensitive

aa
Bb

Parametry

-AsString

Označuje, že tato rutina používá data jako řetězec. Bez tohoto parametru se data považují za objekt, takže když odešlete kolekci objektů stejného typu do Get-Unique, například kolekce souborů, vrátí pouze jednu (první). Tento parametr můžete použít k vyhledání jedinečných hodnot vlastností objektu, jako jsou názvy souborů.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CaseInsensitive

Ve výchozím nastavení Get-Unique rozlišují malá a velká písmena. Při použití tohoto parametru používá rutina porovnání bez rozlišování velkých a malých písmen.

Tento parametr byl přidán v PowerShellu 7.4.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje vstup pro Get-Unique. Zadejte proměnnou obsahující objekty nebo zadejte příkaz nebo výraz, který objekty získá.

Tato rutina zpracovává vstup odeslaný pomocí InputObject jako kolekce. Nevypíše jednotlivé položky v kolekci. Protože kolekce je jedna položka, vstup odeslaný pomocí InputObject je vždy vrácen beze změny.

Typ:PSObject
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-OnType

Označuje, že tato rutina vrací pouze jeden objekt každého typu.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSObject

Do této rutiny můžete převést libovolný typ objektu.

Výstupy

PSObject

Tato rutina vrátí vstupní objekty bez duplicit.

Poznámky

PowerShell obsahuje následující aliasy pro Get-Unique:

  • Všechny platformy:
    • gu

Další informace naleznete v tématu about_Aliases.

Chcete-li seznam seřadit, použijte Sort-Object. K vyhledání jedinečných položek v seznamu můžete použít také parametr UniqueSort-Object.