Invoke-Command

Syntax

Invoke-Command
      [-ScriptBlock] <ScriptBlock>
      [-NoNewScope]
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      [<CommonParameters>]

Invoke-Command
      [[-Session] <PSSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-HideComputerName]
      [-JobName <String>]
      [-ScriptBlock] <ScriptBlock>
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      [<CommonParameters>]

Invoke-Command
      [[-Session] <PSSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-HideComputerName]
      [-JobName <String>]
      [-FilePath] <String>
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      [<CommonParameters>]

Invoke-Command
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-Port <Int32>]
      [-UseSSL]
      [-ConfigurationName <String>]
      [-ApplicationName <String>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-InDisconnectedSession]
      [-SessionName <String[]>]
      [-HideComputerName]
      [-JobName <String>]
      [-FilePath] <String>
      [-SessionOption <PSSessionOption>]
      [-Authentication <AuthenticationMechanism>]
      [-EnableNetworkAccess]
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      [<CommonParameters>]

Invoke-Command
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-Port <Int32>]
      [-UseSSL]
      [-ConfigurationName <String>]
      [-ApplicationName <String>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-InDisconnectedSession]
      [-SessionName <String[]>]
      [-HideComputerName]
      [-JobName <String>]
      [-ScriptBlock] <ScriptBlock>
      [-SessionOption <PSSessionOption>]
      [-Authentication <AuthenticationMechanism>]
      [-EnableNetworkAccess]
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Invoke-Command
      [-Credential <PSCredential>]
      [-ConfigurationName <String>]
      [-ThrottleLimit <Int32>]
      [[-ConnectionUri] <Uri[]>]
      [-AsJob]
      [-InDisconnectedSession]
      [-HideComputerName]
      [-JobName <String>]
      [-ScriptBlock] <ScriptBlock>
      [-AllowRedirection]
      [-SessionOption <PSSessionOption>]
      [-Authentication <AuthenticationMechanism>]
      [-EnableNetworkAccess]
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Invoke-Command
      [-Credential <PSCredential>]
      [-ConfigurationName <String>]
      [-ThrottleLimit <Int32>]
      [[-ConnectionUri] <Uri[]>]
      [-AsJob]
      [-InDisconnectedSession]
      [-HideComputerName]
      [-JobName <String>]
      [-FilePath] <String>
      [-AllowRedirection]
      [-SessionOption <PSSessionOption>]
      [-Authentication <AuthenticationMechanism>]
      [-EnableNetworkAccess]
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      [<CommonParameters>]

Invoke-Command
      -Credential <PSCredential>
      [-ConfigurationName <String>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-HideComputerName]
      [-ScriptBlock] <ScriptBlock>
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      [-VMId] <Guid[]>
      [<CommonParameters>]

Invoke-Command
      -Credential <PSCredential>
      [-ConfigurationName <String>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-HideComputerName]
      [-ScriptBlock] <ScriptBlock>
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      -VMName <String[]>
      [<CommonParameters>]

Invoke-Command
      -Credential <PSCredential>
      [-ConfigurationName <String>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-HideComputerName]
      [-FilePath] <String>
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      [-VMId] <Guid[]>
      [<CommonParameters>]

Invoke-Command
      -Credential <PSCredential>
      [-ConfigurationName <String>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-HideComputerName]
      [-FilePath] <String>
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      -VMName <String[]>
      [<CommonParameters>]

Invoke-Command
      [-ConfigurationName <String>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-HideComputerName]
      [-JobName <String>]
      [-ScriptBlock] <ScriptBlock>
      [-RunAsAdministrator]
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      -ContainerId <String[]>
      [<CommonParameters>]

Invoke-Command
      [-ConfigurationName <String>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-HideComputerName]
      [-JobName <String>]
      [-FilePath] <String>
      [-RunAsAdministrator]
      [-InputObject <PSObject>]
      [-ArgumentList <Object[]>]
      -ContainerId <String[]>
      [<CommonParameters>]

Beschreibung

