Invoke-Command

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

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

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

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]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

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]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

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

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

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

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

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

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

Invoke-Command
    [-ScriptBlock] <ScriptBlock>
    -HostName <String[]>
    [-Port <Int32>]
    [-AsJob]
    [-HideComputerName]
    [-JobName <String>]
    [-UserName <String>]
    [-KeyFilePath <String>]
    [-Subsystem <String>]
    [-ConnectingTimeout <Int32>]
    [-SSHTransport]
    [-Options <Hashtable>]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

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

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

Invoke-Command
    [-ScriptBlock] <ScriptBlock>
    -SSHConnection <Hashtable[]>
    [-AsJob]
    [-HideComputerName]
    [-JobName <String>]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-FilePath] <String>
    -HostName <String[]>
    [-AsJob]
    [-HideComputerName]
    [-UserName <String>]
    [-KeyFilePath <String>]
    [-Subsystem <String>]
    [-ConnectingTimeout <Int32>]
    [-SSHTransport]
    [-Options <Hashtable>]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

Invoke-Command
    [-FilePath] <String>
    -SSHConnection <Hashtable[]>
    [-AsJob]
    [-HideComputerName]
    [-RemoteDebug]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [<CommonParameters>]

De Invoke-Command cmdlet voert opdrachten uit op een lokale of externe computer en retourneert alle uitvoer van de opdrachten, inclusief fouten. Met één Invoke-Command opdracht kunt u opdrachten uitvoeren op meerdere computers.

Als u één opdracht wilt uitvoeren op een externe computer, gebruikt u de parameter ComputerName. Als u een reeks gerelateerde opdrachten wilt uitvoeren die gegevens delen, gebruikt u de New-PSSession-cmdlet om een PSSession- (een permanente verbinding) op de externe computer te maken en gebruikt u vervolgens de parameter Session van Invoke-Command om de opdracht uit te voeren in de PSSession-. Als u een opdracht wilt uitvoeren in een niet-verbonden sessie, gebruikt u de parameter InDisconnectedSession. Als u een opdracht in een achtergrondtaak wilt uitvoeren, gebruikt u de parameter AsJob.

U kunt ook Invoke-Command op een lokale computer gebruiken om een scriptblok uit te voeren als opdracht. PowerShell voert het scriptblok direct uit in een onderliggend bereik van het huidige bereik.

Lees Invoke-Commandvoordat u gebruikt om opdrachten uit te voeren op een externe computer.

Vanaf PowerShell 6.0 kunt u Secure Shell (SSH) gebruiken om verbinding te maken met en opdrachten aan te roepen op externe computers. SSH moet worden geïnstalleerd op de lokale computer en de externe computer moet worden geconfigureerd met een PowerShell SSH-eindpunt. Het voordeel van een externe PowerShell-sessie op basis van SSH is dat deze werkt op meerdere platforms (Windows, Linux, macOS). Voor een SSH-sessie gebruikt u de parameters HostName of SSHConnection parameters om de externe computer en relevante verbindingsgegevens op te geven. Zie Externe communicatie van PowerShell via SSH via SSHvoor meer informatie over het instellen van externe communicatie met PowerShell SSH.

Sommige codevoorbeelden gebruiken splatting om de lijnlengte te verminderen. Zie about_Splattingvoor meer informatie.

In dit voorbeeld wordt het Test.ps1 script uitgevoerd op de Server01-computer.

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

De parameter FilePath geeft een script op dat zich op de lokale computer bevindt. Het script wordt uitgevoerd op de externe computer en de resultaten worden geretourneerd naar de lokale computer.

In dit voorbeeld wordt een Get-Culture opdracht uitgevoerd op de externe Server01-computer.

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

De parameter ComputerName geeft de naam van de externe computer op. De parameter Credential wordt gebruikt om de opdracht uit te voeren in de beveiligingscontext van Domain01\User01, een gebruiker die gemachtigd is om opdrachten uit te voeren. De parameter ScriptBlock geeft de opdracht op die op de externe computer moet worden uitgevoerd.

