Comunicación remota con PowerShell
PowerShell tiene muchas formas diferentes de ejecutar comandos en computadoras remotas. En el último capítulo, vio cómo consultar WMI de forma remota utilizando los cmdlets CIM. PowerShell también incluye varios cmdlets que tienen un parámetro ComputerName integrado.
Como se muestra en el siguiente ejemplo, Get-Command se puede utilizar con el parámetro ParameterName para determinar qué comandos tienen un parámetro ComputerName.
Get-Command -ParameterName ComputerName
CommandType Name Version Source
----------- ---- ------- ------
Cmdlet Add-Computer 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Clear-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Connect-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Enter-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Get-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Get-HotFix 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Get-Process 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Get-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Get-Service 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Get-WmiObject 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Invoke-Command 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Invoke-WmiMethod 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Limit-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet New-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet New-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Receive-Job 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Receive-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Register-WmiEvent 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Remove-Computer 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Remove-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Remove-PSSession 3.0.0.0 Microsoft.PowerShell.Core
Cmdlet Remove-WmiObject 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Rename-Computer 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Restart-Computer 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Send-MailMessage 3.1.0.0 Microsoft.PowerShell.Utility
Cmdlet Set-Service 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Set-WmiInstance 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Show-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Stop-Computer 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Test-Connection 3.1.0.0 Microsoft.PowerShell.Management
Cmdlet Write-EventLog 3.1.0.0 Microsoft.PowerShell.Management
Los comandos como Get-Process y Get-Hotfix tienen un parámetro ComputerName. Esta no es la dirección a largo plazo que Microsoft está tomando para ejecutar comandos en computadoras remotas. Incluso si encuentra un comando que tiene un parámetro ComputerName, es probable que necesite especificar credenciales alternativas y no tendrá un parámetro Credential. Y si decidió ejecutar PowerShell desde una cuenta elevada, un firewall entre usted y la computadora remota puede bloquear la solicitud.
Para utilizar los comandos de comunicación remota de PowerShell que se muestran en este capítulo, la comunicación remota de PowerShell debe estar habilitada en la computadora remota. Utilice el cmdlet Enable-PSRemoting para habilitar la comunicación remota de PowerShell.
Enable-PSRemoting
WinRM has been updated to receive requests.
WinRM service type changed successfully.
WinRM service started.
WinRM has been updated for remote management.
WinRM firewall exception enabled.
Comunicación remota uno a uno
Si desea que su sesión remota sea interactiva, lo que desea es la comunicación remota uno a uno. Este tipo de comunicación remota se proporciona a través del cmdlet Enter-PSSession.
En el último capítulo, almacené mis credenciales de administrador de dominio en una variable llamada $Cred. Si aún no lo ha hecho, continúe y almacene las credenciales de administrador de su dominio en la variable $Cred.
Esto le permite ingresar las credenciales una vez y usarlas por comando siempre que su sesión actual de PowerShell esté activa.
$Cred = Get-Credential
Cree una sesión remota de PowerShell uno a uno con el controlador de dominio denominado dc01.
Enter-PSSession -ComputerName dc01 -Credential $Cred
[dc01]: PS C:\Users\Administrator\Documents>
Observe que en el ejemplo anterior el mensaje de PowerShell está precedido por [dc01]. Esto significa que está en una sesión interactiva de PowerShell en la computadora remota llamada dc01. Todos los comandos que ejecute se ejecutarán en dc01, no en su computadora local. Además, tenga en cuenta que solo tiene acceso a los comandos de PowerShell que existen en la computadora remota y no a los de su computadora local. En otras palabras, si ha instalado módulos adicionales en su computadora, no se podrá acceder a ellos desde la computadora remota.
Cuando está conectado a una computadora remota a través de una sesión remota interactiva de PowerShell uno a uno, efectivamente está sentado frente a la computadora remota. Los objetos son objetos normales, como aquellos con los que has estado trabajando a lo largo de todo este libro.
[dc01]: Get-Process | Get-Member
TypeName: System.Diagnostics.Process
Name MemberType Definition
---- ---------- ----------
Handles AliasProperty Handles = Handlecount
Name AliasProperty Name = ProcessName
NPM AliasProperty NPM = NonpagedSystemMemorySize64
PM AliasProperty PM = PagedMemorySize64
SI AliasProperty SI = SessionId
VM AliasProperty VM = VirtualMemorySize64
WS AliasProperty WS = WorkingSet64
Disposed Event System.EventHandler Disposed(System.Object, ...
ErrorDataReceived Event System.Diagnostics.DataReceivedEventHandler ...
Exited Event System.EventHandler Exited(System.Object, Sy...
OutputDataReceived Event System.Diagnostics.DataReceivedEventHandler ...
BeginErrorReadLine Method void BeginErrorReadLine()
BeginOutputReadLine Method void BeginOutputReadLine()
CancelErrorRead Method void CancelErrorRead()
CancelOutputRead Method void CancelOutputRead()
Close Method void Close()
CloseMainWindow Method bool CloseMainWindow()
CreateObjRef Method System.Runtime.Remoting.ObjRef CreateObjRef(...
Dispose Method void Dispose(), void IDisposable.Dispose()
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetLifetimeService Method System.Object GetLifetimeService()
GetType Method type GetType()
InitializeLifetimeService Method System.Object InitializeLifetimeService()
Kill Method void Kill()
Refresh Method void Refresh()
Start Method bool Start()
ToString Method string ToString()
WaitForExit Method bool WaitForExit(int milliseconds), void Wai...
WaitForInputIdle Method bool WaitForInputIdle(int milliseconds), boo...
__NounName NoteProperty string __NounName=Process
BasePriority Property int BasePriority {get;}
Container Property System.ComponentModel.IContainer Container {...
EnableRaisingEvents Property bool EnableRaisingEvents {get;set;}
ExitCode Property int ExitCode {get;}
ExitTime Property datetime ExitTime {get;}
Handle Property System.IntPtr Handle {get;}
HandleCount Property int HandleCount {get;}
HasExited Property bool HasExited {get;}
Id Property int Id {get;}
MachineName Property string MachineName {get;}
MainModule Property System.Diagnostics.ProcessModule MainModule ...
MainWindowHandle Property System.IntPtr MainWindowHandle {get;}
MainWindowTitle Property string MainWindowTitle {get;}
MaxWorkingSet Property System.IntPtr MaxWorkingSet {get;set;}
MinWorkingSet Property System.IntPtr MinWorkingSet {get;set;}
Modules Property System.Diagnostics.ProcessModuleCollection M...
NonpagedSystemMemorySize Property int NonpagedSystemMemorySize {get;}
NonpagedSystemMemorySize64 Property long NonpagedSystemMemorySize64 {get;}
PagedMemorySize Property int PagedMemorySize {get;}
PagedMemorySize64 Property long PagedMemorySize64 {get;}
PagedSystemMemorySize Property int PagedSystemMemorySize {get;}
PagedSystemMemorySize64 Property long PagedSystemMemorySize64 {get;}
PeakPagedMemorySize Property int PeakPagedMemorySize {get;}
PeakPagedMemorySize64 Property long PeakPagedMemorySize64 {get;}
PeakVirtualMemorySize Property int PeakVirtualMemorySize {get;}
PeakVirtualMemorySize64 Property long PeakVirtualMemorySize64 {get;}
PeakWorkingSet Property int PeakWorkingSet {get;}
PeakWorkingSet64 Property long PeakWorkingSet64 {get;}
PriorityBoostEnabled Property bool PriorityBoostEnabled {get;set;}
PriorityClass Property System.Diagnostics.ProcessPriorityClass Prio...
PrivateMemorySize Property int PrivateMemorySize {get;}
PrivateMemorySize64 Property long PrivateMemorySize64 {get;}
PrivilegedProcessorTime Property timespan PrivilegedProcessorTime {get;}
ProcessName Property string ProcessName {get;}
ProcessorAffinity Property System.IntPtr ProcessorAffinity {get;set;}
Responding Property bool Responding {get;}
SafeHandle Property Microsoft.Win32.SafeHandles.SafeProcessHandl...
SessionId Property int SessionId {get;}
Site Property System.ComponentModel.ISite Site {get;set;}
StandardError Property System.IO.StreamReader StandardError {get;}
StandardInput Property System.IO.StreamWriter StandardInput {get;}
StandardOutput Property System.IO.StreamReader StandardOutput {get;}
StartInfo Property System.Diagnostics.ProcessStartInfo StartInf...
StartTime Property datetime StartTime {get;}
SynchronizingObject Property System.ComponentModel.ISynchronizeInvoke Syn...
Threads Property System.Diagnostics.ProcessThreadCollection T...
TotalProcessorTime Property timespan TotalProcessorTime {get;}
UserProcessorTime Property timespan UserProcessorTime {get;}
VirtualMemorySize Property int VirtualMemorySize {get;}
VirtualMemorySize64 Property long VirtualMemorySize64 {get;}
WorkingSet Property int WorkingSet {get;}
WorkingSet64 Property long WorkingSet64 {get;}
PSConfiguration PropertySet PSConfiguration {Name, Id, PriorityClass, Fi...
PSResources PropertySet PSResources {Name, Id, Handlecount, WorkingS...
Company ScriptProperty System.Object Company {get=$this.Mainmodule....
CPU ScriptProperty System.Object CPU {get=$this.TotalProcessorT...
Description ScriptProperty System.Object Description {get=$this.Mainmod...
FileVersion ScriptProperty System.Object FileVersion {get=$this.Mainmod...
Path ScriptProperty System.Object Path {get=$this.Mainmodule.Fil...
Product ScriptProperty System.Object Product {get=$this.Mainmodule....
ProductVersion ScriptProperty System.Object ProductVersion {get=$this.Main...
[dc01]:
Cuando haya terminado de trabajar con la computadora remota, salga de la sesión remota uno a uno usando el cmdlet Exit-PSSession.
[dc01]: Exit-PSSession
Comunicación remota uno a muchos
A veces es posible que necesite realizar una tarea de forma interactiva en una computadora remota. Pero la comunicación remota es mucho más poderosa cuando se realiza una tarea en varias computadoras remotas al mismo tiempo. Utilice el cmdlet Invoke-Command para ejecutar un comando en una o más computadoras remotas al mismo tiempo.
Invoke-Command -ComputerName dc01, sql02, web01 {Get-Service -Name W32time} -Credential $Cred
Status Name DisplayName PSComputerName
------ ---- ----------- --------------
Running W32time Windows Time web01
Start... W32time Windows Time dc01
Running W32time Windows Time sql02
En el ejemplo anterior, se consultó a tres servidores sobre el estado del servicio de hora de Windows. El cmdlet Get-Service se colocó dentro del bloque de script de Invoke-Command. Get-Service en realidad se ejecuta en la computadora remota y los resultados se devuelven a su computadora local como objetos deserializados.
Canalizar el comando anterior a Get-Member muestra que los resultados son de hecho objetos deserializados.
Invoke-Command -ComputerName dc01, sql02, web01 {Get-Service -Name W32time} -Credential $Cred | Get-Member
TypeName: Deserialized.System.ServiceProcess.ServiceController
Name MemberType Definition
---- ---------- ----------
GetType Method type GetType()
ToString Method string ToString(), string ToString(string format, Sys...
Name NoteProperty string Name=W32time
PSComputerName NoteProperty string PSComputerName=sql02
PSShowComputerName NoteProperty bool PSShowComputerName=True
RequiredServices NoteProperty Deserialized.System.ServiceProcess.ServiceController[...
RunspaceId NoteProperty guid RunspaceId=570313c4-ac84-4109-bf67-c6b33236af0a
CanPauseAndContinue Property System.Boolean {get;set;}
CanShutdown Property System.Boolean {get;set;}
CanStop Property System.Boolean {get;set;}
Container Property {get;set;}
DependentServices Property Deserialized.System.ServiceProcess.ServiceController[...
DisplayName Property System.String {get;set;}
MachineName Property System.String {get;set;}
ServiceHandle Property System.String {get;set;}
ServiceName Property System.String {get;set;}
ServicesDependedOn Property Deserialized.System.ServiceProcess.ServiceController[...
ServiceType Property System.String {get;set;}
Site Property {get;set;}
StartType Property System.String {get;set;}
Status Property System.String {get;set;}
Observe que la mayoría de los métodos faltan en los objetos deserializados. Esto significa que no son objetos vivos; son inertes. No puede iniciar ni detener un servicio utilizando un objeto deserializado porque es una instantánea del estado de ese objeto en el momento en que se ejecutó el comando en la computadora remota.
Sin embargo, eso no significa que no puedas iniciar o detener un servicio usando un método con Invoke-Command. Simplemente significa que el método debe llamarse en la sesión remota.
Detendré el servicio de hora de Windows en esos tres servidores remotos usando el método Stop() para demostrar este punto.
Invoke-Command -ComputerName dc01, sql02, web01 {(Get-Service -Name W32time).Stop()} -Credential $Cred
Invoke-Command -ComputerName dc01, sql02, web01 {Get-Service -Name W32time} -Credential $Cred
Status Name DisplayName PSComputerName
------ ---- ----------- --------------
Stopped W32time Windows Time web01
Stopped W32time Windows Time dc01
Stopped W32time Windows Time sql02
Como se mencionó en un capítulo anterior, si existe un cmdlet para realizar una tarea, recomiendo usarlo en lugar de usar un método. En el escenario anterior, recomiendo usar el cmdlet Stop-Service en lugar del método stop. Elegí usar el método Stop() para demostrar un punto, ya que muchas personas tienen la idea errónea de que no se pueden llamar métodos cuando se usa la comunicación remota de PowerShell. No se pueden invocar en el objeto devuelto porque está deserializado, pero se pueden invocar en la propia sesión remota.
Sesiones de PowerShell
En el último ejemplo de la sección anterior, ejecuté dos comandos usando el cmdlet Invoke-Command. Eso significa que se tuvieron que configurar y eliminar dos sesiones separadas para ejecutar esos dos comandos.
De manera similar a las sesiones CIM analizadas en el Capítulo 7, se puede usar una sesión de PowerShell en una computadora remota para ejecutar múltiples comandos en la computadora remota sin la sobrecarga de una nueva sesión para cada comando individual.
Cree una sesión de PowerShell para cada una de las tres computadoras con las que hemos estado trabajando en este capítulo, DC01, SQL02 y WEB01.
$Session = New-PSSession -ComputerName dc01, sql02, web01 -Credential $Cred
Ahora use la variable denominada $Session para iniciar el servicio de hora de Windows usando un método y verificar el estado del servicio.
Invoke-Command -Session $Session {(Get-Service -Name W32time).Start()}
Invoke-Command -Session $Session {Get-Service -Name W32time}
Status Name DisplayName PSComputerName
------ ---- ----------- --------------
Running W32time Windows Time web01
Start... W32time Windows Time dc01
Running W32time Windows Time sql02
Una vez que se crea la sesión con credenciales alternativas, ya no es necesario especificar las credenciales cada vez que se ejecuta un comando.
Cuando haya terminado de usar las sesiones, asegúrese de eliminarlas.
Get-PSSession | Remove-PSSession
Resumen
En este capítulo, aprendió sobre la comunicación remota de PowerShell, cómo ejecutar comandos en una sesión interactiva con una computadora remota y cómo ejecutar comandos en varias computadoras usando la comunicación remota de uno a muchos. También aprendió los beneficios de usar una sesión de PowerShell cuando ejecuta múltiples comandos en la misma computadora remota.
Revisar
- ¿Cómo se habilita la comunicación remota de PowerShell?
- ¿Cuál es el comando de PowerShell para iniciar una sesión interactiva con una computadora remota?
- ¿Cuál es el beneficio de utilizar una sesión remota de PowerShell en lugar de simplemente especificar el nombre de la computadora con cada comando?
- ¿Se puede utilizar una sesión remota de PowerShell con una sesión remota uno a uno?
- ¿Cuál es la diferencia en el tipo de objetos que devuelven los cmdlets versus los que devuelven cuando se ejecutan esos mismos cmdlets en computadoras remotas con
Invoke-Command?
Lectura recomendada
- acerca de_Remoto
- acerca de_Salida_Remota
- about_Remote_Requirements
- about_Remote_Solución de problemas
- about_Remote_Variables
- Preguntas frecuentes sobre la comunicación remota de PowerShell