Das Invoke-Command Cmdlet führt Befehle auf einem lokalen oder Remotecomputer aus und gibt alle Ausgaben der Befehle zurück, einschließlich Fehlern. Mit einem einzigen Invoke-Command Befehl können Sie Befehle auf mehreren Computern ausführen.

Verwenden Sie den Parameter "ComputerName ", um einen einzelnen Befehl auf einem Remotecomputer auszuführen. Um eine Reihe verwandter Befehle auszuführen, die Daten gemeinsam nutzen, verwenden Sie das New-PSSession Cmdlet, um eine PSSession (eine persistente Verbindung) auf dem Remotecomputer zu erstellen, und verwenden Sie dann den Session-Parameter , Invoke-Command um den Befehl in der PSSession auszuführen. Verwenden Sie den InDisconnectedSession-Parameter , um einen Befehl in einer getrennten Sitzung auszuführen. Verwenden Sie den AsJob-Parameter , um einen Befehl in einem Hintergrundauftrag auszuführen.

Sie können auch auf einem lokalen Computer zum Ausführen eines Skriptblocks als Befehl verwenden Invoke-Command . PowerShell führt den Skriptblock sofort in einem untergeordneten Bereich des aktuellen Bereichs aus.

Invoke-Command Bevor Sie Befehle auf einem Remotecomputer ausführen, lesen Sie about_Remote.

Einige Codebeispiele verwenden splatting, um die Zeilenlänge zu verringern. Weitere Informationen finden Sie unter about_Splatting.

Beispiele

Beispiel 1: Ausführen eines Skripts auf einem Server

In diesem Beispiel wird das Test.ps1 Skript auf dem Server01-Computer ausgeführt.

Invoke-Command -FilePath c:\scripts\test.ps1 -ComputerName Server01

Der Parameter FilePath gibt ein Skript an, das sich auf dem lokalen Computer befindet. Das Skript wird auf dem Remotecomputer ausgeführt, und die Ergebnisse werden an den lokalen Computer zurückgegeben.

Beispiel 2: Ausführen eines Befehls auf einem Remoteserver

In diesem Beispiel wird ein Get-Culture Befehl auf dem Remotecomputer Server01 ausgeführt.

Invoke-Command -ComputerName Server01 -Credential Domain01\User01 -ScriptBlock {
    Get-Culture
}

Der Parameter ComputerName gibt den Namen des Remotecomputers an. Der Parameter "Credential " wird verwendet, um den Befehl im Sicherheitskontext von "Domain01\User01", einem Benutzer, der über die Berechtigung zum Ausführen von Befehlen verfügt, auszuführen. Der Parameter ScriptBlock gibt den Befehl an, der auf dem Remotecomputer ausgeführt werden soll.

Als Antwort fordert PowerShell das Kennwort und eine Authentifizierungsmethode für das Benutzerkonto an. Anschließend wird der Befehl auf dem Computer „Server01“ ausgeführt und das Ergebnis zurückgegeben.

Beispiel 3: Ausführen eines Befehls in einer dauerhaften Verbindung

In diesem Beispiel wird derselbe Get-Culture Befehl in einer Sitzung mit einer dauerhaften Verbindung auf dem Remotecomputer mit dem Namen Server02 ausgeführt.

$s = New-PSSession -ComputerName Server02 -Credential Domain01\User01
Invoke-Command -Session $s -ScriptBlock { Get-Culture }

Das New-PSSession Cmdlet erstellt eine Sitzung auf dem Server02-Remotecomputer und speichert sie in der $s Variablen. In der Regel erstellen Sie eine Sitzung nur, wenn Sie eine Reihe von Befehlen auf dem Remotecomputer ausführen.

Das Invoke-Command Cmdlet führt den Get-Culture Befehl auf Server02 aus. Der Parameter Session gibt die sitzung an, die in der $s Variablen gespeichert wurde.

Als Antwort führt PowerShell den Befehl in der Sitzung auf dem Server02-Computer aus.

Beispiel 4: Verwenden einer Sitzung zum Ausführen einer Reihe von Befehlen, die Daten freigeben

