> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/it/piattaforma/computers.md).

# Computer

Gestisca i server PowerShell Universal e i Devolutions Agent, inclusi tag statici, gruppi di computer, configurazione condivisa e modalità di manutenzione.

> \[!NOTE] Questa funzionalità richiede una licenza. Ogni computer richiede una licenza.

La scheda **Gestisci > Computer e gruppi > Computer** elenca i server PowerShell Universal e i Devolutions Agent connessi. In un'installazione multi-nodo, i job, i gruppi di computer, le identità e i token app sono archiviati nel database condiviso e sono visibili da ogni server connesso.

## Connettere i server PowerShell Universal

Per aggiungere un server a una farm esistente, lo configuri con la stessa stringa di connessione al database SQL e lo stesso repository Git. All'avvio, il server recupera la configurazione del repository e diventa disponibile come computer.

Per le distribuzioni Docker, configuri un `NodeName` stabile nelle impostazioni dell'app. Altrimenti i container ricevono un nuovo nome computer all'avvio, il che può creare record di computer non necessari.

## Devolutions Agent

I Devolutions Agent connessi appaiono come computer **Agent**. Registri e autentichi l'agent come descritto in **Configurazione > Agent**; PowerShell Universal crea o aggiorna il record del computer quando l'agent si connette e lo contrassegna come offline al termine della connessione.

I computer agent riportano la propria versione, lo stato online e il nome macchina della connessione. Utilizzi i gruppi di computer per indirizzare i job e le pianificazioni supportati verso agent selezionati o verso un insieme di agent con caratteristiche corrispondenti.

## Tag

I tag raggruppano i computer per caratteristiche e determinano l'appartenenza ai gruppi di computer. Un gruppo di computer richiede che ogni valore di tag configurato sia presente sul computer.

### Tag del server

PowerShell Universal rileva tag come dominio, nome utente e sistema operativo. Può aggiungere tag statici tramite **Gestisci > Computer e gruppi > Computer** oppure configurarli all'avvio. I tag di avvio sono utili per Docker e altre distribuzioni automatizzate perché non richiedono modifiche manuali dopo l'avvio di un server.

Aggiunga i tag in `appsettings.json`:

```json
{
  "Computer": {
    "Tags": [
      {
        "Name": "Region",
        "Value": "East"
      }
    ]
  }
}
```

Imposti le variabili d'ambiente equivalenti prima di avviare PowerShell Universal:

```
Computer__Tags__0__Name=Region
Computer__Tags__0__Value=East
```

I tag configurati sono statici e appaiono sul server locale in **Gestisci > Computer e gruppi > Computer**.

### Tag dell'agent

Quando un Devolutions Agent si registra, PowerShell Universal aggiunge tag statici dalle sue informazioni di registrazione:

| Nome tag         | Valore                                  |
| ---------------- | --------------------------------------- |
| Type             | `Agent`                                 |
| Machine Name     | Il nome host dell'agent                 |
| Operating System | Il sistema operativo riportato          |
| Architecture     | L'architettura del processore riportata |
| Hub              | Ogni hub Devolutions Gateway riportato  |
| Capability       | Ogni funzionalità dell'agent riportata  |

Questi tag permettono di creare gruppi in base alla piattaforma dell'agent, all'hub o alla funzionalità disponibile. Sono gestiti dalla registrazione dell'agent e si aggiornano quando l'agent si riconnette.

## Gruppi di computer

I gruppi di computer contengono computer che condividono i valori di tag richiesti. Crei i gruppi in **Gestisci > Computer e gruppi > Gruppi** o con `New-PSUComputerGroup`.

Ad esempio, questo gruppo include i computer con il tag `windows`:

```powershell
New-PSUComputerGroup -Name 'Windows' -Tags @('windows')
```

Utilizzi i tag dell'agent per indirizzare tutti i Devolutions Agent connessi:

```powershell
New-PSUComputerGroup -Name 'Devolutions Agents' -Tags @('Agent')
```

Dopo aver creato un gruppo, limiti app, API, script, pianificazioni e job ad esso. Questa app viene eseguita solo sui computer del gruppo `Windows`:

```powershell
New-PSUApp -Name 'Windows' -FilePath 'app.ps1' -BaseUrl '/app' -ComputerGroup 'Windows'
```

## Modalità di manutenzione

Abiliti la modalità di manutenzione per un computer per impedirgli di eseguire job pianificati. Lo faccia prima di eseguire la manutenzione di un server o di mettere offline un host agent.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/it/piattaforma/computers.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.