Rutina Set-WmiInstance vytvoří nebo aktualizuje instanci existující třídy WMI (Windows Management Instrumentation).
Vytvořená nebo aktualizovaná instance se zapíše do úložiště rozhraní WMI.
Nové rutiny CIM, zavedené prostředí Windows PowerShell 3.0, provádějí stejné úlohy jako rutiny rozhraní WMI.
Rutiny CIM odpovídají standardům WS-Management (WSMan) a standardu CIM (Common Information Model).
To umožňuje rutinám používat stejné techniky ke správě počítačů se systémem Windows a těch, na kterých běží jiné operační systémy.
Místo použití Set-WmiInstancezvažte použití rutin Set-CimInstance nebo Rutiny New-CimInstan ce.
Příklady
Příklad 1: Nastavení úrovně protokolování rozhraní WMI
Tento příkaz nastaví úroveň protokolování rozhraní WMI na 2.
Příkaz předá vlastnost, která má být nastavena, a hodnota, společně považován za pár hodnot v parametru argumentu.
Parametr přebírá tabulku hash definovanou konstruktorem @{property = value}.
Vrácené informace o třídě odrážejí novou hodnotu.
Příklad 2: Vytvoření proměnné prostředí a její hodnoty
Tento příkaz vytvoří proměnnou prostředí testvar, která má hodnotu testvalue.
Provede to vytvořením nové instance Win32_Environment třídy WMI.
Tato operace vyžaduje odpovídající přihlašovací údaje a že možná budete muset restartovat Prostředí Windows PowerShell, abyste viděli novou proměnnou prostředí.
Příklad 3: Nastavení úrovně protokolování rozhraní WMI pro několik vzdálených počítačů
Tento příkaz nastaví úroveň protokolování rozhraní WMI na 2.
Příkaz předá vlastnost, která má být nastavena, a hodnota, společně považován za pár hodnot v parametru argumentu.
Parametr přebírá tabulku hash definovanou konstruktorem @{property = value}.
Vrácené informace o třídě odrážejí novou hodnotu.
Parametry
-Arguments
Určuje název vlastnosti, kterou chcete změnit, a novou hodnotu této vlastnosti.
Název a hodnota musí být dvojicí name-value.
Pár name-value se předává na příkazovém řádku jako tabulka hash.
Například:
@{Setting1=1; Setting2=5; Setting3="test"}
Vlastnosti parametru
Typ:
Hashtable
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Aliasy:
Argumenty, Vlastnictví
Sady parametrů
class
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
object
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
path
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-AsJob
Označuje, že tento cmdket běží jako úloha na pozadí.
Pomocí tohoto parametru můžete spouštět příkazy, které potrvá dlouhou dobu.
Když zadáte parametr AsJob, příkaz vrátí objekt, který představuje úlohu na pozadí, a pak zobrazí příkazový řádek.
Během dokončení úlohy můžete pokračovat v práci v relaci.
Pokud se pro vzdálený počítač používá Set-WmiInstance, vytvoří se úloha v místním počítači a výsledky ze vzdálených počítačů se automaticky vrátí do místního počítače.
Ke správě úlohy použijte rutiny, které obsahují úlohu podstatné jméno (rutiny úloha).
K získání výsledků úlohy použijte rutinu Receive-Job.
Chcete-li tento parametr použít společně se vzdálenými počítači, musí být místní a vzdálené počítače nakonfigurovány pro vzdálenou komunikace.
Kromě toho musíte spustit Windows PowerShell pomocí možnosti Spustit jako správce v systému Windows Vista a novějších verzích operačního systému Windows.
Další informace najdete v tématu about_Remote_Requirements.
Další informace o úlohách prostředí Windows PowerShell na pozadí najdete v tématu about_Jobs a about_Remote_Jobs.
Vlastnosti parametru
Typ:
SwitchParameter
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
(All)
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-Authentication
Určuje úroveň ověřování, která se musí použít s připojením rozhraní WMI.
Přijatelné hodnoty pro tento parametr jsou:
-1: Beze změny.
0: Výchozí.
1: Žádné.
Neprovádělo se žádné ověřování.
2: Připojení.
Ověřování se provádí pouze v případech, kdy klient vytvoří relaci s aplikací.
3: Zavolejte.
Ověřování se provádí pouze na začátku každého volání, když aplikace obdrží požadavek.
4: Paket.
Ověřování se provádí u všech dat přijatých z klienta.
5: Integrita paketu.
Všechna data přenášená mezi klientem a aplikací se ověřují a ověřují.
6: Ochrana osobních údajů.
Používají se vlastnosti ostatních úrovní ověřování a všechna data se šifrují.
Určuje autoritu, která se má použít k ověření připojení rozhraní WMI.
Můžete zadat standardní ověřování NTLM nebo Kerberos.
Chcete-li použít NTLM, nastavte nastavení autority na ntlmdomain:<DomainName>, kde <DomainName> identifikuje platný název domény NTLM.
Chcete-li použít Protokol Kerberos, zadejte kerberos:<DomainName>\<Název_serveru>.
Nastavení autority nelze zahrnout při připojení k místnímu počítači.
Vlastnosti parametru
Typ:
String
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
class
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
path
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
WQLQuery
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
query
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
list
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-Class
Určuje název třídy WMI.
Vlastnosti parametru
Typ:
String
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
class
Position:
0
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-ComputerName
Určuje název počítače, na kterém se tato rutina spouští.
Výchozí hodnota je místní počítač.
Zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény jednoho nebo více počítačů.
Chcete-li zadat místní počítač, zadejte název počítače, tečku (.) nebo localhost.
Tento parametr nespoléhá na vzdálené komunikace Windows PowerShellu.
Parametr ComputerName můžete použít i v případě, že váš počítač není nakonfigurovaný pro spouštění vzdálených příkazů.
Vlastnosti parametru
Typ:
String[]
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Aliasy:
Kn
Sady parametrů
class
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
path
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
WQLQuery
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
query
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
list
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
Typ:
SwitchParameter
Default value:
False
Podporuje zástupné znaky:
False
DontShow:
False
Aliasy:
viz
Sady parametrů
(All)
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-Credential
Určuje uživatelský účet, který má oprávnění k provedení této akce.
Výchozí hodnota je aktuální uživatel.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte PSCredential objekt, například objekt vygenerovaný rutinou Get-Credential.
Pokud zadáte uživatelské jméno, tato rutina zobrazí výzvu k zadání hesla.
Tento parametr nejsou podporovány žádnými poskytovateli nainstalovanými s parametrem nejsou podporovány žádnými poskytovateli nainstalovanými v prostředí Windows PowerShell.
Vlastnosti parametru
Typ:
PSCredential
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
class
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
path
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
WQLQuery
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
query
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
list
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-EnableAllPrivileges
Označuje, že tato rutina povolí všechna oprávnění aktuálního uživatele před příkazem, který provede volání rozhraní WMI.
Vlastnosti parametru
Typ:
SwitchParameter
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
class
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
path
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
WQLQuery
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
query
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
list
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-Impersonation
Určuje úroveň zosobnění, která se má použít.
Přijatelné hodnoty pro tento parametr jsou:
0: Výchozí.
Přečte místní registr pro výchozí úroveň zosobnění, která je obvykle nastavená na 3: Zosobnění.
1: Anonymní.
Skryje přihlašovací údaje volajícího.
2: Identifikace.
Umožňuje objektům dotazovat přihlašovací údaje volajícího.
3: Zosobnění.
Umožňuje objektům používat přihlašovací údaje volajícího.
4: Delegát.
Umožňuje objektům povolit, aby jiné objekty používaly přihlašovací údaje volajícího.
Určuje objekt ManagementObject, který se má použít jako vstup.
Při použití tohoto parametru se ignorují všechny ostatní parametry s výjimkou parametru Argumenty.
Vlastnosti parametru
Typ:
ManagementObject
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
object
Position:
Named
Povinné:
True
Hodnota z kanálu:
True
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-Locale
Určuje upřednostňované národní prostředí pro objekty WMI.
Parametr národního prostředí je zadán v poli ve formátu MS_LCID v upřednostňovaném pořadí.
Vlastnosti parametru
Typ:
String
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
class
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
path
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
WQLQuery
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
query
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
list
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-Namespace
Určuje obor názvů úložiště rozhraní WMI, kde se při použití s parametrem Class nachází odkazovaná třída rozhraní WMI.
Vlastnosti parametru
Typ:
String
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Aliasy:
NS
Sady parametrů
class
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
path
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
WQLQuery
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
query
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
list
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-Path
Určuje cestu objektu WMI instance, kterou chcete vytvořit nebo aktualizovat.
Vlastnosti parametru
Typ:
String
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
path
Position:
Named
Povinné:
True
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-PutType
Určuje, zda se má vytvořit nebo aktualizovat instance rozhraní WMI.
Přijatelné hodnoty pro tento parametr jsou:
Pouze aktualizace.
Aktualizuje existující instanci služby WMI.
CreateOnly.
Vytvoří novou instanci rozhraní WMI.
UpdateOrCreate.
Aktualizuje instanci služby WMI, pokud existuje nebo vytvoří novou instanci, pokud instance neexistuje.
Vlastnosti parametru
Typ:
PutType
Default value:
None
Přípustné hodnoty:
None, UpdateOnly, CreateOnly, UpdateOrCreate
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
(All)
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-ThrottleLimit
Určuje maximální počet souběžných připojení, která lze navázat pro spuštění tohoto příkazu.
Tento parametr se používá společně s parametrem AsJob.
Omezení se vztahuje pouze na aktuální příkaz, ne na relaci nebo na počítač.
Vlastnosti parametru
Typ:
Int32
Default value:
None
Podporuje zástupné znaky:
False
DontShow:
False
Sady parametrů
(All)
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
-WhatIf
Ukazuje, co se stane, když se příkaz spustí.
Příkazový modul nebyl spuštěn.
Vlastnosti parametru
Typ:
SwitchParameter
Default value:
False
Podporuje zástupné znaky:
False
DontShow:
False
Aliasy:
Wi
Sady parametrů
(All)
Position:
Named
Povinné:
False
Hodnota z kanálu:
False
Hodnota z kanálu podle názvu vlastnosti:
False
Hodnota ze zbývajících argumentů:
False
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.