In diesem Beispiel werden die Auswirkungen der Verwendung von ComputerName und Session-Parametern von Invoke-Command. Es veranschaulicht, wie Sie eine Sitzung verwenden können, um eine Reihe von Befehlen auszuführen, die gemeinsam die gleichen Daten nutzen.

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

Die ersten beiden Befehle verwenden den ComputerName-Parameter zum Ausführen von Invoke-Command Befehlen auf dem Remotecomputer Server02. Der erste Befehl verwendet das Get-Process Cmdlet, um den PowerShell-Prozess auf dem Remotecomputer abzurufen und in der $p Variablen zu speichern. Der zweite Befehl ruft den Wert der VirtualMemorySize-Eigenschaft des PowerShell-Prozesses ab.

Wenn Sie den Parameter ComputerName verwenden, erstellt PowerShell eine neue Sitzung zum Ausführen des Befehls. Die Sitzung wird geschlossen, wenn der Befehl abgeschlossen ist. Die $p Variable wurde in einer Verbindung erstellt, ist aber in der für den zweiten Befehl erstellten Verbindung nicht vorhanden.

Das Problem wird gelöst, indem eine dauerhafte Sitzung auf dem Remotecomputer erstellt wird und dann beide Befehle in derselben Sitzung ausgeführt werden.

Das New-PSSession Cmdlet erstellt eine persistente Sitzung auf dem Computer Server02 und speichert die Sitzung in der $s Variablen. Die Invoke-Command folgenden Zeilen verwenden den Parameter "Session ", um beide Befehle in derselben Sitzung auszuführen. Da beide Befehle in derselben Sitzung ausgeführt werden, bleibt der $p Wert aktiv.

Beispiel 5: Aufrufen eines Befehls mit einem skriptblock, der in einer Variablen gespeichert ist

In diesem Beispiel wird gezeigt, wie Sie einen Befehl ausführen, der als Skriptblock in einer Variablen gespeichert ist. Wenn der Skriptblock in einer Variablen gespeichert wird, können Sie die Variable als Wert des ScriptBlock-Parameters angeben.

$command = {
    Get-EventLog -LogName 'Windows PowerShell' |
        Where-Object { $_.Message -like '*certificate*' }
}
Invoke-Command -ComputerName S1, S2 -ScriptBlock $command

Die $command Variable speichert den Befehl, der Get-EventLog als Skriptblock formatiert ist. Der Invoke-Command Befehl wird auf $command den Remotecomputern S1 und S2 ausgeführt.

Beispiel 6: Ausführen eines einzelnen Befehls auf mehreren Computern

In diesem Beispiel wird veranschaulicht, wie Invoke-Command Ein einzelner Befehl auf mehreren Computern ausgeführt wird.

$parameters = @{
  ComputerName      = 'Server01', 'Server02', 'TST-0143', 'localhost'
  ConfigurationName = 'MySession.PowerShell'
  ScriptBlock = { Get-EventLog 'Windows PowerShell' }
}
Invoke-Command @parameters

Der Parameter ComputerName gibt eine durch Trennzeichen getrennte Liste von Computernamen an. Die Liste der Computer enthält den Localhost-Wert, der den lokalen Computer darstellt. Der Parameter ConfigurationName gibt eine alternative Sitzungskonfiguration an. Der ScriptBlock-Parameter wird ausgeführt Get-EventLog , um die Windows PowerShell-Ereignisprotokolle von jedem Computer abzurufen.

Beispiel 7: Abrufen der Version des Hostprogramms auf mehreren Computern

In diesem Beispiel wird die Version des PowerShell-Hostprogramms ab, das auf 200 Remotecomputern ausgeführt wird.

$version = Invoke-Command -ComputerName (Get-Content Machines.txt) -ScriptBlock {
    (Get-Host).Version
}

Da nur ein Befehl ausgeführt wird, müssen Sie keine dauerhaften Verbindungen mit jedem der Computer erstellen. Stattdessen verwendet der Befehl den ComputerName-Parameter , um die Computer anzugeben. Um die Computer anzugeben, verwendet es das Get-Content Cmdlet, um den Inhalt der Machine.txt Datei abzurufen, eine Datei mit Computernamen.

