PowerShell/docs/enter-chat.md
2023-10-31 11:05:01 +01:00

129 lines
2.7 KiB
Markdown

*enter-chat.ps1*
================
This PowerShell script enters a chat using a common network shared file.
Parameters
----------
```powershell
PS> ./enter-chat.ps1 [<CommonParameters>]
[<CommonParameters>]
This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction,
WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
```
Example
-------
```powershell
PS> ./enter-chat.ps1
```
Notes
-----
Author: Markus Fleschutz | License: CC0
Related Links
-------------
https://github.com/fleschutz/PowerShell
Script Content
--------------
```powershell
<#
.SYNOPSIS
Enters a chat using a common network shared file
.DESCRIPTION
This PowerShell script enters a chat using a common network shared file.
.EXAMPLE
PS> ./enter-chat.ps1
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
# make sure you adjust this path
# it must point to a network share where you have read and write permissions
$ServerShare = "\\myserver\chathome"
function Enter-Chat
{
param
(
[Parameter(Mandatory)]
[string]
$ChatChannelName,
[string]
$Name = $env:USERNAME,
[Switch]
$ShowOldPosts,
$HomeShare = $ServerShare
)
if ($ShowOldPosts)
{
$Option = ''
}
else
{
$Option = '-Tail 0'
}
$Path = Join-Path -Path $HomeShare -ChildPath "$ChatChannelName.txt"
$exists = Test-Path -Path $Path
if ($exists -eq $false)
{
$null = New-Item -Path $Path -Force -ItemType File
}
$process = Start-Process -FilePath powershell -ArgumentList "-noprofile -windowstyle hidden -command Get-COntent -Path '$Path' $Option -Wait | Out-GridView -Title 'Chat: [$ChatChannelName]'" -PassThru
Write-Host "To exit, enter: quit"
"[$Name entered the chat]" | Add-Content -Path $Path
do
{
Write-Host "[$ChatChannelName]: " -ForegroundColor Green -NoNewline
$inputText = Read-Host
$isStopCommand = 'quit','exit','stop','leave' -contains $inputText
if ($isStopCommand -eq $false)
{
"[$Name] $inputText" | Add-Content -Path $Path
}
} until ($isStopCommand -eq $true)
"[$Name left the chat]" | Add-Content -Path $Path
$process | Stop-Process
}
function Get-ChatChannel
{
param
(
$HomeShare = $ServerShare
)
Get-ChildItem -Path $HomeShare -Filter *.txt -File |
ForEach-Object {
[PSCustomObject]@{
ChannelName = [System.IO.Path]::GetFileNameWithoutExtension($_.Name)
LastActive = $_.LastWriteTime
Started = $_.CreationTime
}
}
}
```
*(generated by convert-ps2md.ps1 using the comment-based help of enter-chat.ps1 as of 10/19/2023 08:11:37)*