非持久虛擬裝置基礎架構 (NP-VDI)

.SYNOPSIS

更新非持續性代理程式，等待更新完成，然後選擇性密封代理程式。

.PARAMETER TimeoutSec

總逾時秒數。

.PARAMETER UpgradeCode

正在更新的代理程式的升級代碼。

.PARAMETER DoNotSeal

此參數指定更新後不密封代理程式。

#>

參數

(

[int] $TimeoutSec = 300,

[guid] $UpgradeCode = "{0C5D7E9C-0424-462D-A570-2A7469EE3739}", # Neurons Agent

[switch] $DoNotSeal

)

函數 Check-UpdatersComplete

{

$updaters = Get-Process -Name "STAgentUpdater" -ErrorAction SilentlyContinue

return ($updaters.Count -eq 0)

}

函數 Wait-UpdatersComplete([DateTime] $timeoutDateTime, [int] $checkIntervalSec)

{

while ((Get-Date) -lt $timeoutDateTime)

{

if (Check-UpdatersComplete)

{

返回

}

Start-Sleep -Seconds $checkIntervalSec

}

引發「等待所有更新程式完成逾時」。

}

函數 Get-AgentVersionFromManifest([string] $manifestPath, [string] $platformKey)

{

if (-not (Test-Path $manifestPath))

{

引發「在 '$manifestPath' 找不到資訊清單」。

}

[xml]$manifestXml = Get-Content $manifestPath

$agentFile = $manifestXml.manifest.files.file | Where-Object { $_.key -eq $platformKey }

if (-not ($agentFile))

{

引發「未找到 key='$platformKey' 的代理程式項目」。

}

if (-not ($agentFile.version))

{

引發「無法找到資訊清單中的代理程式版本」。

}

return [version]::Parse($agentFile.version)

}

函數 Get-CurrentAgentVersion([guid] $agentUpgradeCode)

{

$agentProductCode = Get-ProductCode -UpgradeCode $agentUpgradeCode

$agentObject = Get-WmiObject -Class Win32_Product | Where-Object { [guid]::Parse($_.IdentifyingNumber) -eq $agentProductCode }

if (-not ($agentObject))

{

引發「找不到安裝的代理程式」。

}

if (-not ($agentObject.Version))

{

引發「找不到安裝的代理程式版本」。

}

return [version]::Parse($agentObject.Version)

}

函數 Check-AgentUpToDate([string] $manifestPath, [guid] $agentUpgradeCode, [string] $platformKey)

{

$manifestVersion = Get-AgentVersionFromManifest -ManifestPath $manifestPath -PlatformKey $platformKey

$currentVersion = Get-CurrentAgentVersion -AgentUpgradeCode $agentUpgradeCode

return ($currentVersion -ge $manifestVersion)

}

函數 Wait-AgentUpdated([DateTime] $timeoutDateTime, [int] $checkIntervalSec, [string] $manifestPath, [guid] $agentUpgradeCode, [string] $platformKey)

{

while ((Get-Date) -lt $timeoutDateTime)

{

if (Check-AgentUpToDate -ManifestPath $manifestPath -AgentUpgradeCode $agentUpgradeCode -PlatformKey $platformKey)

{

返回

}

Start-Sleep -Seconds $checkIntervalSec

}

引發「等待代理程式更新逾時」。

}

函數 Update-Agent([DateTime] $timeoutDateTime, [string] $manifestPath, [guid] $agentUpgradeCode, [string] $agentCtlPath, [string] $platformKey)

{

$timeoutSec = [math]::Ceiling(($timeoutDateTime - (Get-Date)).TotalSeconds)

if ($timeoutSec -le 0)

{

引發「由於短暫逾時，無法執行簽入」。

}

& $agentCtlPath update --checkin --wait $timeoutSec

if (-not $?)

{

引發「簽入操作失敗」。

}

& $agentCtlPath update --all

if (-not $?)

{

引發「更新操作失敗」。

}

Wait-AgentUpdated -TimeoutDateTime $timeoutDateTime -CheckIntervalSec 1 -ManifestPath $manifestPath -AgentUpgradeCode $agentUpgradeCode -PlatformKey $platformKey

Wait-UpdatersComplete -TimeoutDateTime $timeoutDateTime -CheckIntervalSec 1

$timeoutSec = [math]::Ceiling(($timeoutDateTime - (Get-Date)).TotalSeconds)

if ($timeoutSec -le 0)

{

引發「由於短暫逾時，無法執行最終更新」。

}

& $agentCtlPath update --all --wait $timeoutSec

if (-not $?)

{

引發「最終更新操作失敗」。

}

}

函數 Get-ProductCode([guid] $upgradeCode)

