Invoke-Command
Spouští příkazy na místních a vzdálených počítačích.
Syntax
InProcess (Výchozí)
Invoke-Command
[-ScriptBlock] <ScriptBlock>
[-NoNewScope]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
Session
Invoke-Command
[[-Session] <PSSession[]>]
[-ScriptBlock] <ScriptBlock>
[-ThrottleLimit <Int32>]
[-AsJob]
[-HideComputerName]
[-JobName <String>]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
FilePathRunspace
Invoke-Command
[[-Session] <PSSession[]>]
[-FilePath] <String>
[-ThrottleLimit <Int32>]
[-AsJob]
[-HideComputerName]
[-JobName <String>]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
FilePathComputerName
Invoke-Command
[[-ComputerName] <String[]>]
[-FilePath] <String>
[-Credential <PSCredential>]
[-Port <Int32>]
[-UseSSL]
[-ConfigurationName <String>]
[-ApplicationName <String>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-InDisconnectedSession]
[-SessionName <String[]>]
[-HideComputerName]
[-JobName <String>]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-EnableNetworkAccess]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
ComputerName
Invoke-Command
[[-ComputerName] <String[]>]
[-ScriptBlock] <ScriptBlock>
[-Credential <PSCredential>]
[-Port <Int32>]
[-UseSSL]
[-ConfigurationName <String>]
[-ApplicationName <String>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-InDisconnectedSession]
[-SessionName <String[]>]
[-HideComputerName]
[-JobName <String>]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-EnableNetworkAccess]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Uri
Invoke-Command
[[-ConnectionUri] <Uri[]>]
[-ScriptBlock] <ScriptBlock>
[-Credential <PSCredential>]
[-ConfigurationName <String>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-InDisconnectedSession]
[-HideComputerName]
[-JobName <String>]
[-AllowRedirection]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-EnableNetworkAccess]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
FilePathUri
Invoke-Command
[[-ConnectionUri] <Uri[]>]
[-FilePath] <String>
[-Credential <PSCredential>]
[-ConfigurationName <String>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-InDisconnectedSession]
[-HideComputerName]
[-JobName <String>]
[-AllowRedirection]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-EnableNetworkAccess]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
VMId
Invoke-Command
[-ScriptBlock] <ScriptBlock>
[-VMGuid] <Guid[]>
-Credential <PSCredential>
[-ThrottleLimit <Int32>]
[-AsJob]
[-HideComputerName]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
VMName
Invoke-Command
[-ScriptBlock] <ScriptBlock>
-Credential <PSCredential>
-VMName <String[]>
[-ThrottleLimit <Int32>]
[-AsJob]
[-HideComputerName]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
FilePathVMId
Invoke-Command
[-FilePath] <String>
[-VMGuid] <Guid[]>
-Credential <PSCredential>
[-ThrottleLimit <Int32>]
[-AsJob]
[-HideComputerName]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
FilePathVMName
Invoke-Command
[-FilePath] <String>
-Credential <PSCredential>
-VMName <String[]>
[-ThrottleLimit <Int32>]
[-AsJob]
[-HideComputerName]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[<CommonParameters>]
Description
Rutina Invoke-Command spouští příkazy na místním nebo vzdáleném počítači a vrací veškerý výstup z příkazů, včetně chyb. Pomocí jednoho Invoke-Command příkazu můžete spouštět příkazy na více počítačích.
Pokud chcete na vzdáleném počítači spustit jeden příkaz, použijte parametr ComputerName . Pokud chcete spustit řadu souvisejících příkazů, které sdílejí data, použijte rutinu k vytvoření New-PSSession (trvalé připojení) na vzdáleném počítači a pak pomocí parametru Relace spusťte příkaz v Invoke-Command. Pokud chcete spustit příkaz v odpojené relaci, použijte parametr InDisconnectedSession . Pokud chcete spustit příkaz v úloze na pozadí, použijte parametr AsJob .
Blok skriptu můžete také použít Invoke-Command v místním počítači jako příkaz. PowerShell spustí blok skriptu okamžitě v podřízené oblasti aktuálního oboru.
Před spuštěním Invoke-Command příkazů na vzdáleném počítači si přečtěte about_Remote.
Některé vzorové kódy používají k zmenšení délky řádku splatting. Další informace naleznete v části s názvem about_Splatting.
Příklady
Příklad 1: Spuštění skriptu na serveru
Tento příklad spustí Test.ps1 skript na počítači Server01.
Invoke-Command -FilePath c:\scripts\test.ps1 -ComputerName Server01
Parametr FilePath určuje skript umístěný v místním počítači. Skript běží na vzdáleném počítači a výsledky se vrátí do místního počítače.
Příklad 2: Spuštění příkazu na vzdáleném serveru
Tento příklad spustí Get-Culture příkaz na vzdáleném počítači Server01.
Invoke-Command -ComputerName Server01 -Credential Domain01\User01 -ScriptBlock { Get-Culture }
Parametr ComputerName určuje název vzdáleného počítače. Parametr Credential se používá ke spuštění příkazu v kontextu zabezpečení Domain01\User01, který má oprávnění ke spouštění příkazů. Parametr ScriptBlock určuje příkaz, který se má spustit ve vzdáleném počítači.
V reakci powershell požaduje heslo a metodu ověřování pro účet User01. Potom spustí příkaz na počítači Server01 a vrátí výsledek.
Příklad 3: Spuštění příkazu v trvalém připojení
Tento příklad spustí stejný Get-Culture příkaz v relaci pomocí trvalého připojení na vzdáleném počítači s názvem Server02.
$s = New-PSSession -ComputerName Server02 -Credential Domain01\User01
Invoke-Command -Session $s -ScriptBlock {Get-Culture}
Rutina New-PSSession vytvoří relaci na vzdáleném počítači Server02 a uloží ji do $s proměnné. Relaci obvykle vytvoříte jenom v případě, že na vzdáleném počítači spustíte řadu příkazů.
Rutina Invoke-Command spustí Get-Culture příkaz na serveru Server02. Parametr Relace určuje relaci uloženou $s v proměnné.
V reakci powershell spustí příkaz v relaci na počítači se serverem Server02.
Příklad 4: Použití relace ke spuštění řady příkazů, které sdílejí data
Tento příklad porovnává účinky použití ComputerName a Parametry relace parametru Invoke-Command. Ukazuje, jak pomocí relace spustit řadu příkazů, které sdílejí stejná data.
Invoke-Command -ComputerName Server02 -ScriptBlock {$p = Get-Process PowerShell}
Invoke-Command -ComputerName Server02 -ScriptBlock {$p.VirtualMemorySize}
$s = New-PSSession -ComputerName Server02
Invoke-Command -Session $s -ScriptBlock {$p = Get-Process PowerShell}
Invoke-Command -Session $s -ScriptBlock {$p.VirtualMemorySize}
17930240
První dva příkazy používají ke spouštění příkazů na vzdáleném počítači Server02. První příkaz pomocí rutiny Get-Process získá proces PowerShellu na vzdáleném počítači a uloží ho $p do proměnné. Druhý příkaz získá hodnotu Vlastnosti VirtualMemorySize procesu PowerShellu.
Při použití parametru ComputerName vytvoří PowerShell novou relaci pro spuštění příkazu.
Relace se po dokončení příkazu zavře. Proměnná $p byla vytvořena v jednom připojení, ale v připojení vytvořeném pro druhý příkaz neexistuje.
Problém je vyřešen vytvořením trvalé relace na vzdáleném počítači a spuštěním obou příkazů ve stejné relaci.
Rutina New-PSSession vytvoří trvalou relaci na počítači Server02 a uloží relaci do $s proměnné. Následující Invoke-Command řádky používají parametr Session ke spuštění obou příkazů ve stejné relaci. Vzhledem k tomu, že oba příkazy běží ve stejné relaci, $p zůstane hodnota aktivní.
Příklad 5: Zadejte příkaz uložený v místní proměnné.
Tento příklad ukazuje, jak vytvořit příkaz uložený jako blok skriptu v místní proměnné. Když je blok skriptu uložen v lokální proměnné, můžete tuto proměnnou určit jako hodnotu parametru ScriptBlock .
$command = { Get-EventLog -LogName "Windows PowerShell" |
Where-Object {$_.Message -like "*certificate*"} }
Invoke-Command -ComputerName S1, S2 -ScriptBlock $command
Proměnná $command ukládá Get-EventLog příkaz, který je formátovaný jako blok skriptu. Spustí Invoke-Command příkaz uložený ve $command vzdálených počítačích S1 a S2.
Příklad 6: Spuštění jednoho příkazu na několika počítačích
Tento příklad ukazuje, jak použít Invoke-Command ke spuštění jednoho příkazu na více počítačích.
$parameters = @{
ComputerName = "Server01", "Server02", "TST-0143", "localhost"
ConfigurationName = 'MySession.PowerShell'
ScriptBlock = { Get-EventLog "Windows PowerShell" }
}
Invoke-Command @parameters
Parametr ComputerName určuje seznam názvů počítačů oddělených čárkami. Seznam počítačů obsahuje hodnotu localhost, která představuje místní počítač. Parametr ConfigurationName určuje alternativní konfiguraci relace. Parametr ScriptBlock se spustí Get-EventLog pro získání protokolů událostí Prostředí Windows PowerShell z každého počítače.
Příklad 7: Získání verze hostitelského programu na více počítačích
Tento příklad získá verzi hostitelského programu PowerShellu běžícího na 200 vzdálených počítačích.
$version = Invoke-Command -ComputerName (Get-Content Machines.txt) -ScriptBlock {(Get-Host).Version}
Protože je spuštěn pouze jeden příkaz, nemusíte vytvářet trvalá připojení ke každému počítači. Místo toho příkaz používá k označení počítačů parametr ComputerName . K určení počítačů používá rutinu Get-Content k získání obsahu souboru Machine.txt, souboru názvů počítačů.
Rutina Invoke-Command spustí Get-Host příkaz na vzdálených počítačích. K získání vlastnosti Version hostitele PowerShellu používá zápis tečky.
Tyto příkazy běží po jednom. Po dokončení příkazů se výstup příkazů ze všech počítačů uloží do $version proměnné. Výstup obsahuje název počítače, ze kterého data pocházejí.
Příklad 8: Spuštění úlohy na pozadí na několika vzdálených počítačích
Tento příklad spustí příkaz na dvou vzdálených počítačích. Příkaz Invoke-Command používá parametr AsJob , aby se příkaz spustil jako úloha na pozadí. Příkazy běží na vzdálených počítačích, ale úloha existuje na místním počítači. Výsledky se přenesou do místního počítače.
$s = New-PSSession -ComputerName Server01, Server02
Invoke-Command -Session $s -ScriptBlock {Get-EventLog system} -AsJob
Id Name State HasMoreData Location Command
--- ---- ----- ----- ----------- ---------------
1 Job1 Running True Server01,Server02 Get-EventLog system
$j = Get-Job
$j | Format-List -Property *
HasMoreData : True
StatusMessage :
Location : Server01,Server02
Command : Get-EventLog system
JobStateInfo : Running
Finished : System.Threading.ManualResetEvent
InstanceId : e124bb59-8cb2-498b-a0d2-2e07d4e030ca
Id : 1
Name : Job1
ChildJobs : {Job2, Job3}
Output : {}
Error : {}
Progress : {}
Verbose : {}
Debug : {}
Warning : {}
StateChanged :
$results = $j | Receive-Job
Rutina New-PSSession vytvoří relace na vzdálených počítačích Server01 a Server02. Rutina Invoke-Command spustí úlohu na pozadí v každé relaci. Příkaz používá parametr AsJob ke spuštění příkazu jako úlohu na pozadí. Tento příkaz vrátí objekt úlohy, který obsahuje dva podřízené objekty úlohy, jeden pro každou úlohu spuštěnou na dvou vzdálených počítačích.
Příkaz Get-Job uloží objekt úlohy do $j proměnné. Proměnná $j se pak předá do Format-List rutiny, aby se zobrazily všechny vlastnosti objektu úlohy v seznamu. Poslední příkaz získá výsledky úloh. Předá objekt $j úlohy do Receive-Job rutiny a uloží výsledky do $results proměnné.
Příklad 9: Zahrnutí místních proměnných do příkazu spuštěného na vzdáleném počítači
Tento příklad ukazuje, jak zahrnout hodnoty místních proměnných do příkazu spuštěného ve vzdáleném počítači. Příkaz používá Using modifikátor oboru k identifikaci místní proměnné ve vzdáleném příkazu. Ve výchozím nastavení se předpokládá, že všechny proměnné budou definovány ve vzdálené relaci. Modifikátor oboru Using byl zaveden v PowerShellu 3.0. Další informace o modifikátoru Using oboru najdete v tématu about_Remote_Variables a about_Scopes.
$Log = "Windows PowerShell"
Invoke-Command -ComputerName Server01 -ScriptBlock { Get-EventLog -LogName $Using:Log -Newest 10 }
Proměnná $Log ukládá název protokolu událostí, Windows PowerShell. Rutina Invoke-Command běží Get-EventLog na Serveru01, aby získala deset nejnovějších událostí z protokolu událostí. Hodnota parametru LogName je $Log proměnná, která je předponou Using modifikátoru oboru, která označuje, že byla vytvořena v místní relaci, nikoli ve vzdálené relaci.
Příklad 10: Skrytí názvu počítače
Tento příklad ukazuje účinek použití HideComputerName parametru Invoke-Command.
HideComputerName nemění objekt, který tato rutina vrací. Změní se jenom zobrazení. Pomocí rutin Format můžete stále zobrazit vlastnost PsComputerName libovolného ovlivněného objektu.
Invoke-Command -ComputerName S1, S2 -ScriptBlock {Get-Process PowerShell}
PSComputerName Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
-------------- ------- ------ ----- ----- ----- ------ -- -----------
S1 575 15 45100 40988 200 4.68 1392 PowerShell
S2 777 14 35100 30988 150 3.68 67 PowerShell
Invoke-Command -ComputerName S1, S2 -ScriptBlock {Get-Process PowerShell} -HideComputerName
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
575 15 45100 40988 200 4.68 1392 PowerShell
777 14 35100 30988 150 3.68 67 PowerShell
První dva příkazy slouží Invoke-Command ke spuštění Get-Process příkazu pro proces PowerShellu. Výstup prvního příkazu zahrnuje PsComputerName vlastnost, která obsahuje název počítače, na kterém byl příkaz spuštěn. Výstup druhého příkazu, který používá HideComputerName, nezahrnuje sloupec PsComputerName .
Příklad 11: Použití klíčového slova Param v bloku skriptu
Klíčové Param slovo a parametr ArgumentList slouží k předání hodnot proměnných pojmenovaným parametrům v bloku skriptu. V tomto příkladu jsou zobrazeny názvy souborů, které začínají písmenem a a mají příponu .pdf .
Další informace o klíčovém slově Param najdete v tématu about_Language_Keywords.
$parameters = @{
ComputerName = "Server01"
ScriptBlock = { Param ($param1,$param2) Get-ChildItem -Name $param1 -Include $param2 }
ArgumentList = "a*", "*.pdf"
}
Invoke-Command @parameters
aa.pdf
ab.pdf
ac.pdf
az.pdf
Invoke-Command
používá Parametr ScriptBlock, který definuje dvě proměnné a $param1$param2.
Get-ChildItem používá pojmenované parametry, Name a Include s názvy proměnných. ArgumentList předá hodnoty proměnným.
Příklad 12: Použití $args automatické proměnné v bloku skriptu
Automatická $args proměnná a parametr ArgumentList slouží k předávání hodnot pole do pozic parametrů v bloku skriptu. Tento příklad zobrazuje obsah .txt adresáře serveru souborů. Parametr Get-ChildItemPath je pozice 0 a parametr Filter je pozice 1.
Další informace o $args proměnné najdete v tématu about_Automatic_Variables
$parameters = @{
ComputerName = "Server01"
ScriptBlock = { Get-ChildItem $args[0] $args[1] }
ArgumentList = "C:\Test", "*.txt*"
}
Invoke-Command @parameters
Directory: C:\Test
Mode LastWriteTime Length Name
---- ------------- ------ ----
-a--- 6/12/2019 15:15 128 alog.txt
-a--- 7/27/2019 15:16 256 blog.txt
-a--- 9/28/2019 17:10 64 zlog.txt
Invoke-Command
používá parametr ScriptBlock a Get-ChildItem určuje $args[0] hodnoty pole.$args[1] ArgumentList předá $args hodnoty Get-ChildItem pole do pozic parametrů pro Path a Filter.
Příklad 13: Spuštění skriptu na všech počítačích uvedených v textovém souboru
Tento příklad používá rutinu Invoke-CommandSample.ps1 ke spuštění skriptu na všech počítačích uvedených v Servers.txt souboru. Příkaz používá parametr FilePath k určení souboru skriptu. Tento příkaz umožňuje spustit skript na vzdálených počítačích, i když soubor skriptu není přístupný vzdáleným počítačům.
Invoke-Command -ComputerName (Get-Content Servers.txt) -FilePath C:\Scripts\Sample.ps1 -ArgumentList Process, Service
Když příkaz odešlete, obsah Sample.ps1 souboru se zkopíruje do bloku skriptu a blok skriptu se spustí na každém ze vzdálených počítačů. Tento postup je ekvivalentní použití parametru ScriptBlock k odeslání obsahu skriptu.
Příklad 14: Spuštění příkazu na vzdáleném počítači pomocí identifikátoru URI
Tento příklad ukazuje, jak spustit příkaz na vzdáleném počítači, který je identifikován identifikátorem URI (Uniform Resource Identifier). Tento konkrétní příklad spustí Set-Mailbox příkaz na vzdáleném serveru Exchange.
$LiveCred = Get-Credential
$parameters = @{
ConfigurationName = 'Microsoft.Exchange'
ConnectionUri = 'https://ps.exchangelabs.com/PowerShell'
Credential = $LiveCred
Authentication = 'Basic'
ScriptBlock = {Set-Mailbox Dan -DisplayName "Dan Park"}
}
Invoke-Command @parameters
První řádek používá rutinu Get-Credential k uložení přihlašovacích údajů Windows Live ID do $LiveCred proměnné. PowerShell vyzve uživatele k zadání přihlašovacích údajů windows Live ID.
Proměnná $parameters je tabulka hash obsahující parametry, které se mají předat rutině Invoke-Command . Rutina Invoke-Command spustí Set-Mailbox příkaz pomocí konfigurace relace Microsoft.Exchange . Parametr ConnectionURI určuje adresu URL koncového bodu serveru Exchange. Parametr Credential určuje přihlašovací údaje uložené v $LiveCred proměnné. Parametr AuthenticationMechanism určuje použití základního ověřování. Parametr ScriptBlock určuje blok skriptu, který obsahuje příkaz.
Příklad 15: Použití možnosti relace
Tento příklad ukazuje, jak vytvořit a použít Parametr SessionOption .
$so = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck
Invoke-Command -ComputerName server01 -UseSSL -ScriptBlock { Get-HotFix } -SessionOption $so -Credential server01\user01
Rutina New-PSSessionOption vytvoří objekt možnosti relace, který způsobí, že vzdálený konec neověří certifikační autoritu, canonický název a seznamy odvolaných certifikátů při vyhodnocování příchozího připojení HTTPS. Objekt SessionOption je uložen v $so proměnné.
Poznámka:
Zakázání těchto kontrol je vhodné pro řešení potíží, ale samozřejmě není bezpečné.
Rutina Invoke-Command spustí Get-HotFix příkaz vzdáleně. Parametr SessionOption má proměnnou $so .
Příklad 16: Správa přesměrování identifikátoru URI ve vzdáleném příkazu
Tento příklad ukazuje, jak pomocí parametrů AllowRedirection a SessionOption spravovat přesměrování identifikátoru URI ve vzdáleném příkazu.
$max = New-PSSessionOption -MaximumRedirection 1
$parameters = @{
ConnectionUri = "https://ps.exchangelabs.com/PowerShell"
ScriptBlock = { Get-Mailbox dan }
AllowRedirection = $true
SessionOption = $max
}
Invoke-Command @parameters
Rutina New-PSSessionOption vytvoří objekt PSSessionOption , který je uložen v $max proměnné. Příkaz používá MaximumRedirection parametr nastavit MaximumConnectionRedirectionCount vlastnost PSSessionOption objektu na 1.
Rutina Invoke-Command spustí Get-Mailbox příkaz na vzdáleném serveru Microsoft Exchange Server. Parametr AllowRedirection poskytuje explicitní oprávnění k přesměrování připojení na alternativní koncový bod. Parametr SessionOption používá objekt relace uložený v $max proměnné.
V důsledku toho, pokud vzdálený počítač určený identifikátorem ConnectionURI vrátí zprávu přesměrování, PowerShell přesměruje připojení, ale pokud nový cíl vrátí jinou zprávu přesměrování, je překročena hodnota počtu přesměrování 1 a Invoke-Command vrátí neukončující chybu.
Příklad 17: Přístup ke sdílené síťové složce ve vzdálené relaci
Tento příklad ukazuje, jak získat přístup ke sdílené síťové složce ze vzdálené relace. K předvedení příkladu se používají tři počítače. Server01 je místní počítač, Server02 je vzdálený počítač a Net03 obsahuje sdílenou síťovou složku. Server01 se připojí k Serveru02 a server02 provede druhý segment směrování na Net03 pro přístup ke sdílené síťové složce. Další informace o tom, jak vzdálené komunikace Prostředí PowerShell podporuje směrování mezi počítači, najdete v tématu Vytvoření druhého segmentu směrování v vzdálené komunikace Prostředí PowerShell.
Požadované delegování zprostředkovatele podpory zabezpečení přihlašovacích údajů (CredSSP) je povolené v nastavení klienta na místním počítači a v nastavení služby na vzdáleném počítači. Chcete-li spustit příkazy v tomto příkladu, musíte být členem skupiny Administrators v místním počítači a ve vzdáleném počítači.
Enable-WSManCredSSP -Role Client -DelegateComputer Server02
$s = New-PSSession Server02
Invoke-Command -Session $s -ScriptBlock {Enable-WSManCredSSP -Role Server -Force}
$parameters = @{
Session = $s
ScriptBlock = { Get-Item \\Net03\Scripts\LogFiles.ps1 }
Authentication = "CredSSP"
Credential = "Domain01\Admin01"
}
Invoke-Command @parameters
Rutina Enable-WSManCredSSP umožňuje delegování CredSSP z místního počítače Serveru01 na vzdálený počítač Server02. Parametr role určuje klienta pro konfiguraci nastavení klienta CredSSP v místním počítači.
New-PSSession
vytvoří objekt PSSession pro Server02 a uloží objekt do $s proměnné.
Rutina Invoke-Command používá proměnnou $s pro připojení ke vzdálenému počítači Server02. Parametr ScriptBlock spustí Enable-WSManCredSSP na vzdáleném počítači. Parametr role určuje Server pro konfiguraci nastavení serveru CredSSP na vzdáleném počítači.
Proměnná $parameters obsahuje hodnoty parametrů pro připojení ke sdílené síťové složce. Rutina Invoke-Command spustí Get-Item příkaz v relaci v $s. Tento příkaz získá skript ze \\Net03\Scripts sdílené síťové složky. Příkaz používá parametr Authentication s hodnotou CredSSP a parametr Credential s hodnotou Domain01\Admin01.
Příklad 18: Spuštění skriptů na mnoha vzdálených počítačích
Tento příklad spustí skript na více než sto počítačích. Pokud chcete minimalizovat dopad na místní počítač, připojí se ke každému počítači, spustí skript a pak se odpojí od každého počítače. Skript se bude dál spouštět v odpojených relacích.
$parameters = @{
ComputerName = (Get-Content -Path C:\Test\Servers.txt)
InDisconnectedSession = $true
FilePath = "\\Scripts\Public\ConfigInventory.ps1"
SessionOption = @{OutputBufferingMode="Drop";IdleTimeout=43200000}
}
Invoke-Command @parameters
Příkaz používá Invoke-Command ke spuštění skriptu. Hodnota parametru ComputerName je Get-Content příkaz, který získá názvy vzdálených počítačů z textového souboru. Parametr InDisconnectedSession odpojí relace hned po spuštění příkazu. Hodnota parametru FilePath je skript, který Invoke-Command běží na každém počítači.
Hodnota SessionOption je tabulka hash. Hodnota OutputBufferingMode je nastavena na hodnotu Drop a hodnota IdleTimeout je nastavena na 43200000 milisekund (12 hodin).
Pokud chcete získat výsledky příkazů a skriptů, které se spouští v odpojených relacích, použijte tuto rutinu Receive-PSSession .
Parametry
-AllowRedirection
Umožňuje přesměrování tohoto připojení na alternativní identifikátor URI (Uniform Resource Identifier).
Pokud použijete parametr ConnectionURI, vzdálený cíl může vrátit pokyn k přesměrování na jiný identifikátor URI. PowerShell ve výchozím nastavení nesměruje připojení, ale tento parametr můžete použít k povolení přesměrování připojení.
Můžete také omezit počet přesměrování připojení změnou nastavení hodnoty možnosti MaximumConnectionRedirectionCount relace. Použijte parametr MaximumRedirection rutiny New-PSSessionOption nebo nastavte vlastnost MaximumConnectionRedirectionCount proměnné předvolby $PSSessionOption. Výchozí hodnota je 5.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Uri
| 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 |
FilePathUri
| 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 |
-ApplicationName
Určuje segment názvu aplikace v URI připojení. Tento parametr použijte k určení názvu aplikace, pokud v příkazu nepoužíváte parametr ConnectionURI .
Výchozí hodnota je hodnota proměnné předvoleb $PSSessionApplicationName v místním počítači. Pokud tato proměnná předvoleb není definovaná, výchozí hodnota je WSMAN. Tato hodnota je vhodná pro většinu použití. Další informace najdete v části about_Preference_Variables.
Služba WinRM používá název aplikace k výběru naslouchacího procesu pro službu žádosti o připojení. Hodnota tohoto parametru by měla odpovídat hodnotě URLPrefix vlastnosti naslouchacího procesu ve vzdáleném počítači.
Vlastnosti parametru
| Typ: | String |
| Default value: | $PSSessionApplicationName if set on the local computer, otherwise WSMAN |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
FilePathComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-ArgumentList
Poskytuje hodnoty místních proměnných v příkazu. Proměnné v příkazu se před spuštěním příkazu na vzdáleném počítači nahradí těmito hodnotami. Zadejte hodnoty v seznamu odděleném čárkami. Hodnoty jsou přidružené k proměnným v pořadí, v jakém jsou uvedeny. Alias pro ArgumentList je Args.
Hodnoty v parametru ArgumentList mohou být skutečné hodnoty, například 1024, nebo mohou být odkazy na místní proměnné, například $max.
Pokud chcete v příkazu použít místní proměnné, použijte následující formát příkazu:
{param($<name1>[, $<name2>]...) <command-with-local-variables>} -ArgumentList <value> -nebo- <local-variable>
Klíčové slovo param obsahuje seznam místních proměnných, které jsou použity v příkazu. ArgumentList poskytuje hodnoty proměnných v pořadí, v jakém jsou uvedeny.
Vlastnosti parametru
| Typ: | Object[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Argumenty |
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 |
-AsJob
Označuje, že tato rutina spustí příkaz jako úlohu na pozadí na vzdáleném počítači. Pomocí tohoto parametru můžete spouštět příkazy, které dlouho trvá dokončení.
Pokud použijete parametr AsJob , příkaz vrátí objekt, který představuje úlohu, a poté zobrazí příkazový řádek. Během dokončení úlohy můžete pokračovat v práci v relaci. Ke správě úlohy použijte *-Job rutiny. K získání výsledků úlohy použijte rutinu Receive-Job.
Parametr AsJob se podobá použití Invoke-Command rutiny ke vzdálenému Start-Job spuštění rutiny. S úlohou AsJob se však úloha vytvoří na místním počítači, i když úloha běží na vzdáleném počítači. Výsledky vzdálené úlohy se automaticky vrátí do místního počítače.
Další informace o úlohách na pozadí PowerShellu najdete v tématu about_Jobs a about_Remote_Jobs.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Session
| 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 |
FilePathRunspace
| 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 |
ComputerName
| 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 |
FilePathComputerName
| 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 |
FilePathVMName
| 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 |
FilePathUri
| 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 |
FilePathVMId
| 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 |
VMId
| 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 |
VMName
| 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 |
Uri
| 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 mechanismus, který se používá k ověření přihlašovacích údajů uživatele. Ověřování CredSSP je k dispozici pouze v systémech Windows Vista, Windows Server 2008 a novějších verzích operačního systému Windows.
Přijatelné hodnoty pro tento parametr jsou následující:
- Výchozí
- Basic
- Credssp
- Přehled
- Kerberos
- Vyjednávat
- VyjednávatSPodmíněnýmPověřením
Výchozí hodnota je Default.
Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism – výčet.
Upozornění
Ověřování zprostředkovatele podpory zabezpečení přihlašovacích údajů (CredSSP), ve kterém jsou přihlašovací údaje uživatele předány vzdálenému počítači pro ověření, je navrženo pro příkazy, které vyžadují ověření u více než jednoho prostředku, jako například přístup k síťové sdílené složce na dálku. Tento mechanismus zvyšuje riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, dají se k řízení síťové relace použít přihlašovací údaje, které jsou mu předány. Další informace najdete v tématu Zprostředkovatel podpory zabezpečení přihlašovacích údajů.
Vlastnosti parametru
| Typ: | AuthenticationMechanism |
| Default value: | Default |
| Přípustné hodnoty: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerName
| 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 |
FilePathComputerName
| 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 |
FilePathUri
| 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 |
Uri
| 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 |
-CertificateThumbprint
Určuje certifikát digitálního veřejného klíče (X509) uživatelského účtu, který má oprávnění k připojení k odpojené relaci. Zadejte kryptografický otisk certifikátu.
Certifikáty se používají při ověřování na základě klientských certifikátů. Dají se mapovat jenom na místní uživatelské účty a nefungují s doménovými účty.
Pokud chcete získat kryptografický otisk certifikátu, použijte Get-Item v jednotce PowerShell Cert: příkaz nebo Get-ChildItem příkaz.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerName
| 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 |
Uri
| 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 |
-ComputerName
Určuje počítače, na kterých se příkaz spouští. Výchozí hodnota je místní počítač.
Když použijete parametr ComputerName , PowerShell vytvoří dočasné připojení, které se použije pouze ke spuštění zadaného příkazu a pak se zavře. Pokud potřebujete trvalé připojení, použijte parametr Relace .
Do seznamu oddělených čárkami 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, localhost nebo tečku (.).
Pokud chcete použít IP adresu v hodnotě ComputerName, musí příkaz obsahovat parametr Credential . Počítač musí být nakonfigurovaný pro přenos HTTPS nebo musí být IP adresa vzdáleného počítače zahrnuta do seznamu důvěryhodných hostitelů WinRM místního počítače. Pokyny k přidání názvu počítače do seznamu TrustedHosts naleznete v tématu Postup přidání počítače do seznamu důvěryhodných hostitelů.
V systému Windows Vista a novějších verzích operačního systému Windows, pokud chcete zahrnout místní počítač do hodnoty ComputerName, musíte spustit PowerShell pomocí možnosti Spustit jako správce .
Vlastnosti parametru
| Typ: | String[] |
| Default value: | Local computer |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Kn |
Sady parametrů
ComputerName
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
FilePathComputerName
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ConfigurationName
Určuje konfiguraci relace, která se používá pro novou PSSession .
Zadejte název konfigurace nebo plně kvalifikovanou URI prostředku pro konfiguraci relace. Pokud zadáte pouze název konfigurace, předzálohuje se následující identifikátor URI schématu: https://schemas.microsoft.com/PowerShell.
Konfigurace relace relace se nachází ve vzdáleném počítači. Pokud zadaná konfigurace relace ve vzdáleném počítači neexistuje, příkaz selže.
Výchozí hodnota je hodnota proměnné předvoleb $PSSessionConfigurationName v místním počítači. Pokud tato proměnná předvoleb není nastavená, výchozí hodnota je Microsoft.PowerShell. Další informace najdete v části about_Preference_Variables.
Vlastnosti parametru
| Typ: | String |
| Default value: | $PSSessionConfigurationName if set on the local computer, otherwise Microsoft.PowerShell |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
FilePathComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
FilePathUri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
Uri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-ConnectionUri
Určuje identifikátor URI (Uniform Resource Identifier), který definuje koncový bod připojení relace. Identifikátor URI musí být plně kvalifikovaný.
Formát tohoto řetězce je následující:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
Výchozí hodnota je následující:
https://localhost:5985/WSMAN
Pokud nezadáte identifikátor URI připojení, můžete k určení hodnot identifikátoru URI připojení použít parametry UseSSL a Port .
Platné hodnoty pro segment Transport identifikátoru URI jsou HTTP a HTTPS. Pokud zadáte identifikátor URI připojení s přenosovým segmentem, ale nezadáte port, relace se vytvoří s porty standardů: 80 pro HTTP a 443 pro HTTPS. Pokud chcete použít výchozí porty pro vzdálené komunikace PowerShellu, zadejte port 5985 pro HTTP nebo 5986 pro HTTPS.
Pokud cílový počítač přesměruje připojení na jiný identifikátor URI, PowerShell zabrání přesměrování, pokud v příkazu nepoužijete parametr AllowRedirection.
Vlastnosti parametru
| Typ: | Uri[] |
| Default value: | https://localhost:5985/WSMAN |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | identifikátor URI, CU |
Sady parametrů
FilePathUri
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
Uri
| Position: | 0 |
| 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 objekt PSCredential, například objekt vygenerovaný rutinou Get-Credential. Pokud zadáte uživatelské jméno, tato rutina vás vyzve k zadání hesla.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | Current user |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
FilePathComputerName
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
Uri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
FilePathUri
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMName
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
FilePathVMId
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
FilePathVMName
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-EnableNetworkAccess
Označuje, že tato rutina přidá interaktivní token zabezpečení do relací zpětné smyčky. Interaktivní token umožňuje spouštět příkazy v relaci zpětné smyčky, které získávají data z jiných počítačů. Můžete například spustit příkaz v relaci, která kopíruje soubory XML ze vzdáleného počítače do místního počítače.
Relace zpětné smyčky je PSSession, která pochází a končí na stejném počítači. Pokud chcete vytvořit relaci zpětné smyčky, vynecháte parametr ComputerName nebo nastavte jeho hodnotu na tečku (.), localhost nebo název místního počítače.
Ve výchozím nastavení se relace zpětné smyčky vytvářejí pomocí síťového tokenu, který nemusí poskytovat dostatečná oprávnění k ověření ve vzdálených počítačích.
Parametr EnableNetworkAccess je efektivní pouze v relacích zpětné smyčky. Pokud při vytváření relace na vzdáleném počítači používáte EnableNetworkAccess, příkaz bude úspěšný, ale parametr bude ignorován.
Vzdálený přístup v relaci zpětné smyčky můžete povolit pomocí hodnoty CredSSP parametru Authentication , který deleguje přihlašovací údaje relace na jiné počítače.
Z důvodu ochrany počítače před škodlivým přístupem lze odpojené relace zpětné smyčky, které mají interaktivní tokeny, což jsou tokeny vytvořené pomocí nástroje EnableNetworkAccess, znovu připojit pouze z počítače, na kterém byla relace vytvořena. Odpojené relace, které používají ověřování CredSSP, je možné znovu připojit z jiných počítačů. Další informace najdete v tématu Disconnect-PSSession.
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerName
| 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 |
FilePathComputerName
| 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 |
FilePathUri
| 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 |
Uri
| 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 |
-FilePath
Určuje místní skript, který tato rutina spouští na jednom nebo více vzdálených počítačích. Zadejte cestu a název souboru skriptu nebo cestu ke skriptu přesměrujte do Invoke-Command. Skript musí být umístěn v místním počítači nebo v adresáři, ke kterému má místní počítač přístup. Pomocí argumentu ArgumentList zadejte hodnoty parametrů ve skriptu.
Při použití tohoto parametru PowerShell převede obsah zadaného souboru skriptu na blok skriptu, přenese blok skriptu do vzdáleného počítače a spustí ho na vzdáleném počítači.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | PSPath |
Sady parametrů
FilePathRunspace
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
FilePathComputerName
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
FilePathVMName
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
FilePathUri
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
FilePathVMId
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-HideComputerName
Označuje, že tato rutina vynechá název počítače každého objektu z zobrazení výstupu. Ve výchozím nastavení se v zobrazení zobrazí název počítače, který objekt vygeneroval.
Tento parametr má vliv pouze na zobrazení výstupu. Objekt se nezmění.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | HCN |
Sady parametrů
Session
| 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 |
FilePathRunspace
| 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 |
ComputerName
| 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 |
FilePathComputerName
| 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 |
FilePathVMName
| 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 |
FilePathUri
| 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 |
FilePathVMId
| 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 |
VMId
| 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 |
VMName
| 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 |
Uri
| 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 |
-InDisconnectedSession
Označuje, že tato rutina spouští příkaz nebo skript v odpojené relaci.
Pokud použijete parametr InDisconnectedSession , Invoke-Command vytvoří trvalou relaci na každém vzdáleném počítači, spustí příkaz určený parametrem ScriptBlock nebo FilePath a pak se odpojí od relace. Příkazy se budou dál spouštět v odpojených relacích.
InDisconnectedSession umožňuje spouštět příkazy bez zachování připojení ke vzdáleným relacím. A vzhledem k tomu, že relace je odpojena před vrácením výsledků, inDisconnectedSession zajistí, aby se všechny výsledky příkazů vrátily do znovu propojené relace, a ne rozdělení mezi relacemi.
InDisconnectedSession nemůžete použít s parametrem Session nebo parametrem AsJob.
Příkazy, které používají InDisconnectedSession vracejí objekt PSSession , který představuje odpojenou relaci. Nevrací výstup příkazu. Pokud se chcete připojit k odpojené relaci, použijte rutiny Connect-PSSessionReceive-PSSession . Pokud chcete získat výsledky příkazů spuštěných v relaci, použijte tuto rutinu Receive-PSSession . Chcete-li spustit příkazy, které generují výstup v odpojené relaci, nastavte hodnotu outputBufferingMode relace na hodnotu Drop. Pokud se chcete připojit k odpojené relaci, nastavte časový limit nečinnosti v relaci tak, abyste měli dostatek času na připojení před odstraněním relace.
Režim ukládání výstupu do vyrovnávací paměti a časový limit nečinnosti můžete nastavit v nebo v proměnné předvoleb. Další informace o možnostech relace najdete v tématu New-PSSessionOption a about_Preference_Variables.
Další informace o funkci Odpojené relace naleznete v tématu about_Remote_Disconnected_Sessions.
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Nesouvislý |
Sady parametrů
ComputerName
| 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 |
FilePathComputerName
| 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 |
FilePathUri
| 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 |
Uri
| 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 |
-InputObject
Určuje vstup pro příkaz. Zadejte proměnnou obsahující objekty nebo zadejte příkaz nebo výraz, který objekty získá.
Při použití InputObject parametru použijte $Input automatickou proměnnou v hodnotě ScriptBlock parametru představující vstupní objekty.
Vlastnosti parametru
| Typ: | PSObject |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-JobName
Určuje popisný název úlohy na pozadí. Ve výchozím nastavení jsou úlohy pojmenované Job<n>, kde <n> je pořadové číslo.
Pokud v příkazu použijete parametr JobName , příkaz se spustí jako úloha a Invoke-Command vrátí objekt úlohy, i když do příkazu nezahrnete AsJob .
Další informace o úlohách na pozadí PowerShellu najdete v tématu about_Jobs.
Vlastnosti parametru
| Typ: | String |
| Default value: | Job<n> |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Session
| 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 |
FilePathRunspace
| 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 |
ComputerName
| 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 |
FilePathComputerName
| 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 |
FilePathUri
| 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 |
Uri
| 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 |
-NoNewScope
Označuje, že tato rutina spouští zadaný příkaz v aktuálním oboru. Ve výchozím nastavení Invoke-Command spouští příkazy ve vlastním oboru.
Tento parametr je platný pouze v příkazech, které se spouští v aktuální relaci, tj. příkazy, které vynechají parametry ComputerName i Session .
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InProcess
| 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 |
-Port
Určuje síťový port na vzdáleném počítači, který se používá pro tento příkaz. Pokud se chcete připojit ke vzdálenému počítači, musí vzdálený počítač naslouchat na portu, který připojení používá. Výchozí porty jsou 5985, což je port WinRM pro HTTP a 5986, což je port WinRM pro HTTPS.
Před použitím alternativního portu nakonfigurujte naslouchací proces WinRM na vzdáleném počítači tak, aby naslouchal na tomto portu. Pokud chcete nakonfigurovat naslouchací proces, na příkazovém řádku PowerShellu zadejte následující dva příkazy:
Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse
New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>
Nepoužívejte parametr Port , pokud ho nepotřebujete. Port nastavený v příkazu se vztahuje na všechny počítače nebo relace, na kterých se příkaz spouští. Alternativní nastavení portu může zabránit spuštění příkazu na všech počítačích.
Vlastnosti parametru
| Typ: | Int32 |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerName
| 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 |
FilePathComputerName
| 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 |
-ScriptBlock
Určuje příkazy, které se mají spustit. Uzavřete příkazy do složených závorek { } a vytvořte blok skriptu.
Tento parametr je povinný.
Ve výchozím nastavení se na vzdáleném počítači vyhodnocují všechny proměnné v příkazu. Chcete-li do příkazu zahrnout místní proměnné, použijte ArgumentList.
Vlastnosti parametru
| Typ: | ScriptBlock |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Příkaz |
Sady parametrů
InProcess
| 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 |
Session
| 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
| 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 |
VMId
| 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 |
VMName
| 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 |
Uri
| 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 |
-Session
Určuje pole relací, ve kterých tato rutina spouští příkaz. Zadejte proměnnou, která obsahuje objekty PSSession nebo příkaz, který vytvoří nebo získá objekty PSSession, například New-PSSession příkaz nebo Get-PSSession příkaz.
Při vytváření psSession vytvoří PowerShell trvalé připojení ke vzdálenému počítači. Pomocí příkazu PSSession spusťte řadu souvisejících příkazů, které sdílejí data. Pokud chcete spustit jeden příkaz nebo řadu nesouvisejících příkazů, použijte parametr ComputerName . Další informace naleznete v tématu about_PSSessions.
Vlastnosti parametru
| Typ: | PSSession[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
FilePathRunspace
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
Session
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-SessionName
Určuje popisný název odpojené relace. Název můžete použít k odkazu na relaci v dalších příkazech, jako Get-PSSession je například příkaz. Tento parametr je platný pouze s parametrem InDisconnectedSession .
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerName
| 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 |
FilePathComputerName
| 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 |
-SessionOption
Určuje pokročilé možnosti relace. Zadejte objekt SessionOption, například objekt, který vytvoříte pomocí příkazu New-PSSessionOption, nebo tabulku hash, kde jsou klíče názvy možností relace a hodnoty jsou hodnoty možností relace.
Výchozí hodnoty možností jsou určeny hodnotou proměnné předvoleb $PSSessionOption, pokud je nastavená. V opačném případě se výchozí hodnoty vytvoří pomocí možností nastavených v konfiguraci relace.
Hodnoty možností relace mají přednost před výchozími hodnotami relace nastavenými v proměnné předvoleb $PSSessionOption a v konfiguraci relace. Nemají však přednost před maximálními hodnotami, kvótami nebo limity nastavenými v konfiguraci relace.
Popis možností relace, které obsahují výchozí hodnoty, najdete v tématu New-PSSessionOption. Informace o proměnné předvoleb $PSSessionOption naleznete v tématu about_Preference_Variables.
Další informace o konfiguracích relací naleznete v části about_Session_Configurations.
Vlastnosti parametru
| Typ: | PSSessionOption |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerName
| 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 |
FilePathComputerName
| 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 |
FilePathUri
| 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 |
Uri
| 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. Pokud tento parametr vynecháte nebo zadáte hodnotu 0, použije se výchozí hodnota 32.
Omezení se vztahuje pouze na aktuální příkaz, ne na relaci nebo na počítač.
Vlastnosti parametru
| Typ: | Int32 |
| Default value: | 32 |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Session
| 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 |
FilePathRunspace
| 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 |
ComputerName
| 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 |
FilePathComputerName
| 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 |
FilePathVMName
| 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 |
FilePathUri
| 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 |
FilePathVMId
| 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 |
VMId
| 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 |
VMName
| 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 |
Uri
| 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 |
-UseSSL
Označuje, že tato rutina používá protokol SSL (Secure Sockets Layer) k navázání připojení ke vzdálenému počítači. Ve výchozím nastavení se ssl nepoužívá.
WS-Management šifruje veškerý obsah PowerShellu přenášený přes síť. Parametr UseSSL je dodatečná ochrana, která odesílá data přes protokol HTTPS místo protokolu HTTP.
Pokud použijete tento parametr, ale ssl není k dispozici na portu použitém pro příkaz, příkaz selže.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
ComputerName
| 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 |
FilePathComputerName
| 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 |
-VMId
Určuje pole ID virtuálních počítačů.
Vlastnosti parametru
| Typ: | Guid[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
FilePathVMId
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMId
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-VMName
Určuje pole názvů virtuálních počítačů.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
FilePathVMName
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
VMName
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| 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.
Vstupy
ScriptBlock
Příkaz v bloku skriptu můžete převést na Invoke-Command. Použijte $Input automatickou proměnnou k reprezentaci vstupních objektů v příkazu.
Výstupy
System.Management.Automation.PSRemotingJob, System.Management.Automation.Runspaces.PSSession, or the output of the invoked command
Tato rutina vrátí objekt úlohy, pokud použijete parametr AsJob . Pokud zadáte parametr InDisconnectedSession , Invoke-Command vrátí objekt PSSession . V opačném případě vrátí výstup vyvolaného příkazu, což je hodnota parametru ScriptBlock .
Poznámky
V systému Windows Vista a novějších verzích operačního systému Windows je nutné použít parametr ComputerName ke spuštění příkazu na místním počítači, musíte spustit PowerShell pomocí Invoke-Command.
Když spustíte příkazy na více počítačích, PowerShell se připojí k počítačům v pořadí, v jakém se zobrazí v seznamu. Výstup příkazu se ale zobrazí v pořadí, v jakém se přijímá ze vzdálených počítačů, což se může lišit.
Chyby, které jsou výsledkem příkazu, které Invoke-Command jsou součástí výsledků příkazu.
Chyby, které by ukončovaly chyby v místním příkazu, se ve vzdáleném příkazu považují za neukončující chyby. Tato strategie zajišťuje, že ukončení chyb na jednom počítači nezavře příkaz na všech počítačích, na kterých je spuštěný. Tento postup se používá i v případě, že je vzdálený příkaz spuštěný na jednom počítači.
Pokud vzdálený počítač není v doméně, které důvěřuje místnímu počítači, nemusí být počítač schopen ověřit přihlašovací údaje uživatele. Chcete-li přidat vzdálený počítač do seznamu důvěryhodných hostitelů ve službě WS-Management, použijte v zprostředkovateli následující příkaz WSMAN , kde <Remote-Computer-Name> je název vzdáleného počítače:
Set-Item -Path WSMan:\Localhost\Client\TrustedHosts -Value \<Remote-Computer-Name\>
Když odpojíte psSession pomocí parametru InDisconnectedSession , stav relace je Odpojeno a dostupnost je Žádná. Hodnota vlastnosti State je vázaná na aktuální relaci. Hodnota Odpojeno znamená, že psSession není připojen k aktuální relaci. Neznamená to ale, že PSSession je odpojený ze všech relací. Může být připojeno k jiné relaci. Pokud chcete zjistit, jestli se k relaci můžete připojit nebo znovu připojit, použijte vlastnost Availability.
Hodnota dostupnost