PSSession management in PowerShell - Mini Project: Build & Apply

Managing PowerShell Sessions with PSSession

📖 Scenario: You are working as a system administrator managing multiple remote servers. To perform tasks efficiently, you want to create and manage PowerShell sessions (PSSessions) to these servers.

🎯 Goal: Build a PowerShell script that creates a PSSession to a remote computer, stores it in a variable, checks the session state, and then closes the session properly.

📋 What You'll Learn

Create a PSSession variable with a specific remote computer name

Create a variable to hold the session state

Use the main PowerShell cmdlets to manage the session

Output the session state clearly

💡 Why This Matters

🌍 Real World

System administrators often need to manage multiple remote servers efficiently. Using PSSessions allows them to keep connections open and run commands remotely without reconnecting each time.

💼 Career

Knowing how to create, manage, and close PSSessions is essential for IT professionals working with Windows servers and automation scripts.

1

Create a PSSession variable

Create a variable called session that stores a new PSSession to the remote computer named Server01 using the New-PSSession cmdlet.

PowerShell

# Create a variable called session to a new PSSession to Server01
# Your code here

Hint

Use New-PSSession -ComputerName Server01 and assign it to $session.

2

Store the session state in a variable

Create a variable called sessionState that stores the state of the session variable using the State property.

PowerShell

$session = New-PSSession -ComputerName Server01
# Create a variable called sessionState to hold the state of the session
# Your code here

Hint

Access the State property of $session and assign it to $sessionState.

3

Close the PSSession

Use the Remove-PSSession cmdlet to close the session. Write the command that removes the session stored in the session variable.

PowerShell

$session = New-PSSession -ComputerName Server01
$sessionState = $session.State
# Remove the PSSession stored in session
# Your code here

Hint

Use Remove-PSSession -Session $session to close the session.

4

Output the session state

Print the value of sessionState using Write-Output to display the session state.

PowerShell

$session = New-PSSession -ComputerName Server01
$sessionState = $session.State
Remove-PSSession -Session $session
# Print the sessionState variable
# Your code here

Hint

Use Write-Output $sessionState to show the session state.

Practice

1. What is the primary purpose of a PSSession in PowerShell?

easy

A. To store variables locally on your computer

B. To create a persistent connection to a remote computer for running commands

C. To display graphical user interfaces

D. To compile PowerShell scripts into executables

Solution

1. Step 1: Understand what PSSession does

   A PSSession creates a persistent connection to a remote computer, allowing you to run commands there without reconnecting each time.

2. Step 2: Compare options to this definition

   Only To create a persistent connection to a remote computer for running commands describes this purpose. Other options describe unrelated tasks.

3. Final Answer:

   To create a persistent connection to a remote computer for running commands -> Option B

4. Quick Check:

   PSSession = persistent remote connection [OK]

Hint: PSSession = persistent remote connection [OK]

Common Mistakes:

• Confusing PSSession with local variable storage
• Thinking PSSession creates GUIs
• Assuming PSSession compiles scripts

2. Which of the following is the correct syntax to create a new PSSession to a computer named 'Server01'?

easy

A. Get-PSSession -ComputerName Server01

B. Invoke-Command -ComputerName Server01

C. New-PSSession -ComputerName Server01

D. Remove-PSSession -ComputerName Server01

Solution

1. Step 1: Identify the cmdlet to create a session

   The cmdlet to create a new session is New-PSSession.

2. Step 2: Check the syntax for specifying the remote computer

   The parameter -ComputerName followed by the computer's name is correct for New-PSSession.

3. Final Answer:

   New-PSSession -ComputerName Server01 -> Option C

4. Quick Check:

   Create session = New-PSSession [OK]

Hint: New-PSSession creates sessions; use -ComputerName for target [OK]

Common Mistakes:

• Using Invoke-Command instead of New-PSSession to create session
• Using Remove-PSSession to create session
• Confusing Get-PSSession with creation

