New-ItemProperty

Vytvoří novou vlastnost pro položku a nastaví její hodnotu.

Syntax

New-ItemProperty
   [-Path] <String[]>
   [-Name] <String>
   [-PropertyType <String>]
   [-Value <Object>]
   [-Force]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-ItemProperty
   -LiteralPath <String[]>
   [-Name] <String>
   [-PropertyType <String>]
   [-Value <Object>]
   [-Force]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina New-ItemProperty vytvoří novou vlastnost pro zadanou položku a nastaví její hodnotu. Tato rutina se obvykle používá k vytvoření nových hodnot registru, protože hodnoty registru jsou vlastnosti položky klíče registru.

Tato rutina nepřidá vlastnosti do objektu.

  • Pokud chcete přidat vlastnost do instance objektu, použijte rutinu Add-Member .
  • Chcete-li přidat vlastnost ke všem objektům určitého typu, upravte soubor Types.ps1xml.

Příklady

Příklad 1: Přidání položky registru

Tento příkaz přidá novou položku registru , NoOfEmployeesdo MyCompany klíče objektu HKLM:\Software hive.

První příkaz použije parametr Path k určení cesty MyCompany klíče registru. Použije parametr Name k určení názvu položky a parametru Value k určení jeho hodnoty.

Druhý příkaz použije rutinu Get-ItemProperty k zobrazení nové položky registru.

New-ItemProperty -Path "HKLM:\Software\MyCompany" -Name "NoOfEmployees" -Value 822
Get-ItemProperty "HKLM:\Software\MyCompany"

PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software\mycompany
PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\software
PSChildName   : mycompany
PSDrive       : HKLM
PSProvider    : Microsoft.PowerShell.Core\Registry
NoOfLocations : 2
NoOfEmployees : 822

Příklad 2: Přidání položky registru do klíče

Tento příkaz přidá novou položku registru do klíče registru. K zadání klíče použije operátor kanálu (|) k odeslání objektu, který představuje klíč .New-ItemProperty

První část příkazu používá rutinu Get-ItemMyCompany k získání klíče registru. Operátor kanálu odešle výsledky příkazu do New-ItemProperty, který přidá novou položku registru (NoOfLocations) a její hodnotu (3) do MyCompany klíče.

Get-Item -Path "HKLM:\Software\MyCompany" | New-ItemProperty -Name NoOfLocations -Value 3

Tento příkaz funguje, protože funkce vazby parametrů PowerShellu přidruží cestu objektu RegistryKey, která Get-Item se vrátí k parametru LiteralPath .New-ItemProperty Další informace najdete v tématu about_Pipelines.

Příklad 3: Vytvoření hodnoty MultiString v registru pomocí Here-String

Tento příklad vytvoří MultiString hodnotu pomocí here-String.

$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'HereString' -PropertyType MultiString -Value @"
This is text which contains newlines
It can also contain "quoted" strings
"@
$newValue.multistring

This is text which contains newlines
It can also contain "quoted" strings

Příklad 4: Vytvoření hodnoty MultiString v registru pomocí pole

Příklad ukazuje, jak k vytvoření MultiString hodnoty použít matici hodnot.

$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'MultiString' -PropertyType MultiString -Value ('a','b','c')
$newValue.multistring[0]

a

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Určuje uživatelský účet, který má oprávnění k provedení této akce. Ve výchozím nastavení je to aktuální uživatel.

Zadejte uživatelské jméno, například User01 nebo Domain01\User01nebo zadejte objekt PSCredential , například jeden vygenerovaný rutinou Get-Credential . Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

Poznámka

Tento parametr nepodporuje žádné poskytovatele nainstalované v PowerShellu. Pokud chcete zosobnit jiného uživatele nebo zvýšit úroveň svých přihlašovacích údajů při spuštění této rutiny, použijte Invoke-Command.

Type:PSCredential
Position:Named
Default value:Current user
Accept pipeline input:True
Accept wildcard characters:False