Als reactie vraagt PowerShell het wachtwoord en een verificatiemethode voor het User01-account aan. Vervolgens wordt de opdracht uitgevoerd op de Server01-computer en wordt het resultaat geretourneerd.

In dit voorbeeld wordt dezelfde Get-Culture opdracht uitgevoerd in een sessie, met behulp van een permanente verbinding, op de externe computer met de naam Server02.

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

De cmdlet New-PSSession maakt een sessie op de externe Server02-computer en slaat deze op in de variabele $s. Normaal gesproken maakt u alleen een sessie wanneer u een reeks opdrachten uitvoert op de externe computer.

De cmdlet Invoke-Command voert de opdracht Get-Culture uit op Server02. De parameter Session geeft de sessie op die is opgeslagen in de variabele $s.

Als reactie voert PowerShell de opdracht uit in de sessie op de Server02-computer.

In dit voorbeeld worden de effecten van het gebruik van ComputerName en Session parameters van Invoke-Commandvergeleken. Het laat zien hoe u een sessie gebruikt om een reeks opdrachten uit te voeren die dezelfde gegevens delen.

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

De eerste twee opdrachten gebruiken de parameter ComputerName van Invoke-Command om opdrachten uit te voeren op de externe Server02-computer. De eerste opdracht maakt gebruik van de Get-Process cmdlet om het PowerShell-proces op de externe computer op te halen en op te slaan in de $p variabele. Met de tweede opdracht wordt de waarde opgehaald van de eigenschap VirtualMemorySize van het PowerShell-proces.

Wanneer u de parameter ComputerName gebruikt, maakt PowerShell een nieuwe sessie om de opdracht uit te voeren. De sessie wordt gesloten wanneer de opdracht is voltooid. De $p variabele is gemaakt in één verbinding, maar deze bestaat niet in de verbinding die is gemaakt voor de tweede opdracht.

Het probleem wordt opgelost door een permanente sessie op de externe computer te maken en vervolgens beide opdrachten in dezelfde sessie uit te voeren.

De New-PSSession cmdlet maakt een permanente sessie op de computer Server02 en slaat de sessie op in de $s variabele. De Invoke-Command regels die volgen, gebruiken de parameter Session om beide opdrachten in dezelfde sessie uit te voeren. Omdat beide opdrachten in dezelfde sessie worden uitgevoerd, blijft de $p waarde actief.

In dit voorbeeld ziet u hoe u een opdracht uitvoert die is opgeslagen als een scriptblok in een variabele. Wanneer het scriptblok wordt opgeslagen in een variabele, kunt u de variabele opgeven als de waarde van de parameter ScriptBlock.

$command = {
    Get-WinEvent -LogName PowerShellCore/Operational |
      Where-Object -FilterScript { $_.Message -like '*certificate*' }
}
Invoke-Command -ComputerName S1, S2 -ScriptBlock $command

De $command variabele slaat de Get-WinEvent opdracht op die is opgemaakt als een scriptblok. De Invoke-Command voert de opdracht uit die is opgeslagen in $command op de externe S1- en S2-computers.

In dit voorbeeld ziet u hoe u Invoke-Command gebruikt om één opdracht uit te voeren op meerdere computers.

$parameters = @{
  ComputerName      = 'Server01', 'Server02', 'TST-0143', 'localhost'
  ConfigurationName = 'MySession.PowerShell'
  ScriptBlock       = { Get-WinEvent -LogName PowerShellCore/Operational }
}
Invoke-Command @parameters

De parameter ComputerName geeft een door komma's gescheiden lijst met computernamen op. De lijst met computers bevat de localhost-waarde, die de lokale computer vertegenwoordigt. De parameter ConfigurationName geeft een alternatieve sessieconfiguratie op. De parameter ScriptBlock wordt uitgevoerd Get-WinEvent om de PowerShellCore-/operationele gebeurtenislogboeken van elke computer op te halen.