Das Invoke-Command Cmdlet führt einen Get-Host Befehl auf den Remotecomputern aus. Es verwendet Punktnotation, um die Version-Eigenschaft des PowerShell-Hosts abzurufen.

Diese Befehle werden jeweils einzeln ausgeführt. Nach Abschluss der Befehle wird die Ausgabe der Befehle von allen Computern in der $version Variablen gespeichert. Die Ausgabe enthält den Namen des Computers, von dem die Daten stammen.

Beispiel 8: Ausführen eines Hintergrundauftrags auf mehreren Remotecomputern

In diesem Beispiel wird ein Befehl auf zwei Remotecomputern ausgeführt. Der Invoke-Command Befehl verwendet den AsJob-Parameter , sodass der Befehl als Hintergrundauftrag ausgeführt wird. Die Befehle werden auf den Remotecomputern ausgeführt, aber der Auftrag ist auf dem lokalen Computer vorhanden. Die Ergebnisse werden an den lokalen Computer übertragen.

$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

Das New-PSSession Cmdlet erstellt Sitzungen auf den Remotecomputern Server01 und Server02. Das Invoke-Command Cmdlet führt in jeder Sitzung einen Hintergrundauftrag aus. Der Befehl verwendet den AsJob-Parameter , um den Befehl als Hintergrundauftrag auszuführen. Dieser Befehl gibt ein Auftragsobjekt zurück, das zwei untergeordnete Auftragsobjekte enthält, jeweils eins für die Aufträge, die auf zwei Remotecomputern ausgeführt werden.

Der Get-Job Befehl speichert das Auftragsobjekt in der $j Variablen. Die $j Variable wird dann an das Format-List Cmdlet weitergeleitet, um alle Eigenschaften des Auftragsobjekts in einer Liste anzuzeigen. Der letzte Befehl ruft die Ergebnisse der Aufträge ab. Es führt das Auftragsobjekt in $j das Receive-Job Cmdlet ein und speichert die Ergebnisse in der $results Variablen.

Beispiel 9: Einschließen lokaler Variablen in einen Befehl, der auf einem Remotecomputer ausgeführt wird

Dieses Beispiel zeigt, wie Sie die Werte von lokalen Variablen in einem Befehl einschließen können, der auf einem Remotecomputer ausgeführt wird. Der Befehl verwendet den Using Bereichsmodifizierer, um eine lokale Variable in einem Remotebefehl zu identifizieren. Standardmäßig wird davon ausgegangen, dass alle Variablen in der Remotesitzung definiert sind. Der Using Bereichsmodifizierer wurde in PowerShell 3.0 eingeführt. Weitere Informationen zum Using Bereichsmodifizierer finden Sie unter about_Remote_Variables und about_Scopes.

$Log = 'Windows PowerShell'
Invoke-Command -ComputerName Server01 -ScriptBlock {
    Get-EventLog -LogName $Using:Log -Newest 10
}

Die $Log Variable speichert den Namen des Ereignisprotokolls, Windows PowerShell. Das Invoke-Command Cmdlet wird auf Server01 ausgeführt Get-EventLog , um die zehn neuesten Ereignisse aus dem Ereignisprotokoll abzurufen. Der Wert des LogName-Parameters ist die $Log Variable, die dem Using Bereichsmodifizierer vorangestellt wird, um anzugeben, dass er in der lokalen Sitzung erstellt wurde, nicht in der Remotesitzung.

Beispiel 10: Ausblenden des Computernamens

Dieses Beispiel zeigt den Effekt der Verwendung des HideComputerName-Parameters von Invoke-Command. HideComputerName ändert das von diesem Cmdlet zurückgegebene Objekt nicht. Sie ändert nur die Anzeige. Sie können weiterhin die Cmdlets "Format " verwenden, um die PsComputerName-Eigenschaft eines der betroffenen Objekte anzuzeigen.

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 -HideComputerName -ScriptBlock {
    Get-Process PowerShell
}

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

