• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la documentazione [ di ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) Amazon CloudWatch Dashboard. 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à. # Procedura dettagliata: usa il AWS Tools for Windows PowerShell con Run Command Gli esempi seguenti mostrano come utilizzare il AWS Tools for Windows PowerShell per visualizzare informazioni sui comandi e sui parametri dei comandi, come eseguire i comandi e come visualizzare lo stato di tali comandi. Questa procedura guidata include un esempio per ognuno dei documenti AWS Systems Manager predefiniti. **Importante** Solo gli amministratori fidati dovrebbero essere autorizzati a usare i documenti Systems Manager preconfigurati mostrati in questo argomento. I comandi o gli script specificati nei documenti Systems Manager vengono eseguiti con privilegi amministrativi sui nodi gestiti. Se un utente dispone dell'autorizzazione per eseguire uno qualsiasi dei documenti di Systems Manager predefiniti (qualsiasi documento che inizia con AWS), tale utente dispone anche dell'accesso come amministratore al nodo. Per tutti gli altri utenti, è consigliabile creare documenti restrittivi e condividerli con utenti specifici. ## Configura AWS Tools for Windows PowerShell impostazioni della sessione **Specificare le credenziali** Apri ** Strumenti per Windows PowerShell ** sul tuo computer locale ed esegui il comando seguente per specificare le tue credenziali. È necessario disporre delle autorizzazioni di amministratore sui nodi gestiti che si desidera configurare oppure è necessario disporre dell'autorizzazione appropriata in AWS Identity and Access Management (IAM). Per ulteriori informazioni, consulta [Configurazione dei nodi gestiti per AWS Systems Manager](systems-manager-setting-up-nodes.md). ``` Set-AWSCredentials –AccessKey {{key-name}} –SecretKey {{key-name}} ``` **Imposta un valore predefinito Regione AWS** Esegui il comando seguente per impostare la regione per la tua PowerShell sessione. L'esempio utilizza la regione Stati Uniti orientali (Ohio) (us-east-2). Run Commandè disponibile negli endpoint del servizio Regioni AWS elencati in [ Systems Manager nella. ](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region) *Riferimenti generali di Amazon Web Services* ``` Set-DefaultAWSRegion ` -Region us-east-2 ``` ## Creare un elenco di tutti i documenti disponibili Questo comando elenca tutti i documenti disponibili per il tuo account: ``` Get-SSMDocumentList ``` ## Esegui PowerShell comandi o script Se utilizzi Run Command e il documento `AWS-RunPowerShell`, è possibile eseguire qualsiasi comando o script su un nodo gestito come se fossi connesso localmente. È possibile inviare comandi o digitare il percorso di uno script locale per eseguire il comando. **Nota** Per ulteriori informazioni sul riavvio dei nodi gestiti quando usi Run Command per chiamare gli script, consulta [Gestione di riavvii durante l'esecuzione dei comandi](send-commands-reboot.md). **Visualizzare la descrizione e i parametri disponibili** ``` Get-SSMDocumentDescription ` -Name "AWS-RunPowerShellScript" ``` **Visualizzare ulteriori informazioni sui parametri** ``` Get-SSMDocumentDescription ` -Name "AWS-RunPowerShellScript" | Select -ExpandProperty Parameters ``` ### Invia comandi utilizzando il documento `AWS-RunPowerShellScript` Il comando seguente mostra il contenuto della directory `"C:\Users"` e il contenuto della directory `"C:\"` su due nodi gestiti. ``` $runPSCommand = Send-SSMCommand ` -InstanceIds @("{{instance-ID-1}}", "{{instance-ID-2}}") ` -DocumentName "AWS-RunPowerShellScript" ` -Comment "Demo AWS-RunPowerShellScript with two instances" ` -Parameter @{'commands'=@('dir C:\Users', 'dir C:\')} ``` **Ottenere i dettagli della richiesta del comando** Il comando seguente usa `CommandId` per ottenere lo stato di esecuzione del comando su entrambi i nodi gestiti. Questo esempio usa `CommandId` restituito nel comando precedente. ``` Get-SSMCommand ` -CommandId $runPSCommand.CommandId ``` Lo stato del comando in questo esempio può essere Riuscito, In sospeso o. InProgress **Ottenere informazioni sul comando per nodo gestito** Il comando seguente usa `CommandId` del comando precedente per ottenere lo stato di esecuzione del comando per singoli nodi gestiti. ``` Get-SSMCommandInvocation ` -CommandId $runPSCommand.CommandId ``` **Ottenere informazioni sul comando con i dati di risposta per un nodo gestito specifico** Il comando seguente restituisce l'output del comando `Send-SSMCommand` originale per un nodo gestito specifico. ``` Get-SSMCommandInvocation ` -CommandId $runPSCommand.CommandId ` -Details $true ` -InstanceId {{instance-ID}} | Select -ExpandProperty CommandPlugins ``` ### Annullare un comando Il comando seguente annulla `Send-SSMCommand` per il documento `AWS-RunPowerShellScript`. ``` $cancelCommand = Send-SSMCommand ` -InstanceIds @("{{instance-ID-1}}","{{instance-ID-2}}") ` -DocumentName "AWS-RunPowerShellScript" ` -Comment "Demo AWS-RunPowerShellScript with two instances" ` -Parameter @{'commands'='Start-Sleep –Seconds 120; dir C:\'} Stop-SSMCommand -CommandId $cancelCommand.CommandId ``` **Controllare lo stato del comando** Il comando seguente controlla lo stato del comando `Cancel` ``` Get-SSMCommand ` -CommandId $cancelCommand.CommandId ``` ## Installare un'applicazione usando`AWS-InstallApplication`documento Utilizzando Run Command e il documento `AWS-InstallApplication`, è possibile installare, riparare o disinstallare applicazioni su nodi gestiti. Il comando richiede il percorso o l'indirizzo di un file MSI. **Nota** Per ulteriori informazioni sul riavvio dei nodi gestiti quando usi Run Command per chiamare gli script, consulta [Gestione di riavvii durante l'esecuzione dei comandi](send-commands-reboot.md). **Visualizzare la descrizione e i parametri disponibili** ``` Get-SSMDocumentDescription ` -Name "AWS-InstallApplication" ``` **Visualizzare ulteriori informazioni sui parametri** ``` Get-SSMDocumentDescription ` -Name "AWS-InstallApplication" | Select -ExpandProperty Parameters ``` ### Invia comandi utilizzando il documento `AWS-InstallApplication` Il comando seguente installa una versione di Python nel nodo gestito in modalità automatica e registra l'output in un file di testo locale nell'unità `C:`. ``` $installAppCommand = Send-SSMCommand ` -InstanceId {{instance-ID}} ` -DocumentName "AWS-InstallApplication" ` -Parameter @{'source'='https://www.python.org/ftp/python/2.7.9/python-2.7.9.msi'; 'parameters'='/norestart /quiet /log c:\pythoninstall.txt'} ``` **Ottenere informazioni sul comando per nodo gestito** Il comando seguente usa `CommandId` per ottenere lo stato di esecuzione del comando. ``` Get-SSMCommandInvocation ` -CommandId $installAppCommand.CommandId ` -Details $true ``` **Ottenere informazioni sul comando con i dati di risposta per un nodo gestito specifico** Il comando seguente restituisce i risultati dell'installazione di Python. ``` Get-SSMCommandInvocation ` -CommandId $installAppCommand.CommandId ` -Details $true ` -InstanceId {{instance-ID}} | Select -ExpandProperty CommandPlugins ``` ## Installa un PowerShell modulo utilizzando il documento `AWS-InstallPowerShellModule` JSON È possibile utilizzarlo Run Command per installare PowerShell moduli su nodi gestiti. Per ulteriori informazioni sui PowerShell moduli, vedere PowerShell Moduli [ Windows](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_modules?view=powershell-6). **Visualizzare la descrizione e i parametri disponibili** ``` Get-SSMDocumentDescription ` -Name "AWS-InstallPowerShellModule" ``` **Visualizzare ulteriori informazioni sui parametri** ``` Get-SSMDocumentDescription ` -Name "AWS-InstallPowerShellModule" | Select -ExpandProperty Parameters ``` ### Installare un PowerShell modulo Il comando seguente scarica il EZOut.zip file, lo installa e quindi esegue un comando aggiuntivo per installare XPS Viewer. Infine, l'output di questo comando viene caricato in un bucket S3 denominato “amzn-s3-demo-bucket”. ``` $installPSCommand = Send-SSMCommand ` -InstanceId {{instance-ID}} ` -DocumentName "AWS-InstallPowerShellModule" ` -Parameter @{'source'='https://gallery.technet.microsoft.com/EZOut-33ae0fb7/file/110351/1/EZOut.zip';'commands'=@('Add-WindowsFeature -name XPS-Viewer -restart')} ` -OutputS3BucketName {{amzn-s3-demo-bucket}} ``` **Ottenere informazioni sul comando per nodo gestito** Il comando seguente usa `CommandId` per ottenere lo stato di esecuzione del comando. ``` Get-SSMCommandInvocation ` -CommandId $installPSCommand.CommandId ` -Details $true ``` **Ottenere informazioni sul comando con i dati di risposta per il nodo gestito** Il comando seguente restituisce l'output del comando `Send-SSMCommand` originale per il `CommandId` specifico. ``` Get-SSMCommandInvocation ` -CommandId $installPSCommand.CommandId ` -Details $true | Select -ExpandProperty CommandPlugins ``` ## Aggiungere un nodo gestito a un dominio usando il Documento JSON `AWS-JoinDirectoryServiceDomain` UtilizzandoRun Command, è possibile aggiungere rapidamente un nodo gestito a un Servizio di directory AWS dominio. Prima di eseguire il comando, è necessario [creare una directory](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_getting_started_create_directory.html). Ti consigliamo anche di consultare Directory Service. Per ulteriori informazioni, consulta la [Guida di amministrazione di Servizio di directory AWS](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/). Al momento è possibile solo aggiungere un nodo gestito a un dominio. Non è possibile rimuovere un nodo gestito da un dominio. **Nota** Per informazioni sui nodi gestiti durante l'utilizzo di Run Command per chiamare script, vedi [Gestione di riavvii durante l'esecuzione dei comandi](send-commands-reboot.md). **Visualizzare la descrizione e i parametri disponibili** ``` Get-SSMDocumentDescription ` -Name "AWS-JoinDirectoryServiceDomain" ``` **Visualizzare ulteriori informazioni sui parametri** ``` Get-SSMDocumentDescription ` -Name "AWS-JoinDirectoryServiceDomain" | Select -ExpandProperty Parameters ``` ### Unisci un nodo gestito a un dominio Il comando seguente unisce un nodo gestito al Directory Service dominio specificato e carica qualsiasi output generato nel bucket Amazon Simple Storage Service (Amazon S3) di esempio. ``` $domainJoinCommand = Send-SSMCommand ` -InstanceId {{instance-ID}} ` -DocumentName "AWS-JoinDirectoryServiceDomain" ` -Parameter @{'directoryId'='{{d-example01}}'; 'directoryName'='{{ssm.example.com}}'; 'dnsIpAddresses'=@('{{192.168.10.195}}', '{{192.168.20.97}}')} ` -OutputS3BucketName {{amzn-s3-demo-bucket}} ``` **Ottenere informazioni sul comando per nodo gestito** Il comando seguente usa `CommandId` per ottenere lo stato di esecuzione del comando. ``` Get-SSMCommandInvocation ` -CommandId $domainJoinCommand.CommandId ` -Details $true ``` **Ottenere informazioni sul comando con i dati di risposta per il nodo gestito** Questo comando restituisce l'output dell'originale `Send-SSMCommand` per lo specifico `CommandId`. ``` Get-SSMCommandInvocation ` -CommandId $domainJoinCommand.CommandId ` -Details $true | Select -ExpandProperty CommandPlugins ``` ## Invia le metriche di Windows ad Amazon Logs utilizzando il documento CloudWatch `AWS-ConfigureCloudWatch` Puoi inviare Windows Server messaggi nei log di applicazione, sistema, sicurezza ed Event Tracing for Windows (ETW) ad Amazon Logs. CloudWatch Quando abiliti la registrazione per la prima volta, invia tutti i log generati entro un (1) minuto dal momento in cui inizi il caricamento per i log applicazioni, di sistema, di sicurezza e di ETW. I log precedenti a questo intervallo non sono inclusi. Se disabiliti la registrazione e la riattivi in seguito, Systems Manager invia i log dal momento che è stata interrotta. Per tutti i file di log personalizzati e log IIS (Internet Information Services), Systems Manager legge i file di log dall'inizio. Inoltre, Systems Manager può anche inviare i dati dei contatori delle prestazioni a CloudWatch Logs. Se in precedenza è stata attivata CloudWatch l'integrazione in EC2Config, le impostazioni di Systems Manager hanno la precedenza su tutte le impostazioni archiviate localmente nel nodo gestito del file. `C:\Program Files\Amazon\EC2ConfigService\Settings\AWS.EC2.Windows.CloudWatch.json` Per ulteriori informazioni sull'utilizzo di EC2Config per gestire i contatori delle prestazioni e i log su un singolo nodo gestito, consulta [ Raccolta di metriche e registri da istanze Amazon EC2 e server locali con l'agente nella Amazon User Guide. CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) * CloudWatch * **Visualizzare la descrizione e i parametri disponibili** ``` Get-SSMDocumentDescription ` -Name "AWS-ConfigureCloudWatch" ``` **Visualizzare ulteriori informazioni sui parametri** ``` Get-SSMDocumentDescription ` -Name "AWS-ConfigureCloudWatch" | Select -ExpandProperty Parameters ``` ### Invia i log delle applicazioni a CloudWatch Il comando seguente configura il nodo gestito e sposta i registri delle applicazioni Windows in CloudWatch. ``` $cloudWatchCommand = Send-SSMCommand ` -InstanceID {{instance-ID}} ` -DocumentName "AWS-ConfigureCloudWatch" ` -Parameter @{'properties'='{"engineConfiguration": {"PollInterval":"00:00:15", "Components":[{"Id":"ApplicationEventLog", "FullName":"AWS.EC2.Windows.CloudWatch.EventLog.EventLogInputComponent,AWS.EC2.Windows.CloudWatch", "Parameters":{"LogName":"Application", "Levels":"7"}},{"Id":"CloudWatch", "FullName":"AWS.EC2.Windows.CloudWatch.CloudWatchLogsOutput,AWS.EC2.Windows.CloudWatch", "Parameters":{"Region":"{{region}}", "LogGroup":"{{my-log-group}}", "LogStream":"{{instance-id}}"}}], "Flows":{"Flows":["ApplicationEventLog,CloudWatch"]}}}'} ``` **Ottenere informazioni sul comando per nodo gestito** Il comando seguente usa `CommandId` per ottenere lo stato di esecuzione del comando. ``` Get-SSMCommandInvocation ` -CommandId $cloudWatchCommand.CommandId ` -Details $true ``` **Ottenere informazioni sul comando con i dati di risposta per un nodo gestito specifico** Il comando seguente restituisce i risultati della CloudWatch configurazione Amazon. ``` Get-SSMCommandInvocation ` -CommandId $cloudWatchCommand.CommandId ` -Details $true ` -InstanceId {{instance-ID}} | Select -ExpandProperty CommandPlugins ``` ### Invia i contatori delle prestazioni all' CloudWatch uso del documento `AWS-ConfigureCloudWatch` Il seguente comando dimostrativo carica i contatori delle prestazioni in. CloudWatch Per ulteriori informazioni, consulta la * [ Amazon CloudWatch User Guide. ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/) * ``` $cloudWatchMetricsCommand = Send-SSMCommand ` -InstanceID {{instance-ID}} ` -DocumentName "AWS-ConfigureCloudWatch" ` -Parameter @{'properties'='{"engineConfiguration": {"PollInterval":"00:00:15", "Components":[{"Id":"PerformanceCounter", "FullName":"AWS.EC2.Windows.CloudWatch.PerformanceCounterComponent.PerformanceCounterInputComponent,AWS.EC2.Windows.CloudWatch", "Parameters":{"CategoryName":"Memory", "CounterName":"Available MBytes", "InstanceName":"", "MetricName":"AvailableMemory", "Unit":"Megabytes","DimensionName":"", "DimensionValue":""}},{"Id":"CloudWatch", "FullName":"AWS.EC2.Windows.CloudWatch.CloudWatch.CloudWatchOutputComponent,AWS.EC2.Windows.CloudWatch", "Parameters":{"AccessKey":"", "SecretKey":"","Region":"{{region}}", "NameSpace":"Windows-Default"}}], "Flows":{"Flows":["PerformanceCounter,CloudWatch"]}}}'} ``` ## Attivare o disattivare l'aggiornamento automatico di Windows utilizzando il`AWS-ConfigureWindowsUpdate`documento Con Run Command e il documento `AWS-ConfigureWindowsUpdate` è possibile abilitare o disabilitare gli aggiornamenti automatici di Windows nei nodi gestiti Windows Server. Questo comando configura l'agente di aggiornamento di Windows in modo da scaricare e installare gli aggiornamenti di Windows nel giorno e all'ora specificati. Se un aggiornamento richiede il riavvio, il nodo gestito si riavvia automaticamente 15 minuti dopo l'installazione degli aggiornamenti. Con questo comando è possibile anche configurare Windows Update in modo da controllare la disponibilità di aggiornamenti senza installarli. Il documento `AWS-ConfigureWindowsUpdate` è ufficialmente supportato in Windows Server 2012 e nelle versioni successive. **Visualizzare la descrizione e i parametri disponibili** ``` Get-SSMDocumentDescription ` –Name "AWS-ConfigureWindowsUpdate" ``` **Visualizzare ulteriori informazioni sui parametri** ``` Get-SSMDocumentDescription ` -Name "AWS-ConfigureWindowsUpdate" | Select -ExpandProperty Parameters ``` ### Attivare l'aggiornamento automatico di Windows Il comando seguente configura Windows Update in modo da scaricare e installare automaticamente gli aggiornamenti ogni giorno alle 10:00. ``` $configureWindowsUpdateCommand = Send-SSMCommand ` -InstanceId {{instance-ID}} ` -DocumentName "AWS-ConfigureWindowsUpdate" ` -Parameters @{'updateLevel'='InstallUpdatesAutomatically'; 'scheduledInstallDay'='Daily'; 'scheduledInstallTime'='22:00'} ``` **Visualizzare lo stato del comando per abilitare l'aggiornamento automatico di Windows** Il comando seguente usa `CommandId` per ottenere lo stato di esecuzione del comando e abilitare l'aggiornamento automatico di Windows. ``` Get-SSMCommandInvocation ` -Details $true ` -CommandId $configureWindowsUpdateCommand.CommandId | Select -ExpandProperty CommandPlugins ``` ### Disabilitare l'aggiornamento automatico di Windows Il comando seguente riduce il livello della notifica di Windows Update in modo che il sistema verifichi la disponibilità di aggiornamenti senza aggiornare automaticamente il nodo gestito. ``` $configureWindowsUpdateCommand = Send-SSMCommand ` -InstanceId {{instance-ID}} ` -DocumentName "AWS-ConfigureWindowsUpdate" ` -Parameters @{'updateLevel'='NeverCheckForUpdates'} ``` **Visualizzare lo stato del comando per disabilitare l'aggiornamento automatico di Windows** Il comando seguente usa `CommandId` per ottenere lo stato di esecuzione del comando e abilitare l'aggiornamento automatico di Windows. ``` Get-SSMCommandInvocation ` -Details $true ` -CommandId $configureWindowsUpdateCommand.CommandId | Select -ExpandProperty CommandPlugins ``` ## Gestisci gli aggiornamenti di Windows utilizzando Run Command Utilizzando Run Command e il documento `AWS-InstallWindowsUpdates` è possibile gestire gli aggiornamenti per i nodi gestiti Windows Server. Questo comando analizza o installa gli aggiornamenti mancanti sui nodi gestiti e, facoltativamente, si riavvia dopo l'installazione. È possibile anche specificare le classificazioni e i livelli di gravità appropriati per gli aggiornamenti da installare nell'ambiente. **Nota** Per ulteriori informazioni sul riavvio dei nodi gestiti quando usi Run Command per chiamare gli script, consulta [Gestione di riavvii durante l'esecuzione dei comandi](send-commands-reboot.md). Gli esempi seguenti dimostrano come eseguire le attività di gestione di Windows Update specificate. ### Cercare tutti gli aggiornamenti di Windows mancanti ``` Send-SSMCommand ` -InstanceId {{instance-ID}} ` -DocumentName "AWS-InstallWindowsUpdates" ` -Parameters @{'Action'='Scan'} ``` ### Installare specifici aggiornamenti di Windows ``` Send-SSMCommand ` -InstanceId {{instance-ID}} ` -DocumentName "AWS-InstallWindowsUpdates" ` -Parameters @{'Action'='Install';'IncludeKbs'='{{kb-ID-1}},{{kb-ID-2}},{{kb-ID-3}}';'AllowReboot'='True'} ``` ### Installare importanti aggiornamenti di Windows mancanti ``` Send-SSMCommand ` -InstanceId {{instance-ID}} ` -DocumentName "AWS-InstallWindowsUpdates" ` -Parameters @{'Action'='Install';'SeverityLevels'='Important';'AllowReboot'='True'} ``` ### Installare gli aggiornamenti di Windows mancanti con specifiche esclusioni ``` Send-SSMCommand ` -InstanceId {{instance-ID}} ` -DocumentName "AWS-InstallWindowsUpdates" ` -Parameters @{'Action'='Install';'ExcludeKbs'='{{kb-ID-1}},{{kb-ID-2}}';'AllowReboot'='True'} ```