In dit voorbeeld wordt de versie van het PowerShell-hostprogramma op 200 externe computers uitgevoerd.

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

Omdat er slechts één opdracht wordt uitgevoerd, hoeft u geen permanente verbindingen met elk van de computers te maken. In plaats daarvan gebruikt de opdracht de parameter ComputerName om de computers aan te geven. Als u de computers wilt opgeven, wordt de Get-Content cmdlet gebruikt om de inhoud van het Machine.txt-bestand, een bestand met computernamen op te halen.

De Invoke-Command-cmdlet voert een Get-Host opdracht uit op de externe computers. Er wordt gebruikgemaakt van punt notatie om de eigenschap versie van de PowerShell-host op te halen.

Deze opdrachten worden één voor één uitgevoerd. Wanneer de opdrachten zijn voltooid, wordt de uitvoer van de opdrachten van alle computers opgeslagen in de variabele $version. De uitvoer bevat de naam van de computer waaruit de gegevens afkomstig zijn.

In dit voorbeeld wordt een opdracht uitgevoerd op twee externe computers. De opdracht Invoke-Command maakt gebruik van de parameter AsJob, zodat de opdracht wordt uitgevoerd als achtergrondtaak. De opdrachten worden uitgevoerd op de externe computers, maar de taak bestaat op de lokale computer. De resultaten worden verzonden naar de lokale computer.

$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

Met de New-PSSession cmdlet worden sessies gemaakt op de externe server01- en Server02-computers. De cmdlet Invoke-Command voert een achtergrondtaak uit in elk van de sessies. De opdracht gebruikt de parameter AsJob om de opdracht uit te voeren als achtergrondtaak. Met deze opdracht wordt een taakobject geretourneerd dat twee onderliggende taakobjecten bevat, één voor elk van de taken die worden uitgevoerd op de twee externe computers.

Met de opdracht Get-Job wordt het taakobject opgeslagen in de $j variabele. De $j variabele wordt vervolgens doorgesluisd naar de cmdlet Format-List om alle eigenschappen van het taakobject in een lijst weer te geven. Met de laatste opdracht worden de resultaten van de taken opgehaald. Het pijpt het taakobject in $j naar de Receive-Job cmdlet en slaat de resultaten op in de $results variabele.

In dit voorbeeld ziet u hoe u de waarden van lokale variabelen opneemt in een opdracht die wordt uitgevoerd op een externe computer. De opdracht maakt gebruik van de Using: bereikaanpassing om een lokale variabele in een externe opdracht te identificeren. Standaard wordt ervan uitgegaan dat alle variabelen worden gedefinieerd in de externe sessie. De Using: bereikaanpassing is geïntroduceerd in PowerShell 3.0. Zie Using: en about_Scopesvoor meer informatie over de bereikaanpassing.

$Log = 'PowerShellCore/Operational'
Invoke-Command -ComputerName Server01 -ScriptBlock {
    Get-WinEvent -LogName $Using:Log -MaxEvents 10
}

De $Log variabele slaat de naam van het gebeurtenislogboek, PowerShellCore/Operational, op. De Invoke-Command cmdlet wordt uitgevoerd Get-WinEvent op Server01 om de tien nieuwste gebeurtenissen op te halen uit het gebeurtenislogboek. De waarde van de parameter LogName is de $Log variabele die wordt voorafgegaan door de Using: bereikaanpassing om aan te geven dat deze is gemaakt in de lokale sessie, niet in de externe sessie.

In dit voorbeeld ziet u het effect van het gebruik van de parameter HideComputerName van Invoke-Command. HideComputerName wijzigt het object dat door deze cmdlet wordt geretourneerd niet. Alleen de weergave wordt gewijzigd. U kunt nog steeds de cmdlets Format gebruiken om de eigenschap PsComputerName van een van de betrokken objecten weer te geven.

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