Mit den ersten beiden Befehlen wird Invoke-Command ein Get-Process Befehl für den PowerShell-Prozess ausgeführt. Die Ausgabe des ersten Befehls enthält die PsComputerName-Eigenschaft , die den Namen des Computers enthält, auf dem der Befehl ausgeführt wurde. Die Ausgabe des zweiten Befehls, der HideComputerName verwendet, enthält nicht die PsComputerName-Spalte.

Beispiel 11: Verwenden des Param-Schlüsselworts in einem Skriptblock

Das Param Schlüsselwort und der ArgumentList-Parameter werden verwendet, um Variablenwerte an benannte Parameter in einem Skriptblock zu übergeben. In diesem Beispiel werden Dateinamen angezeigt, die mit dem Buchstaben a beginnen und die .pdf Erweiterung aufweisen.

Weitere Informationen zum Param Schlüsselwort finden Sie unter 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-Commandverwendet den ScriptBlock-Parameter, der zwei Variablen definiert, $param1 und $param2. Get-ChildItemverwendet die benannten Parameter Name und Include mit den Variablennamen. Die ArgumentList übergibt die Werte an die Variablen.

Beispiel 12: Verwenden der $args automatischen Variablen in einem Skriptblock

Die $args automatische Variable und der ArgumentList-Parameter werden verwendet, um Arraywerte an Parameterpositionen in einem Skriptblock zu übergeben. In diesem Beispiel wird der Verzeichnisinhalt eines Servers mit .txt Dateien angezeigt. Der Get-ChildItem Parameter "Path " ist Position 0, und der Parameter "Filter " ist Position 1.

Weitere Informationen zur $args Variablen finden Sie unter 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 verwendet einen ScriptBlock-Parameter und Get-ChildItem gibt die $args[0] Werte und $args[1] Arraywerte an. Die ArgumentList übergibt die $args Arraywerte an die Get-ChildItem Parameterpositionen für Pfad und Filter.

Beispiel 13: Ausführen eines Skripts auf allen Computern, die in einer Textdatei aufgeführt sind

In diesem Beispiel wird das Invoke-Command Cmdlet verwendet, um das Sample.ps1 Skript auf allen computern auszuführen, die in der Servers.txt Datei aufgeführt sind. Der Befehl verwendet den FilePath-Parameter , um die Skriptdatei anzugeben. Mit diesem Befehl können Sie das Skript auf den Remotecomputern ausführen, auch wenn auf die Skriptdatei nicht auf die Remotecomputer zugegriffen werden kann.

$parameters = @{
    ComputerName = (Get-Content Servers.txt)
    FilePath     = 'C:\Scripts\Sample.ps1'
    ArgumentList = 'Process', 'Service'
}
Invoke-Command @parameters

Wenn Sie den Befehl übermitteln, wird der Inhalt der Sample.ps1 Datei in einen Skriptblock kopiert, und der Skriptblock wird auf jedem der Remotecomputer ausgeführt. Dieses Verfahren entspricht der Verwendung des ScriptBlock-Parameters zum Übermitteln des Inhalts des Skripts.

Beispiel 14: Ausführen eines Befehls auf einem Remotecomputer mit einem URI

In diesem Beispiel wird gezeigt, wie Sie einen Befehl auf einem Remotecomputer ausführen, der durch einen Uniform Resource Identifier (URI) identifiziert wird. In diesem beispiel wird ein Set-Mailbox Befehl auf einem Exchange-Remoteserver ausgeführt.

$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

In der ersten Zeile wird das Get-Credential Cmdlet zum Speichern von Windows Live ID-Anmeldeinformationen in der $LiveCred Variablen verwendet. PowerShell fordert den Benutzer auf, Windows Live ID-Anmeldeinformationen einzugeben.

