Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erste Schritte mit Amazon Kinesis Agent für Microsoft Windows

Sie können Amazon Kinesis -Agenten für Microsoft Windows (Kinesis -Agenten für Windows) zum Sammeln, Analysieren, Transformieren und Streamen von Protokollen, Ereignissen und Metriken aus Ihrer Windows-Flotte für verschiedene AWS-Services verwenden. Die folgenden Informationen enthalten Voraussetzungen und Schritt-für-Schritt-Anweisungen für die Installation und Konfiguration von Kinesis -Agenten für Windows.

Prerequisites

Stellen vor dem Installieren von Kinesis Agent für Windows sicher, dass die folgenden Voraussetzungen erfüllt sind:

Einrichten eines AWS-Kontos

Wenn Sie kein AWS-Konto haben, führen Sie die folgenden Schritte zum Erstellen eines Kontos durch.

Mit diesen Schritten können Sie weitere Gruppen und Benutzer erstellen und Ihren Benutzern Zugriff auf Ihre AWS-Kontoressourcen gewähren. Weitere Informationen dazu, wie Sie die Berechtigungen eines Benutzers auf bestimmte AWS-Ressourcen mithilfe von Richtlinien beschränken, finden Sie unter Zugriffsverwaltung und Beispielrichtlinien.

Installieren von Kinesis Agent für Windows

Es gibt drei Möglichkeiten, wie Sie Kinesis Agent für Windows unter Windows installieren können:

Installieren von Kinesis Agent für Windows mit MSI

Sie können das neueste Kinesis Agent für Windows MSI-Paket vomKinesis-Agent-Windows-Repository auf GitHub. Nachdem Sie die MSI heruntergeladen haben, starten Sie sie mithilfe von Windows und folgen Sie den Anweisungen des Installationsprogramms. Nach der Installation können Sie wie jede Windows-Anwendung deinstallieren.

Sie können aber auch diemsiexecSo können Sie an der Windows-Eingabeaufforderung automatisch installieren, die Protokollierung aktivieren und deinstallieren, wie in den folgenden Beispielen dargestellt. ErsetzenAWSKinesisTap.1.1.216.4.msi with the appropriate version of Kinesis Agent for Windows for your application.

So installieren Sie Kinesis Agent für Windows automatisch:

msiexec /i AWSKinesisTap.1.1.216.4.msi /q

So protokollieren Sie Installationsmeldungen zur Fehlerbehebung in einer Datei namenslogfile.log:

msiexec /i AWSKinesisTap.1.1.216.4.msi /q /L*V logfile.log

So deinstallieren Sie Kinesis Agent für Windows über die Eingabeaufforderung:

msiexec.exe /x {ADAB3982-68AA-4B45-AE09-7B9C03F3EBD3} /q

Installieren von Kinesis Agent für Windows mit AWS Systems Manager

Führen Sie die folgenden Schritte aus, um Kinesis Agent für Windows mithilfe des Systems Manager Run Command zu installieren. Weitere Informationen zum Run Command finden Sie unterAWS Systems Manager Run CommandimAWS Systems Manager Benutzerhandbuch. Zusätzlich zu dem Systems Manager Run Command können Sie auch Systems ManagerWartungsfensterundState Manager, um die Bereitstellung von Kinesis Agent für Windows im Laufe der Zeit zu automatisieren.

Installieren von Kinesis Agent für Windows mit PowerShell

Verwenden Sie einen Texteditor, um die folgenden Befehle in eine Datei zu kopieren und als PowerShell -Skript zu speichern. Wir verwendenInstallKinesisAgent.ps1Im folgenden Beispiel.

Param(
    [ValidateSet("prod", "beta", "test")]
    [string] $environment = 'prod',
    [string] $version,
    [string] $baseurl
)

# Self-elevate the script if required.
if (-Not ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] 'Administrator')) {
    if ([int](Get-CimInstance -Class Win32_OperatingSystem | Select-Object -ExpandProperty BuildNumber) -ge 6000) {
        $CommandLine = '-File "' + $MyInvocation.MyCommand.Path + '" ' + $MyInvocation.UnboundArguments
        Start-Process -FilePath PowerShell.exe -Verb Runas -ArgumentList $CommandLine
        Exit
    }
}

# Allows input to change base url. Useful for testing.
if ($baseurl) {
    if (!$baseUrl.EndsWith("/")) {
        throw "Invalid baseurl param value. Must end with a trailing forward slash ('/')"
    }

    $kinesistapBaseUrl = $baseurl
} else {
    $kinesistapBaseUrl = "https://s3-us-west-2.amazonaws.com/kinesis-agent-windows/downloads/"
}