De eerste twee opdrachten gebruiken Invoke-Command om een Get-Process opdracht uit te voeren voor het PowerShell-proces. De uitvoer van de eerste opdracht bevat de eigenschap PsComputerName, die de naam bevat van de computer waarop de opdracht is uitgevoerd. De uitvoer van de tweede opdracht, die gebruikmaakt van HideComputerName, bevat niet de kolom PsComputerName.

Het param trefwoord en de parameter ArgumentList worden gebruikt om variabele waarden door te geven aan benoemde parameters in een scriptblok. In dit voorbeeld worden bestandsnamen weergegeven die beginnen met de letter a en de extensie .pdf hebben.

Zie paramvoor meer informatie over het trefwoord .

$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 gebruikt de parameter ScriptBlock waarmee twee variabelen, $Param1 en $Param2worden gedefinieerd. Get-ChildItem de benoemde parameters gebruikt, Name en Include with the variable names. De ArgumentList- geeft de waarden door aan de variabelen.

De $args automatische variabele en de parameter ArgumentList worden gebruikt om matrixwaarden door te geven aan parameterposities in een scriptblok. In dit voorbeeld wordt de mapinhoud van een server van .txt bestanden weergegeven. De parameter Get-ChildItemPath is positie 0 en de parameter Filter is positie 1.

Zie $args voor meer informatie over de variabele

$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 gebruikt een ScriptBlock parameter en Get-ChildItem geeft de $args[0] en $args[1] matrixwaarden op. De ArgumentList geeft de $args matrixwaarden door aan de Get-ChildItem parameterposities voor Path en Filter.

In dit voorbeeld wordt de cmdlet Invoke-Command gebruikt om het Sample.ps1-script uit te voeren op alle computers die worden vermeld in het Servers.txt-bestand. De opdracht gebruikt de parameter FilePath om het scriptbestand op te geven. Met deze opdracht kunt u het script uitvoeren op de externe computers, zelfs als het scriptbestand niet toegankelijk is voor de externe computers.

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

Wanneer u de opdracht verzendt, wordt de inhoud van het Sample.ps1-bestand gekopieerd naar een scriptblok en wordt het scriptblok uitgevoerd op elk van de externe computers. Deze procedure is gelijk aan het gebruik van de parameter ScriptBlock om de inhoud van het script in te dienen.

In dit voorbeeld ziet u hoe u een opdracht uitvoert op een externe computer die wordt geïdentificeerd door een URI (Uniform Resource Identifier). In dit specifieke voorbeeld wordt een Set-Mailbox-opdracht uitgevoerd op een externe Exchange-server.

$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

De eerste regel maakt gebruik van de Get-Credential cmdlet voor het opslaan van Windows Live ID-referenties in de $LiveCred variabele. PowerShell vraagt de gebruiker om Windows Live ID-referenties in te voeren.

De $parameters variabele is een hash-tabel met de parameters die moeten worden doorgegeven aan de cmdlet Invoke-Command. De Invoke-Command-cmdlet voert een Set-Mailbox-opdracht uit met behulp van de sessieconfiguratie van Microsoft.Exchange. De parameter ConnectionURI geeft de URL van het Exchange-servereindpunt op. De parameter Credential geeft de referenties op die zijn opgeslagen in de $LiveCred-variabele. De parameter AuthenticationMechanism geeft het gebruik van basisverificatie aan. De parameter ScriptBlock geeft een scriptblok op dat de opdracht bevat.

In dit voorbeeld ziet u hoe u een SessionOption parameter maakt en gebruikt.

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

De New-PSSessionOption-cmdlet maakt een sessieoptieobject dat ervoor zorgt dat het externe einde de certificeringsinstantie, canonieke naam en intrekkingslijsten niet controleert tijdens het evalueren van de binnenkomende HTTPS-verbinding. Het SessionOption--object wordt opgeslagen in de variabele $so.

De cmdlet Invoke-Command voert een Get-HotFix opdracht op afstand uit. De parameter SessionOption krijgt de variabele $so.