Die $parameters Variable ist eine Hashtabelle mit den Parametern, die an das Invoke-Command Cmdlet übergeben werden sollen. Das Invoke-Command Cmdlet führt einen Set-Mailbox Befehl mithilfe der Microsoft.Exchange-Sitzungskonfiguration aus. Der Parameter ConnectionURI gibt die URL des Exchange-Serverendpunkts an. Der Parameter "Credential " gibt die in der $LiveCred Variablen gespeicherten Anmeldeinformationen an. Der Parameter AuthenticationMechanism gibt die Verwendung der Standardauthentifizierung an. Der ScriptBlock-Parameter gibt einen Skriptblock an, der den Befehl enthält.

Beispiel 15: Verwenden einer Sitzungsoption

In diesem Beispiel wird gezeigt, wie Sie einen SessionOption-Parameter erstellen und verwenden.

$so = New-PSSessionOption -SkipCACheck -SkipCNCheck -SkipRevocationCheck
$parameters = @{
    ComputerName  = 'server01'
    UseSSL        = $true
    ScriptBlock   = { Get-HotFix }
    SessionOption = $so
    Credential    = 'server01\user01'
}
Invoke-Command @parameters

Das New-PSSessionOption Cmdlet erstellt ein Sitzungsoptionsobjekt, das bewirkt, dass das Remoteende die Zertifizierungsstelle, den kanonischen Namen und die Sperrlisten beim Auswerten der eingehenden HTTPS-Verbindung nicht überprüft. Das SessionOption-Objekt wird in der $so Variablen gespeichert.

Das Invoke-Command Cmdlet führt einen Get-HotFix Befehl remote aus. Der Parameter "SessionOption " erhält die $so Variable.

Beispiel 16: Verwalten der URI-Umleitung in einem Remotebefehl

In diesem Beispiel wird gezeigt, wie Sie die Parameter AllowRedirection und SessionOption verwenden, um die URI-Umleitung in einem Remotebefehl zu verwalten.

$max = New-PSSessionOption -MaximumRedirection 1
$parameters = @{
  ConnectionUri    = 'https://ps.exchangelabs.com/PowerShell'
  ScriptBlock      = { Get-Mailbox dan }
  AllowRedirection = $true
  SessionOption    = $max
}
Invoke-Command @parameters

Das New-PSSessionOption Cmdlet erstellt ein PSSessionOption -Objekt, das in der $max Variablen gespeichert wird. Der Befehl verwendet den Parameter MaximumRedirection , um die MaximumConnectionRedirectionCount-Eigenschaft des PSSessionOption -Objekts auf 1 festzulegen.

Das Invoke-Command Cmdlet führt einen Get-Mailbox Befehl auf einem Remote-Microsoft Exchange Server aus. Der Parameter AllowRedirection bietet explizite Berechtigung zum Umleiten der Verbindung an einen alternativen Endpunkt. Der SessionOption-Parameter verwendet das sitzungsobjekt, das in der $max Variablen gespeichert ist.

Wenn der durch ConnectionURI angegebene Remotecomputer eine Umleitungsmeldung zurückgibt, leitet PowerShell die Verbindung um, aber wenn das neue Ziel eine weitere Umleitungsmeldung zurückgibt, wird der Wert der Umleitungsanzahl von 1 überschritten und Invoke-Command gibt einen nicht beendeten Fehler zurück.

Beispiel 17: Zugreifen auf eine Netzwerkfreigabe in einer Remotesitzung

In diesem Beispiel wird gezeigt, wie Sie über eine Remotesitzung auf eine Netzwerkfreigabe zugreifen. Drei Computer werden verwendet, um das Beispiel zu veranschaulichen. Server01 ist der lokale Computer, Server02 ist der Remotecomputer, und Net03 enthält die Netzwerkfreigabe. Server01 stellt eine Verbindung mit Server02 und dann einen zweiten Hop zu Net03 für den Zugriff auf die Netzwerkfreigabe vor. Weitere Informationen dazu, wie PowerShell Remoting Hops zwischen Computern unterstützt, finden Sie unter Erstellen des zweiten Hops in PowerShell Remoting.

