New-ItemProperty
Vytvoří novou vlastnost pro položku a nastaví její hodnotu.
Syntaxe
New-ItemProperty
[-Path] <String[]>
[-Name] <String>
[-PropertyType <String>]
[-Value <Object>]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>] New-ItemProperty
-LiteralPath <String[]>
[-Name] <String>
[-PropertyType <String>]
[-Value <Object>]
[-Force]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<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.
- K přidání vlastnosti 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 HKLM:\Software hive.
První příkaz použije parametr Path k určení cesty MyCompany klíče registru.
Pomocí parametru Name určuje název položky a parametr Value k určení jeho hodnoty.
Druhý příkaz pomocí rutiny Get-ItemProperty zobrazí novou položku 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 : 822Pří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 určení klíče používá operátor kanálu (|) k odeslání objektu, který představuje klíč do New-ItemProperty.
První část příkazu používá rutinu Get-Item k získání MyCompany klíče registru. Operátor kanálu odešle výsledky příkazu New-ItemProperty, který přidá novou položku registru (NoOfLocations) a jeho hodnotu (3) do MyCompany klíče.
Get-Item -Path "HKLM:\Software\MyCompany" | New-ItemProperty -Name NoOfLocations -Value 3Tento příkaz funguje, protože funkce vazby parametrů windows PowerShellu přidruží cestu k objektu RegistryKey , který Get-Item se vrací s parametrem LiteralPath parametru 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í argumentu 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" stringsPříklad 4: Vytvoření hodnoty MultiString v registru pomocí pole
Příklad ukazuje, jak vytvořit hodnotu pomocí pole hodnot MultiString .
$newValue = New-ItemProperty -Path "HKLM:\SOFTWARE\ContosoCompany\" -Name 'MultiString' -PropertyType MultiString -Value ('a','b','c')
$newValue.multistring[0]
aParametry
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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 nebo zadejte objekt PSCredential, například objekt vygenerovaný rutinou Get-Credential Domain01\User01. Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.
Poznámka:
Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými v PowerShellu. Pokud chcete zosobnit jiného uživatele nebo zvýšit úroveň přihlašovacích údajů při spuštění této rutiny, použijte Invoke-Command.
| Typ: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Exclude
Určuje, jako pole řetězců, vlastnost nebo vlastnost, které tato rutina vylučuje z operace.
Hodnota tohoto parametru kvalifikuje parametr Path .
Zadejte element nebo vzor cesty, například *.txt.
Jsou povoleny zástupné znaky.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Filter
Určuje filtr ve formátu nebo jazyce poskytovatele. Hodnota tohoto parametru kvalifikuje parametr Path .
Syntaxe filtru, včetně použití zástupných znaků, závisí na poskytovateli. Filtry jsou efektivnější než jiné parametry, protože je poskytovatel použije, když rutina získá objekty místo toho, aby objekty po jejich načtení vyfiltroval PowerShell.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Force
Vynutí, aby rutina vytvořila vlastnost objektu, ke kterému uživatel jinak nemá přístup. Implementace se liší od zprostředkovatele po zprostředkovatele. Další informace najdete v tématu about_Providers.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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 element nebo vzor cesty, 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.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-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, aby nepřekládaly žádné znaky jako řídicí sekvence.
Další informace najdete v tématu about_Quoting_Rules.
| Typ: | String[] |
| Aliasy: | PSPath |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Name
Určuje název nové vlastnosti. Pokud je vlastnost položka registru, tento parametr určuje název položky.
| Typ: | String |
| Aliasy: | PSProperty |
| Position: | 1 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Path
Určuje cestu k položce. Tento parametr identifikuje položku, do které tato rutina přidá novou vlastnost.
| Typ: | String[] |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-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 ukončený hodnotou null, který obsahuje nerozbalené 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.
| Typ: | String |
| Aliasy: | Type |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-UseTransaction
Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.
| Typ: | SwitchParameter |
| Aliasy: | usetx |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Value
Určuje hodnotu vlastnosti. Pokud je vlastnost položka registru, tento parametr určuje hodnotu položky.
| Typ: | Object |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
None
Do této rutiny nemůžete roušit objekty.
Výstupy
Tato rutina vrátí vlastní objekt představující novou vlastnost.
Poznámky
New-ItemProperty je navržený tak, aby fungoval s daty vystavenými jakýmkoli poskytovatelem. Pokud chcete zobrazit seznam poskytovatelů dostupných v relaci, zadejte Get-PSProvider. Další informace najdete v tématu about_Providers.