In dit voorbeeld ziet u hoe u de parameters AllowRedirection en SessionOp tion gebruikt voor het beheren van URI-omleiding in een externe opdracht.

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

De cmdlet New-PSSessionOption maakt een PSSessionOption--object dat is opgeslagen in de $max variabele. De opdracht gebruikt de parameter MaximumRedirection om de eigenschap MaximumConnectionRedirectionCount van het PSSessionOption-object in te stellen op 1.

De cmdlet Invoke-Command voert een Get-Mailbox opdracht uit op een externe Microsoft Exchange Server. De parameter AllowRedirection biedt expliciete machtigingen om de verbinding om te leiden naar een alternatief eindpunt. De parameter SessionOption maakt gebruik van het sessieobject dat is opgeslagen in de $max variabele.

Als de externe computer die is opgegeven door ConnectionURI een omleidingsbericht retourneert, wordt de verbinding door PowerShell omgeleid, maar als de nieuwe bestemming een ander omleidingsbericht retourneert, wordt de waarde voor het aantal omleidingen van 1 overschreden en wordt Invoke-Command een niet-afsluitfout geretourneerd.

In dit voorbeeld ziet u hoe u toegang hebt tot een netwerkshare vanuit een externe sessie. Er worden drie computers gebruikt om het voorbeeld te demonstreren. Server01 is de lokale computer, Server02 is de externe computer en Net03 bevat de netwerkshare. Server01 maakt verbinding met Server02 en vervolgens voert Server02 een tweede hop naar Net03 uit om toegang te krijgen tot de netwerkshare. Zie De tweede hop maken in Externe communicatie van PowerShellvoor meer informatie over hoe externe communicatie van PowerShell ondersteuning biedt voor hops tussen computers.

De vereiste Delegatie van referentiebeveiligingsondersteuningsprovider (CredSSP) is ingeschakeld in de clientinstellingen op de lokale computer en in de service-instellingen op de externe computer. Als u de opdrachten in dit voorbeeld wilt uitvoeren, moet u lid zijn van de groep Administrators op de lokale computer en de externe computer.

Enable-WSManCredSSP -Role Client -DelegateComputer Server02
$s = New-PSSession Server02
Invoke-Command -Session $s -ScriptBlock { Enable-WSManCredSSP -Role Server -Force }
$parameters = @{
  ComputerName   = 'Server02'
  ScriptBlock    = { Get-Item \\Net03\Scripts\LogFiles.ps1 }
  Authentication = 'CredSSP'
  Credential     = 'Domain01\Admin01'
}
Invoke-Command @parameters

Met de cmdlet Enable-WSManCredSSP kunt u CredSSP-delegatie van de lokale Server01-computer naar de externe Server02-computer inschakelen. De parameter Role geeft Client op om de CredSSP-clientinstelling op de lokale computer te configureren.

New-PSSession maakt een PSSession--object voor Server02 en slaat het object op in de $s variabele.

De cmdlet Invoke-Command maakt gebruik van de $s-variabele om verbinding te maken met de externe computer, Server02. Met de parameter ScriptBlock wordt Enable-WSManCredSSP uitgevoerd op de externe computer. De parameter Role geeft Server op om de CredSSP-serverinstelling op de externe computer te configureren.

De variabele $parameters bevat de parameterwaarden om verbinding te maken met de netwerkshare. De Invoke-Command-cmdlet voert een Get-Item opdracht uit in de sessie in $s. Met deze opdracht wordt een script opgehaald uit de \\Net03\Scripts netwerkshare. De opdracht gebruikt de parameter Authentication met een waarde van CredSSP- en de parameter Credential met de waarde Domain01\Admin01.

In dit voorbeeld wordt een script uitgevoerd op meer dan honderd computers. Als u de impact op de lokale computer wilt minimaliseren, maakt deze verbinding met elke computer, start u het script en verbreekt u vervolgens de verbinding met elke computer. Het script wordt nog steeds uitgevoerd in de niet-verbonden sessies.