Die erforderliche Stellvertretung für die Unterstützung von Anmeldeinformationen (Credential Security Support Provider, CredSSP) ist in den Clienteinstellungen auf dem lokalen Computer und in den Diensteinstellungen auf dem Remotecomputer aktiviert. Um die Befehle in diesem Beispiel auszuführen, müssen Sie Mitglied der Gruppe "Administratoren " auf dem lokalen Computer und dem Remotecomputer sein.

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

Das Enable-WSManCredSSP Cmdlet aktiviert die CredSSP-Delegierung vom lokalen Server01-Computer an den Remotecomputer Server02. Der Parameter Role gibt den Client an, um die CredSSP-Clienteinstellung auf dem lokalen Computer zu konfigurieren.

New-PSSession erstellt ein PSSession-Objekt für Server02 und speichert das Objekt in der $s Variablen.

Das Invoke-Command Cmdlet verwendet die $s Variable zum Herstellen einer Verbindung mit dem Remotecomputer Server02. Der ScriptBlock-Parameter wird auf dem Remotecomputer ausgeführt Enable-WSManCredSSP . Der Parameter Role gibt den Server an, um die Einstellung des CredSSP-Servers auf dem Remotecomputer zu konfigurieren.

Die $parameters Variable enthält die Parameterwerte, die mit der Netzwerkfreigabe verbunden werden sollen. Das Invoke-Command Cmdlet führt einen Get-Item Befehl in der Sitzung in $s. Dieser Befehl ruft ein Skript aus der \\Net03\Scripts Netzwerkfreigabe ab. Der Befehl verwendet den Authentifizierungsparameter mit dem Wert "CredSSP " und dem Parameter "Credential " mit dem Wert "Domain01\Admin01".

Beispiel 18: Starten von Skripts auf vielen Remotecomputern

In diesem Beispiel wird ein Skript auf mehr als hundert Computern ausgeführt. Zur Minimierung der Auswirkungen auf dem lokalen Computer wird eine Verbindung mit jedem Computer hergestellt, das Skript gestartet und die Verbindung dann von jedem Computer getrennt. Das Skript wird weiterhin in den getrennten Sitzungen ausgeführt.

$parameters = @{
  ComputerName          = (Get-Content -Path C:\Test\Servers.txt)
  InDisconnectedSession = $true
  FilePath              = '\\Scripts\Public\ConfigInventory.ps1'
  SessionOption         = @{
      OutputBufferingMode = 'Drop'
      IdleTimeout         = [timespan]::FromHours(12)
  }
}
Invoke-Command @parameters

Der Befehl wird zum Ausführen des Skripts verwendet Invoke-Command . Der Wert des Parameters ComputerName ist ein Get-Content Befehl, der die Namen der Remotecomputer aus einer Textdatei abruft. Der Parameter InDisconnectedSession trennt die Sitzungen, sobald der Befehl gestartet wird. Der Wert des FilePath-Parameters ist das Skript, das Invoke-Command auf jedem Computer ausgeführt wird.

Der Wert von SessionOption ist eine Hashtabelle. Der Wert "OutputBufferingMode " wird auf Drop "IdleTimeout" festgelegt, und der Wert "IdleTimeout " wird auf 12 Stunden festgelegt.

Verwenden Sie das Receive-PSSession Cmdlet, um die Ergebnisse von Befehlen und Skripts abzurufen, die in getrennten Sitzungen ausgeführt werden.

Parameter

-AllowRedirection

-ApplicationName

-ArgumentList

-AsJob

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-ConnectionUri

-ContainerId

-Credential

-EnableNetworkAccess

-FilePath

-HideComputerName

-InDisconnectedSession

-InputObject

-JobName

-NoNewScope

-Port

-RunAsAdministrator

-ScriptBlock

-Session

-SessionName

-SessionOption

-ThrottleLimit

-UseSSL

-VMId

-VMName

Eingaben

ScriptBlock

Sie können einen Befehl in einem Skriptblock an Invoke-Command. Verwenden Sie die $Input automatische Variable, um die Eingabeobjekte im Befehl darzustellen.