{

$upgradeCodeStr = $upgradeCode.ToString("B") # 格式化為 {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}

$wmiFilter = "Property='UpgradeCode' AND Value='$upgradeCodeStr'"

$productCode = @(Get-WmiObject -Class Win32_Property -Filter $wmiFilter).ProductCode

if ($productCode.Count -eq 0)

{

找不到「找不到升級代碼 '$upgradeCode'」。

}

if ($productCode.Count -gt 1)

{

引發「找到具有相同升級碼 '$upgradeCode' 的多個產品」。

}

return [guid]::Parse($productCode)

}

函數 Get-AgentEnvironment([string] $installDirPath)

{

$configPath = Join-Path $installDirPath "AgentEnvironment.config"

if (-Not (Test-Path $configPath))

{

引發「在 $configPath 找不到組態檔案」。

}

[xml]$agentEnvironment = Get-Content $configPath

return $agentEnvironment

}

函數 Get-InstallLocation([guid] $productCode)

{

$productObject = Get-WmiObject -Class Win32_Product | Where-Object { [guid]::Parse($_.IdentifyingNumber) -eq $productCode }

if ($null -eq $productObject)

{

引發「找不到產品 GUID」。

}

return $productObject.InstallLocation

}

$timeoutDateTime = (Get-Date).AddSeconds($TimeoutSec)

寫入主機「正在收集資訊...」

嘗試

{

$agentProductCode = Get-ProductCode -UpgradeCode $UpgradeCode

$installDirPath = Get-InstallLocation -ProductCode $agentProductCode

寫入主機「安裝目錄: $installDirPath」

$agentEnvironment = Get-AgentEnvironment -InstallDirPath $installDirPath

$dataDirPath = $agentEnvironment.agentEnvironment.agentDataDirectory

寫入主機「資料目錄: $dataDirPath」

$regPath = Join-Path "HKLM:" $agentEnvironment.agentEnvironment.registryPath

寫入主機「登錄金鑰: $regPath」

$platformKey = Get-ItemProperty -Path $regPath -Name "PlatformManifestKey" -ErrorAction Stop | Select-Object -ExpandProperty "PlatformManifestKey" -ErrorAction Stop

寫入主機「平台金鑰: $platformKey」

$agentCtlPath = Join-Path $installDirPath "STAgentCtl.exe"

$manifestPath = Join-Path $dataDirPath "manifest.xml"

}

捕獲

{

寫入錯誤「錯誤: $_」

exit -1

}

if ((Get-Date) -gt $timeoutDateTime)

{

寫入錯誤「錯誤: 代理程式更新開始前逾時。」

exit -1

}

寫入主機「正在解除代理程式密封...」

& $agentCtlPath unseal

if (-not $?)

{

寫入錯誤「錯誤: 無法執行取消密封操作」。

exit -1

}

寫入主機「正在更新代理程式...」

$result = -1

嘗試

{

Update-Agent -TimeoutDateTime $timeoutDateTime -ManifestPath $manifestPath -AgentUpgradeCode $UpgradeCode -AgentCtlPath $agentCtlPath -PlatformKey $platformKey

$result = 0

}

捕獲

{

寫入錯誤「錯誤: $_」

}

if ($DoNotSeal)

{

if ($result -eq 0)

{

寫入主機「代理程式已成功更新」。

}

else

{

寫入錯誤「錯誤: 代理程式更新失敗。」

}

exit $result

}

寫入主機「正在停止代理程式...」

& $agentCtlPath seal

if (-not $?)

{

寫入錯誤「錯誤: 無法密封代理程式！」

exit -1

}

if ($result -eq 0)

{

寫入主機「代理程式已成功更新並封裝」。

}

exit $result

(@ECHO 關閉

設定 pw=supersecret

set logfile=C:\ProgramData\Ivanti\Ivanti Cloud Agent\Logs\agentkeyrestore.log

set certFile=C:\Program Files\Ivanti\Ivanti Cloud Agent\agent.pfx

設定 scriptPath=%0%

ECHO %date% %time% 代理程式金鑰還原已開始 >> "%logfile%"

IF EXIST "%certFile%" (

certutil -f -p "%pw%" -privatekey -importPFX "Ivanti Cloud Agent Agent" "%certFile%" NoCert,NoExport >> "%logfile%" 2>&1

IF %ERRORLEVEL% NEQ 0 (

ECHO 匯入代理程式金鑰失敗 >> "%logfile%"

)

ECHO 正在移除代理機碼檔案 >> "%logfile%"

del "%certFile%" >> "%logfile%" 2>&1

IF %ERRORLEVEL% NEQ 0 (

ECHO 無法刪除代理程式金鑰檔案 >> "%logfile%"

)

ECHO %date% %time% 代理程式金鑰還原完成 >> "%logfile%"

) ELSE (

ECHO %date% %time% 代理程式金鑰還原失敗: 找不到代理程式金鑰檔案 >> "%logfile%"

)

ECHO 正在移除指令碼 >> "%logfile%"

del "%scriptPath%" >> "%logfile%" 2>&1

「REM 無法從此點執行進一步的指令，因為已刪除指令碼檔案」