3. What will be the output of this PowerShell code?

 $session = New-PSSession -ComputerName localhost
Invoke-Command -Session $session -ScriptBlock { Get-Process | Select-Object -First 1 }
Remove-PSSession -Session $session 

medium

A. Displays the first process running on the local computer

B. Creates a session but does not display any output

C. Throws an error because Remove-PSSession is called too early

D. Displays all processes running on the local computer

Solution

1. Step 1: Understand the commands

   The code creates a session to localhost, runs a command to get the first process, then removes the session.

2. Step 2: Analyze the Invoke-Command output

   The Invoke-Command runs Get-Process | Select-Object -First 1 remotely, so it outputs the first process object.

3. Final Answer:

   Displays the first process running on the local computer -> Option A

4. Quick Check:

   Invoke-Command outputs first process [OK]

Hint: Invoke-Command outputs scriptblock result before Remove-PSSession [OK]

Common Mistakes:

• Thinking Remove-PSSession stops output
• Assuming no output from Invoke-Command
• Confusing output with all processes

4. You run this script:

 $session = New-PSSession -ComputerName Server01
Invoke-Command -Session $session -ScriptBlock { Get-Date }
Remove-PSSession -Session 

But it throws an error: "Remove-PSSession : Cannot bind argument to parameter 'Session' because it is null." What is the problem?

medium

A. Invoke-Command syntax is incorrect

B. New-PSSession failed to create a session

C. Get-Date cannot run inside a PSSession

D. Remove-PSSession is missing the -Session parameter with the session variable

Solution

1. Step 1: Identify the error cause

   The error says Remove-PSSession has a null argument for -Session, meaning it was called without specifying which session to remove.

2. Step 2: Check the Remove-PSSession command usage

   The script calls Remove-PSSession -Session without the $session value, so PowerShell doesn't know which session to close.

3. Final Answer:

   Remove-PSSession is missing the -Session parameter with the session variable -> Option D

4. Quick Check:

   Remove-PSSession needs -Session argument [OK]

Hint: Always specify -Session when removing sessions [OK]

Common Mistakes:

• Forgetting to pass the session variable to Remove-PSSession
• Assuming Remove-PSSession closes all sessions by default
• Blaming Invoke-Command or New-PSSession incorrectly

5. You want to run a command on multiple remote computers and keep the sessions open for later use. Which approach correctly creates sessions for 'Server01' and 'Server02' and stores them for reuse?

hard

A. $sessions = New-PSSession -ComputerName Server01
$sessions += New-PSSession -ComputerName Server02
Invoke-Command -Session $sessions -ScriptBlock { hostname }

B. $sessions = New-PSSession -ComputerName Server01, Server02
Invoke-Command -ComputerName Server01, Server02 -ScriptBlock { hostname }

C. Invoke-Command -ComputerName Server01, Server02 -ScriptBlock { hostname }
$sessions = $null

D. $sessions = New-PSSession -ComputerName Server01
Invoke-Command -Session $sessions -ScriptBlock { hostname }
Remove-PSSession -Session $sessions

Solution

1. Step 1: Recall how to create persistent sessions for multiple computers

   New-PSSession can take multiple ComputerName values or create separately and collect into an array with +=. Invoke-Command must use -Session $sessions (array) to run on persistent sessions.

2. Step 2: Evaluate each option

   A creates sessions but uses -ComputerName on Invoke-Command, creating temporary connections instead of using persistent ones. B builds the array explicitly and uses -Session. C uses temporary only. D removes sessions.

3. Final Answer:

   $sessions = New-PSSession -ComputerName Server01 $sessions += New-PSSession -ComputerName Server02 Invoke-Command -Session $sessions -ScriptBlock { hostname } -> Option A

4. Quick Check:

   Build session array with +=, use -Session [OK]

Hint: Create and store sessions in a variable array for reuse [OK]

Common Mistakes:

• Removing sessions immediately before reuse
• Not storing sessions in a variable
• Using Invoke-Command without sessions for reuse