Ausgaben

System.Management.Automation.PSRemotingJob

Wenn Sie den Parameter AsJob verwenden, gibt dieses Cmdlet ein Auftragsobjekt zurück.

PSSession

Wenn Sie den Parameter InDisconnectedSession verwenden, gibt dieses Cmdlet ein PSSession-Objekt zurück.

Object

Standardmäßig gibt dieses Cmdlet die Ausgabe des aufgerufenen Befehls zurück, bei dem es sich um den Wert des ScriptBlock-Parameters handelt.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Invoke-Command:

• icm

Unter Windows Vista und höheren Versionen des Windows-Betriebssystems müssen Sie PowerShell mit der Option "Als Administrator ausführen" den Parameter Invoke-Command "ComputerName" verwenden, um einen Befehl auf dem lokalen Computer auszuführen.

Wenn Sie Befehle auf mehreren Computern ausführen, stellt PowerShell eine Verbindung mit den Computern in der Reihenfolge dar, in der sie in der Liste angezeigt werden. Die Befehlsausgabe wird jedoch in der Reihenfolge angezeigt, in der sie von den Remotecomputern empfangen wird, was möglicherweise anders ist.

Fehler, die aus dem ausgeführten Befehl resultieren, Invoke-Command sind in den Befehlsergebnissen enthalten. Fehler, die in einem lokalen Befehl Fehler mit Abbruch sein würden, werden in einem Remotebefehl als Fehler ohne Abbruch behandelt. Diese Strategie stellt sicher, dass das Beenden von Fehlern auf einem Computer den Befehl auf allen Computern, auf denen sie ausgeführt wird, nicht schließen. Diese Vorgehensweise wird selbst dann verwendet, wenn ein Remotebefehl auf einem einzelnen Computer ausgeführt wird.

Wenn sich der Remotecomputer nicht in einer Domäne befindet, der der lokale Computer vertraut, kann der Computer die Anmeldeinformationen des Benutzers möglicherweise nicht authentifizieren. Wenn Sie den Remotecomputer zur Liste der vertrauenswürdigen Hosts in WS-Management hinzufügen möchten, verwenden Sie den folgenden Befehl im WSMAN Anbieter, wobei <Remote-Computer-Name> der Name des Remotecomputers angegeben ist:

Set-Item -Path WSMan:\Localhost\Client\TrustedHosts -Value \<Remote-Computer-Name\>

Wenn Sie eine PSSession mit dem Parameter "InDisconnectedSession " trennen, wird der Sitzungsstatus getrennt , und die Verfügbarkeit ist "None". Der Wert der State-Eigenschaft ist relativ zur aktuellen Sitzung. Ein Wert von "Disconnected " bedeutet, dass die PSSession nicht mit der aktuellen Sitzung verbunden ist. Es bedeutet jedoch nicht, dass die PSSession von allen Sitzungen getrennt ist. Sie kann mit einer anderen Sitzung verbunden sein. Um festzustellen, ob Sie eine Verbindung mit der Sitzung herstellen oder erneut herstellen können, verwenden Sie die Availability-Eigenschaft .

Ein Verfügbarkeitswert von None gibt an, dass Sie eine Verbindung mit der Sitzung herstellen können. Ein Wert von Beschäftigt gibt an, dass Sie keine Verbindung mit der PSSession herstellen können, da sie mit einer anderen Sitzung verbunden ist. Weitere Informationen zu den Werten der State-Eigenschaft von Sitzungen finden Sie unter RunspaceState. Weitere Informationen zu den Werten der Verfügbarkeitseigenschaft von Sitzungen finden Sie unter RunspaceAvailability.

Ähnliche Themen

• about_PSSessions
• about_Remote
• about_Remote_Disconnected_Sessions
• about_Remote_Troubleshooting
• about_Remote_Variables
• about_Scopes
• Enter-PSSession
• Exit-PSSession
• Get-PSSession
• Invoke-Item
• New-PSSession
• Remove-PSSession
• WSMan-Anbieter