$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

De opdracht gebruikt Invoke-Command om het script uit te voeren. De waarde van de parameter ComputerName is een Get-Content opdracht waarmee de namen van de externe computers uit een tekstbestand worden opgehaald. De parameter InDisconnectedSession verbreekt de sessies zodra de opdracht wordt gestart. De waarde van de parameter FilePath is het script dat Invoke-Command op elke computer wordt uitgevoerd.

De waarde van SessionOption is een hash-tabel. De OutputBufferingMode-waarde is ingesteld op Drop en de waarde IdleTimeout is ingesteld op 12 uur.

Gebruik de cmdlet Receive-PSSession om de resultaten op te halen van opdrachten en scripts die worden uitgevoerd in niet-verbonden sessies.

In dit voorbeeld ziet u hoe u een opdracht uitvoert op een externe computer met behulp van Secure Shell (SSH). Als SSH is geconfigureerd op de externe computer om te vragen om wachtwoorden, krijgt u een wachtwoordprompt. Anders moet u gebruikersverificatie op basis van SSH-sleutels gebruiken.

Invoke-Command -HostName UserA@LinuxServer01 -ScriptBlock { Get-MailBox * }

In dit voorbeeld ziet u hoe u een opdracht uitvoert op een externe computer met behulp van SSH en een sleutelbestand opgeeft voor gebruikersverificatie. U wordt niet om een wachtwoord gevraagd, tenzij de sleutelverificatie mislukt en de externe computer is geconfigureerd om basiswachtwoordverificatie toe te staan.

$parameters = @{
    HostName    = 'UserA@LinuxServer01'
    ScriptBlock = { Get-MailBox * }
    KeyFilePath = '/UserA/UserAKey_rsa'
}
Invoke-Command

In dit voorbeeld ziet u hoe u een scriptbestand uitvoert op meerdere externe computers met behulp van SSH en de SSHConnection parameterset. De parameter SSHConnection gebruikt een matrix met hash-tabellen die verbindingsgegevens voor elke computer bevatten. In dit voorbeeld is vereist dat de externe doelcomputers SSH hebben geconfigureerd ter ondersteuning van op sleutels gebaseerde gebruikersverificatie.

$sshConnections = @(
    @{
        HostName    = "WinServer1"
        UserName    = "Domain\UserA"
        KeyFilePath = "C:\Users\UserA\id_rsa"
    }
    @{
        HostName    = "UserB@LinuxServer5"
        KeyFilePath = "/Users/UserB/id_rsa"
    }
)
$results = Invoke-Command -FilePath C:\Scripts\GetInfo.ps1 -SSHConnection $sshConnections

In dit voorbeeld ziet u hoe u een scriptbestand uitvoert op een externe Linux-computer met behulp van SSH-opties. De parameter Opties gebruikt een hashtabel met waarden die als opties worden doorgegeven aan de onderliggende ssh opdracht waarmee de verbinding met het externe systeem tot stand is gebracht.

$options = @{
    Port=22
    User = 'UserB'
    Host = 'LinuxServer5'
}
$results = Invoke-Command -FilePath C:\Scripts\CollectEvents.ps1 -KeyFilePath '/Users/UserB/id_rsa' -Options $options

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt een opdracht in een scriptblok doorsluisen naar Invoke-Command. Gebruik de $input automatische variabele om de invoerobjecten in de opdracht weer te geven.

Als u de parameter AsJob gebruikt, retourneert deze cmdlet een taakobject.

Als u de parameter InDisconnectedSession gebruikt, retourneert deze cmdlet een PSSession--object.

Deze cmdlet retourneert standaard de uitvoer van de aangeroepen opdracht. Dit is de waarde van de parameter ScriptBlock.

PowerShell bevat de volgende aliassen voor Invoke-Command:

• Alle platforms:
  • icm

Op Windows Vista en latere versies van het Windows-besturingssysteem, als u de ComputerName parameter van Invoke-Command wilt gebruiken om een opdracht uit te voeren op de lokale computer, moet u PowerShell uitvoeren met behulp van de Uitvoeren als administrator optie.