-Exclude

Určuje jako pole řetězců položku nebo položky, které tato rutina v operaci vylučuje. Hodnota tohoto parametru kvalifikuje parametr Path . Zadejte prvek cesty nebo vzor, například *.txt. Jsou povoleny zástupné znaky. Parametr Exclude je efektivní pouze v případě, že příkaz obsahuje obsah položky, například C:\Windows\*, kde zástupný znak určuje obsah C:\Windows adresáře.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Filter

Určuje filtr, který kvalifikuje parametr Path . Zprostředkovatel FileSystem je jediným nainstalovaným poskytovatelem PowerShellu, který podporuje použití filtrů. Syntaxi jazyka filtru FileSystem najdete v about_Wildcards. Filtry jsou efektivnější než jiné parametry, protože zprostředkovatel je použije, když rutina získá objekty místo toho, aby PowerShell filtroval objekty po jejich načtení.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Force

Vynutí, aby rutina vytvořila vlastnost objektu, ke kterému uživatel jinak nemá přístup. Implementace se liší od poskytovatele po zprostředkovatele. Další informace najdete v tématu about_Providers.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

Určuje jako pole řetězců položku nebo položky, které tato rutina zahrnuje v operaci. Hodnota tohoto parametru kvalifikuje parametr Path . Zadejte prvek cesty nebo vzor, například *.txt. Jsou povoleny zástupné znaky. Parametr Include je efektivní pouze v případě, že příkaz obsahuje obsah položky, například C:\Windows\*, kde zástupný znak určuje obsah C:\Windows adresáře.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-LiteralPath

Určuje cestu k jednomu nebo více umístěním. Hodnota LiteralPath se používá přesně tak, jak je zadána. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud cesta obsahuje řídicí znaky, uzavřete ji do jednoduchých uvozovek ('). Jednoduché uvozovky říkají PowerShellu, že nemají interpretovat žádné znaky jako řídicí sekvence.

Další informace najdete v tématu about_Quoting_Rules.

Type:String[]
Aliases:PSPath, LP
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Určuje název nové vlastnosti. Pokud je vlastnost položkou registru, tento parametr určuje název položky.

Type:String
Aliases:PSProperty
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Path

Určuje cestu k položce. Jsou povoleny zástupné znaky. Tento parametr identifikuje položku, do které tato rutina přidá novou vlastnost.

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-PropertyType

Určuje typ vlastnosti, kterou tato rutina přidá. Tento parametr přijímá tyto hodnoty:

  • String: Určuje řetězec ukončený hodnotou null. Používá se pro REG_SZ hodnoty.
  • ExpandString: Určuje řetězec s ukončenou hodnotou null, který obsahuje nevyexpandované odkazy na proměnné prostředí, které se rozbalí při načtení hodnoty. Používá se pro REG_EXPAND_SZ hodnoty.
  • Binary: Určuje binární data v libovolné podobě. Používá se pro REG_BINARY hodnoty.
  • DWord: Určuje 32bitové binární číslo. Používá se pro REG_DWORD hodnoty.
  • MultiString: Určuje pole řetězců ukončených hodnotou null ukončených dvěma znaky null. Používá se pro REG_MULTI_SZ hodnoty.
  • Qword: Určuje 64bitové binární číslo. Používá se pro REG_QWORD hodnoty.
  • Unknown: Označuje nepodporovaný datový typ registru, například REG_RESOURCE_LIST hodnoty.
Type:String
Aliases:Type
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Value

Určuje hodnotu vlastnosti. Pokud je vlastnost položka registru, tento parametr určuje hodnotu položky.

Type:Object
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

PSCustomObject

New-ItemProperty vrátí vlastní objekt, který obsahuje novou vlastnost.

Poznámky

New-ItemProperty je navržen tak, aby fungoval s daty vystavenými libovolným poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PSProvider. Další informace najdete v tématu about_Providers.