Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Nozioni di base su Amazon Kinesis Agent per Microsoft Windows
<a name="getting-started"></a>

È possibile usare Amazon Kinesis Agent per Microsoft Windows (Kinesis Agent per Windows) per raccogliere, analizzare, trasformare e trasmettere i log, gli eventi e i parametri dal tuo parco di Windows ai vari servizi AWS. Le informazioni seguenti contengono prerequisiti e istruzioni dettagliate per l'installazione e la configurazione di Kinesis Agent per Windows.

**Topics**
+ [Prerequisites](#getting-started-prerequisites)
+ [Configurazione di un account AWS](#getting-started-setting-up)
+ [Installazione di Kinesis Agent per Windows](#getting-started-installation)
+ [Configurazione e avvio di Kinesis Agent per Windows](#getting-started-start-service)

## Prerequisites
<a name="getting-started-prerequisites"></a>

Prima di installare Kinesis Agent per Windows, assicurati di disporre dei seguenti prerequisiti:
+ Familiarità con i concetti Kinesis Agent per Windows. Per ulteriori informazioni, consulta [Amazon Kinesis Agent per Microsoft Windows Concetti](kinesis-agent-windows-concepts.md).
+ Un account AWS per l'utilizzo di vari servizi AWS correlati alla pipeline di dati. Per ulteriori informazioni sulla creazione e la configurazione di un account AWS, consulta [Configurazione di un account AWS](#getting-started-setting-up).
+ Microsoft.NET Framework 4.6 o versioni successive su ogni desktop o server che eseguirà Kinesis Agent per Windows. Per ulteriori informazioni, vedere [Installare .NET Framework per gli sviluppatori](https://docs.microsoft.com/en-us/dotnet/framework/install/guide-for-developers) nella documentazione Microsoft .NET.

  Per determinare la versione più recente di .NET Framework installata su un desktop o su un server, utilizzare il seguente script PowerShell:

  ```
       [System.Version](
       (Get-ChildItem 'HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP' -recurse `
       | Get-ItemProperty -Name Version -ErrorAction SilentlyContinue `
       | Where-Object { ($_.PSChildName -match 'Full') } `
       | Select-Object Version | Sort-Object -Property Version -Descending)[0]).Version
  ```
+ I flussi in cui si desidera inviare i dati da Kinesis Agent per Windows (se usi Amazon Kinesis Data Streams). Creare i flussi utilizzando il[Console Kinesis Data Streams](https://console.aws.amazon.com/kinesis/), il[AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html), oppure[Strumenti AWS per Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/reference/items/New-KINStream.html): . Per ulteriori informazioni, consulta[Creazione e aggiornamento dei flussi di dati](https://docs.aws.amazon.com/streams/latest/dev/amazon-kinesis-streams.html)nella*Amazon Kinesis Data Streams*: .
+ I flussi di distribuzione Firehose in cui si desidera inviare i dati da Kinesis Agent per Windows (se usi Amazon Kinesis Data Firehose). Creare flussi di consegna utilizzando il[Kinesis Data Firehose](https://console.aws.amazon.com/firehose/), il[AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/firehose/create-delivery-stream.html), oppure[Strumenti AWS per Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/reference/items/New-KINFDeliveryStream.html): . Per ulteriori informazioni, consulta la sezione relativa alla [creazione di un flusso di distribuzione Amazon Kinesis Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) nella *Guida per sviluppatori Amazon Kinesis Data Firehose*.

## Configurazione di un account AWS
<a name="getting-started-setting-up"></a>

Se non hai un account AWS, completa la procedura seguente per crearne uno.

**Registrazione per creare un account AWS**

1. Aprire la pagina all'indirizzo [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup).

1. Seguire le istruzioni online.

   Come parte della procedura di registrazione riceverai una telefonata, durante la quale dovrai inserire un codice di verifica sulla tastiera del telefono.

**Per creare un utente amministratore per se stessi e aggiungere l'utente a un gruppo di amministratori (console)**

1. Accedere alla [console IAM](https://console.aws.amazon.com/iam/) come proprietario dell'account scegliendo **Root user (Utente root)** e immettendo l'indirizzo email dell'account AWS. Nella pagina successiva, inserisci la password.
**Nota**  
È fortemente consigliato rispettare la best practice sull'utilizzo dell'**Administrator**Utente IAM che segue e conservare in un luogo sicuro le credenziali dell'utente root. Accedere come utente root solo per eseguire alcune [attività di gestione dell'account e del servizio](https://docs.aws.amazon.com/general/latest/gr/aws_tasks-that-require-root.html).

1. Nel riquadro di navigazione selezionare **Users (Utenti)**, quindi selezionare **Add user (Aggiungi utente)**.

1. In **User name (Nome utente)**, immettere **Administrator**.

1. Selezionare la casella di controllo accanto a **AWS Management Console access (Accesso a Console di gestione AWS)**. Quindi, selezionare **Custom password (Password personalizzata)**e immettere la nuova password nella casella di testo.

1. (Facoltativo) Per impostazione predefinita, AWS richiede che il nuovo utente crei una nuova password al primo accesso. Puoi deselezionare la casella di controllo accanto a **User must create a new password at next sign-in (L'utente deve creare una nuova password al prossimo accesso)** per consentire al nuovo utente di reimpostare la propria password dopo aver effettuato l'accesso.

1. Scegliere**Successivo: Autorizzazioni.**

1. In **Set permissions (Imposta autorizzazioni)**, selezionare **Add user to group (Aggiungi l'utente al gruppo)**.

1. Seleziona **Create group** (Crea gruppo).

1. Nella finestra di dialogo **Create group (Crea gruppo)**, per **Group name (Nome gruppo)** immettere **Administrators**.

1. Scegliere**Policy di filtro**e quindi selezionare**AWS gestito - funzione di lavoro**per filtrare il contenuto della tabella.

1. Nell'elenco delle policy, selezionare la casella di controllo accanto ad **AdministratorAccess**. Seleziona quindi **Create group** (Crea gruppo).
**Nota**  
È necessario attivare l'accesso utente e ruolo IAM alla fatturazione prima di poter utilizzare le autorizzazioni `AdministratorAccess` per accedere alla console Fatturazione e gestione costi AWS. A questo scopo, seguire le istruzioni nella [fase 1 del tutorial sulla delega dell'accesso alla console di fatturazione](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_billing.html).

1. Nell'elenco dei gruppi seleziona la casella di controllo per il tuo nuovo gruppo. Se necessario, selezionare **Refresh (Aggiorna)** per visualizzare il gruppo nell'elenco.

1. Scegliere**Successivo: Tags**: .

1. (Facoltativo) Aggiungere metadati all'utente collegando i tag come coppie chiave-valore. Per ulteriori informazioni sull'utilizzo di tag in IAM, consultare [Tagging di utenti e ruoli IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) nella *Guida per l'utente di IAM*.

1. Scegliere**Successivo: Review (Revisione)**Per visualizzare l'elenco delle appartenenze ai gruppi da aggiungere al nuovo utente. Quando sei pronto per continuare, seleziona **Create user (Crea utente)**.

È possibile utilizzare questa stessa procedura per creare altri gruppi e utenti e concedere agli utenti l'accesso alle risorse dell'account AWS. Per ulteriori informazioni sull'utilizzo di policy per limitare le autorizzazioni degli utenti alle risorse AWS, consulta [Gestione degli accessi](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) e [Esempi di policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_examples.html).

**Per effettuare la registrazione ad AWS e creare un account amministratore**

1. Se non disponi di un account AWS, apri[https://aws.amazon.com/](https://aws.amazon.com/): . Selezionare **Create an AWS Account (Crea un account AWS)**, quindi seguire le istruzioni online.

   Come parte della procedura di registrazione si riceverà una telefonata, durante la quale si dovrà inserire un PIN usando la tastiera del telefono.

1. Accedere alla Console di gestione AWS e aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Nel riquadro di navigazione, scegliere **Groups (Gruppi)**, quindi **Create New Group (Crea nuovo gruppo)**.

1. In **Group Name (Nome gruppo)**, digitare un nome per il gruppo, come **Administrators** , quindi scegliere **Next Step (Fase successiva)**.

1. Nell'elenco delle policy, seleziona la casella di controllo accanto alla policy **AdministratorAccess**. È possibile utilizzare il menu **Filter (Filtro)** e la casella **Search (Cerca)** per filtrare l'elenco di policy.

1. Selezionare **Next Step (Fase successiva)**. Scegliere **Create Group (Crea gruppo)** e il tuo nuovo gruppo appare sotto **Group Name (Nome gruppo)**.

1. Nel riquadro di navigazione, seleziona **Users (Utenti)**, quindi scegli **Create New Users (Crea nuovi utenti)**.

1. Nella casella **1**, immettere un nome utente, deselezionare la casella di controllo accanto a **Generate an access key for each user (Generare una chiave di accesso per ogni utente)**, quindi scegliere **Create (Crea)**.

1. Nell'elenco di utenti, selezionare il nome (non la casella di controllo) dell'utente appena creato. È possibile utilizzare la casella **Search (Cerca)** per cercare il nome utente.

1. Selezionare la scheda **Groups (Gruppi)**, quindi scegliere **Add Users to Group (Aggiungi utenti al gruppo)**.

1. Selezionare la casella di controllo accanto al gruppo di amministratori, quindi selezionare **Add to Groups (Aggiungi ai gruppi)**.

1. Seleziona la scheda **Security Credentials (Credenziali di sicurezza)**. In **Sign in Credentials (Credenziali di accesso)**, seleziona **Manage Password (Gestisci password)**.

1. Selezionare **Assign a custom password (Assegna una password personalizzata)**, immettere una password nelle caselle **Password** e **Confirm Password (Conferma password)**, quindi selezionare **Apply (Applica)**.

## Installazione di Kinesis Agent per Windows
<a name="getting-started-installation"></a>

Sono disponibili tre modi per installare Kinesis Agent per Windows su Windows:
+ Installare utilizzando MSI (un pacchetto di installazione di Windows).
+ Installare da[AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/), un set di servizi per l'amministrazione di server e desktop.
+ Esecuzione di uno script PowerShell.

**Nota**  
Le seguenti istruzioni occasionalmente usano i termini *KinesisTap* e *AWSKinesisTap*. Queste parole significano la stessa cosa di Kinesis Agent per Windows, ma è necessario specificarle così come sono durante l'esecuzione di queste istruzioni.

### Installare Kinesis Agent per Windows utilizzando MSI
<a name="install-msi"></a>

È possibile scaricare il pacchetto Kinesis Agent per Windows MSI dalla[repository kinesis-agent-windows su GitHub](https://github.com/awslabs/kinesis-agent-windows/releases): . Dopo aver scaricato MSI, utilizzare Windows per avviarlo e seguire le istruzioni del programma di installazione. Dopo l'installazione, è possibile disinstallare come qualsiasi applicazione Windows.

In alternativa, è possibile utilizzare l'[msiexec](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec)Dal prompt dei comandi di Windows per l'installazione automatica, attivare la registrazione e disinstallare come illustrato negli esempi seguenti. Replace (Sostituisci)`AWSKinesisTap.1.1.216.4.msi with the appropriate version of Kinesis Agent for Windows for your application.`

**Per installare Kinesis Agent per Windows in modo invisibile:**

```
msiexec /i AWSKinesisTap.1.1.216.4.msi /q
```

**Per registrare i messaggi di installazione per la risoluzione dei problemi in un file denominato`logfile.log`:**

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

**Per disinstallare Kinesis Agent per Windows utilizzando il prompt dei comandi:**

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

### Installare Kinesis Agent per Windows utilizzando AWS Systems Manager
<a name="install-systems-manager"></a>

Segui questi passaggi per installare Kinesis Agent per Windows utilizzando il Run Command di Systems Manager. Per ulteriori informazioni su Run Command, consulta[AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/execute-remote-commands.html)nella*AWS Systems Manager*: . Oltre a utilizzare Systems Manager Esegui Command, è anche possibile utilizzare Systems Manager[Intervallo di manutenzione](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-maintenance.html)e[State Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-state.html)per automatizzare la distribuzione di Kinesis Agent per Windows nel tempo.

**Nota**  
L'installazione di Systems Manager per Kinesis Agent per Windows è disponibile nelle regioni AWS elencate in[AWS Systems Manager](https://docs.aws.amazon.com/general/latest/gr/rande.html#ssm_region)Ad eccezione di quanto segue:  
cn-north-1
cn-northwest-1
Tutte le regioni AWS GovCloud.

**Per installare Kinesis Agent per Windows tramite Systems Manager**

1. Verificare che la versione 2.58.0 o successiva dell'Agente SSM sia installata sulle istanze in cui si desidera installare Kinesis Agent per Windows. Per ulteriori informazioni, consulta[Installazione e configurazione dell'Agente SSM sulle istanze Windows](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html)nella*AWS Systems Manager*: .

1. Apri la console AWS Systems Manager all'indirizzo[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/): .

1. Dal riquadro di navigazione, in**Gestione nodi**, scegliere**Run Command di**e quindi scegliere**Run Command di**: .

1. Dal**Documento di comando**, selezionare la casella di controllo**AWS-ConfigureAWSPackage**non valido.  
![\[Selezionare il documento AWS-ConfigureAWSPackage.\]](http://docs.aws.amazon.com/it_it/kinesis-agent-windows/latest/userguide/images/runcommand-document-select.png)

1. UNDER**Parametri di comando**, per**Nome**, immettere**AwskineSap**: . Lasciare altre impostazioni ai valori predefiniti.
**Nota**  
esci**Version**vuoto per specificare la versione più recente del pacchetto AWSkinesISTap. Facoltativamente, è possibile inserire una versione specifica da installare.  
![\[Specificare il pacchetto awskinesiStap nei parametri Command.\]](http://docs.aws.amazon.com/it_it/kinesis-agent-windows/latest/userguide/images/runcommand-specify-options.png)

1. UNDER**Targets**Specificare le istanze su cui eseguire il comando. È possibile scegliere di specificare le istanze in base ai tag associati alle istanze, scegliere le istanze manualmente oppure specificare un gruppo di risorse che includa le istanze.

1. Lasciare tutte le altre impostazioni ai valori predefiniti e selezionare**Esegui**: .

### Installare Kinesis Agent per Windows utilizzando PowerShell
<a name="install-ps"></a>

Utilizzare un editor di testo per copiare i seguenti comandi in un file e salvarlo come script PowerShell. Usiamo`InstallKinesisAgent.ps1`nell'esempio seguente.

```
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
}
```

Aprire una finestra di prompt di comandi elevati. Nella directory in cui è stato scaricato il file, utilizzare il seguente comando per eseguire lo script:

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

Per installare una versione specifica di Kinesis Agent per Windows, aggiungi la`-version`Opzione:

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

Replace (Sostituisci)*version*con un numero di versione valido di Kinesis Agent per Windows. Per informazioni sulla versione, consulta la[repository kinesis-agent-windows su GitHub](https://github.com/awslabs/kinesis-agent-windows/blob/master/README.md): .

Esistono molti strumenti di distribuzione che possono eseguire in remoto script di PowerShell. Possono essere utilizzati per automatizzare l'installazione di Kinesis Agent per Windows su parchi di server o desktop.

## Configurazione e avvio di Kinesis Agent per Windows
<a name="getting-started-start-service"></a>

Dopo aver installato Kinesis Agent per Windows, è necessario configurare e avviare l'agente. Dopodiché, non dovrebbero essere necessari ulteriori interventi.

**Per configurare e avviare Kinesis Agent per Windows**

1. Creare e distribuire un file di configurazione dell'Agente Kinesis per Windows. Questo file configura origini, sink e pipe, insieme ad altri elementi di configurazione globale. 

   Per ulteriori informazioni sulla configurazione di Kinesis Agent per Windows, consulta[Configurazione di Amazon Kinesis Agent per Microsoft Windows](configuring-kinesis-agent-windows.md): .

   Per esempi completi di file di configurazione che è possibile personalizzare e installare, consulta [Esempi di configurazione di Kinesis Agent per Windows](configuring-kaw-examples.md).

1. Aprire una finestra del prompt dei comandi di PowerShell e avviare Kinesis Agent per Windows utilizzando il seguente comando PowerShell:

   ```
   Start-Service -Name AWSKinesisTap
   ```