Write-Host "Using $kinesistapBaseUrl as base url"

$webClient = New-Object System.Net.WebClient

try {
    $packageJson = $webClient.DownloadString($kinesistapBaseUrl + 'packages.json' + '?_t=' + [System.DateTime]::Now.Ticks) | ConvertFrom-Json
} catch {
    throw "Downloading package list failed."
}


if ($version) {
    $kinesistapPackage = $packageJson.packages | Where-Object { $_.packageName -eq "AWSKinesisTap.$version.nupkg" }

    if ($null -eq $kinesistapPackage) {
        throw "No package found matching input version $version"
    }
} else {
    $packageJson = $packageJson.packages | Where-Object { $_.packageName -match ".nupkg" }
    $kinesistapPackage = $packageJson[0]
}

$packageName = $kinesistapPackage.packageName
$checksum = $kinesistapPackage.checksum

#Create %TEMP%/kinesistap if not exists
$kinesistapTempDir = Join-Path $env:TEMP 'kinesistap'
if (![System.IO.Directory]::Exists($kinesistapTempDir)) {[void][System.IO.Directory]::CreateDirectory($kinesistapTempDir)}

#Download KinesisTap.x.x.x.x.nupkg package
$kinesistapNupkgPath = Join-Path $kinesistapTempDir $packageName
$webClient.DownloadFile($kinesistapBaseUrl + $packageName, $kinesistapNupkgPath)
$kinesistapUnzipPath = $kinesistapNupkgPath.Replace('.nupkg', '')

# Calculates hash of downloaded file. Downlevel compatible using .Net hashing on PS < 4
if ($PSVersionTable.PSVersion.Major -ge 4) {
    $calculatedHash = Get-FileHash $kinesistapNupkgPath -Algorithm SHA256
    $hashAsString = $calculatedHash.Hash.ToLower()
} else {
    $sha256 = New-Object System.Security.Cryptography.SHA256CryptoServiceProvider
    $calculatedHash = [System.BitConverter]::ToString($sha256.ComputeHash([System.IO.File]::ReadAllBytes($kinesistapNupkgPath)))
    $hashAsString = $calculatedHash.Replace("-", "").ToLower()
}

if ($checksum -eq $hashAsString) {
	Write-Host 'Local file hash matches checksum.' -ForegroundColor Green
} else {
	throw ("Get-FileHash does not match! Package may be corrupted.")
}

#Delete Unzip path if not empty
if ([System.IO.Directory]::Exists($kinesistapUnzipPath)) {Remove-Item –Path $kinesistapUnzipPath -Recurse -Force}

#Unzip KinesisTap.x.x.x.x.nupkg package
$null = [System.Reflection.Assembly]::LoadWithPartialName('System.IO.Compression.FileSystem')
[System.IO.Compression.ZipFile]::ExtractToDirectory($kinesistapNupkgPath, $kinesistapUnzipPath)

#Execute chocolaeyInstall.ps1 in the package and wait for completion.
$installScript = Join-Path $kinesistapUnzipPath '\tools\chocolateyInstall.ps1'
& $installScript

# Verify service installed.
$serviceName = 'AWSKinesisTap'
$service = Get-Service -Name $serviceName -ErrorAction Ignore
if ($null -eq $service) {
    throw ("Service not installed correctly.")
} else {
    Write-Host "Kinesis Tap Installed." -ForegroundColor Green
    Write-Host "After configuring run the following to start the service: Start-Service -Name $serviceName." -ForegroundColor Green
}

Öffnen Sie ein Befehlszeilenfenster mit erhöhten Rechten. Verwenden Sie im Verzeichnis, in das die Datei heruntergeladen wurde, den folgenden Befehl, um das Skript auszuführen:

PowerShell.exe -File ".\InstallKinesisAgent.ps1"

Um eine bestimmte Version von Kinesis Agent für Windows zu installieren, fügen Sie die-version:

PowerShell.exe -File ".\InstallKinesisAgent.ps1" -version "version"

Ersetzenversionmit einer gültigen Versionsnummer für Kinesis Agent für Windows. Versionsinformationen finden Sie unterKinesis-Agent-Windows-Repository auf GitHub.

Es gibt zahlreiche Bereitstellungs-Tools, mit denen PowerShell-Skripts remote ausgeführt werden können. Sie können auch zum Automatisieren der Installation von Kinesis Agent für Windows auf Flotten von Servern oder Desktops verwendet werden.

Konfigurieren und Starten von Kinesis Agent für Windows

Nachdem Sie Kinesis Agent für Windows installiert haben, müssen Sie den Agenten konfigurieren und starten. Danach sollte bei der Operation kein weiterer Eingriff erforderlich sein.