Wanneer u opdrachten uitvoert op meerdere computers, maakt PowerShell verbinding met de computers in de volgorde waarin ze worden weergegeven in de lijst. De uitvoer van de opdracht wordt echter weergegeven in de volgorde waarin deze wordt ontvangen van de externe computers, wat mogelijk anders is.

Fouten die het gevolg zijn van de opdracht die Invoke-Command wordt uitgevoerd, worden opgenomen in de opdrachtresultaten. Fouten die fouten bij het beëindigen van een lokale opdracht zouden zijn, worden behandeld als niet-afsluitfouten in een externe opdracht. Deze strategie zorgt ervoor dat afsluitfouten op één computer de opdracht niet sluiten op alle computers waarop deze wordt uitgevoerd. Deze procedure wordt zelfs gebruikt wanneer een externe opdracht wordt uitgevoerd op één computer.

Als de externe computer zich niet in een domein bevindt dat de lokale computer vertrouwt, kan de computer mogelijk de referenties van de gebruiker niet verifiëren. Als u de externe computer wilt toevoegen aan de lijst met vertrouwde hosts in WS-Management, gebruikt u de volgende opdracht in de WSMan-provider, waarbij <Remote-Computer-Name> de naam van de externe computer is:

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

Wanneer u een PSSession loskoppelt met behulp van de parameter InDisconnectedSession, wordt de sessiestatus verbroken en wordt de beschikbaarheid Geen. De waarde van de eigenschap State is relatief ten opzichte van de huidige sessie. Een waarde van verbroken betekent dat de PSSession- niet is verbonden met de huidige sessie. Het betekent echter niet dat de PSSession- is losgekoppeld van alle sessies. Het kan zijn dat deze is verbonden met een andere sessie. Gebruik de eigenschap Availability om te bepalen of u verbinding kunt maken met de sessie of opnieuw verbinding kunt maken met de sessie.

Een beschikbaarheidswaarde van Geen geeft aan dat u verbinding kunt maken met de sessie. Een waarde van Bezet geeft aan dat u geen verbinding kunt maken met de PSSession- omdat deze is verbonden met een andere sessie. Zie RunspaceStatevoor meer informatie over de waarden van de eigenschap State van sessies. Zie RunspaceAvailabilityvoor meer informatie over de waarden van de eigenschap Availability van sessies.

De parameters HostName en SSHConnection zijn opgenomen vanaf PowerShell 6.0. Ze zijn toegevoegd om externe communicatie van PowerShell te bieden op basis van Secure Shell (SSH). PowerShell en SSH worden ondersteund op meerdere platforms (Windows, Linux, macOS) en externe communicatie van PowerShell via deze platforms waarop PowerShell en SSH zijn geïnstalleerd en geconfigureerd. Dit is gescheiden van de vorige windows alleen externe communicatie die is gebaseerd op WinRM en veel van de Specifieke WinRM-functies en -beperkingen zijn niet van toepassing. Op WinRM gebaseerde quota, sessieopties, aangepaste eindpuntconfiguratie en functies voor verbinding verbreken/opnieuw verbinden worden momenteel niet ondersteund. Zie Externe communicatie van PowerShell via SSH via SSHvoor meer informatie over het instellen van externe communicatie met PowerShell SSH.

Het uitvoerbare ssh verkrijgt configuratiegegevens van de volgende bronnen in de volgende volgorde:

1. opdrachtregelopties
2. configuratiebestand van gebruiker (~/.ssh/config)
3. configuratiebestand voor het hele systeem (/etc/ssh/ssh_config)

De volgende cmdlet-parameters worden toegewezen aan ssh parameters en opties:

Alle waarden die expliciet door parameters worden doorgegeven, hebben voorrang op waarden die zijn doorgegeven in de Opties hashtabel. Zie ssh_configvoor meer informatie over bestanden.