Panoramica dei cmdlet di PowerShell per Gruppi di disponibilità Always On
Si applica a: 
SQL Server
Microsoft PowerShell è una shell della riga di comando basata su attività e un linguaggio di scripting progettato appositamente per l'amministrazione del sistema. Gruppi di disponibilità Always On fornisce un set di cmdlet di PowerShell in SQL Server per distribuire, gestire e monitorare gruppi di disponibilità, repliche di disponibilità e database di disponibilità.
Nota
Con l'inizio corretto di un'azione è possibile che venga completato un cmdlet di PowerShell. Ciò non implica che l'azione desiderata, ad esempio il failover di un gruppo di disponibilità, sia stata completata. Quando si genera lo script di una sequenza di azioni, può essere necessario controllare lo stato delle azioni e attenderne il completamento.
Nota
Per un elenco degli argomenti nella documentazione online di SQL Server che illustrano come usare i cmdlet per eseguire attività di Gruppi di disponibilità Always On, vedere la sezione "Attività correlate" di Panoramica di Gruppi di disponibilità Always On (SQL Server).
Configurazione di un'istanza del server per Gruppi di disponibilità Always On
| Cmdlet | Descrizione | Supportati in |
|---|---|---|
| Disable-SqlAlwaysOn | Disabilita la funzionalità Gruppi di disponibilità Always On in un'istanza del server. | L'istanza del server è specificata dal parametro Path, InputObjecto Name . Deve essere un'edizione di SQL Server che supporta Gruppi di disponibilità Always On. |
| Enable-SqlAlwaysOn | Abilita Gruppi di disponibilità Always On in un'istanza di SQL Server che supporta la funzionalità Gruppi di disponibilità Always On. Per informazioni sul supporto per Gruppi di disponibilità Always On, vedere Prerequisiti, restrizioni e consigli per i gruppi di disponibilità Always On (SQL Server). | Qualsiasi edizione di SQL Server che supporta Gruppi di disponibilità Always On. |
| New-SqlHadrEndPoint | Crea un nuovo endpoint del mirroring del database in un'istanza del server. Questo endpoint è richiesto per lo spostamento di dati tra il database primario e quelli secondari. | Qualsiasi istanza di SQL Server |
| Set-SqlHadrEndpoint | Modifica le proprietà di un endpoint del mirroring del database esistente, ad esempio il nome, lo stato o le proprietà di autenticazione. | Istanza del server che supporta Gruppi di disponibilità Always On e in cui non è presente un endpoint del mirroring del database |
Backup e ripristino dei log dei database e delle transazioni
| Cmdlet | Descrizione | Supportati in |
|---|---|---|
| Backup-SqlDatabase | Crea un backup dei dati o del log. | Qualsiasi database online (per Gruppi di disponibilità Always On, un database nell'istanza del server che ospita la replica primaria) |
| Restore-SqlDatabase | Ripristina un backup. | Qualsiasi istanza di SQL Server (per Gruppi di disponibilità Always On, un'istanza del server che ospita una replica secondaria) |
Importante
Quando si prepara un database secondario, è necessario usare il parametro -NoRecovery in ogni comando Restore-SqlDatabase.
Per informazioni sull'uso di questi cmdlet per preparare un database secondario, vedere Preparare manualmente un database secondario per un gruppo di disponibilità (SQL Server).
Creazione e gestione di un gruppo di disponibilità
| Cmdlet | Descrizione | Supportati in |
|---|---|---|
| New-SqlAvailabilityGroup | Crea un nuovo gruppo di disponibilità. | Istanza del server per ospitare la replica primaria |
| Remove-SqlAvailabilityGroup | Elimina un gruppo di disponibilità. | Istanza del server abilitata per HADR |
| Set-SqlAvailabilityGroup | Imposta le proprietà di un gruppo di disponibilità; porta un gruppo di disponibilità online/offline | Istanza del server che ospita la replica primaria |
| Switch-SqlAvailabilityGroup | Inizia una delle seguenti modalità di failover: Failover forzato di un gruppo di disponibilità (con possibile perdita di dati). Failover manuale di un gruppo di disponibilità. |
Istanza del server che ospita la replica secondaria di destinazione |
Creazione e gestione di un listener del gruppo di disponibilità
| Cmdlet | Descrizione | Supportati in |
|---|---|---|
| New-SqlAvailabilityGroupListener | Crea un nuovo listener del gruppo di disponibilità e lo collega a un gruppo di disponibilità esistente. | Istanza del server che ospita la replica primaria |
| Set-SqlAvailabilityGroupListener | Modifica l'impostazione della porta su un listener del gruppo di disponibilità esistente. | Istanza del server che ospita la replica primaria |
| Add-SqlAvailabilityGroupListenerStaticIp | Aggiunge un indirizzo IP statico a una configurazione del listener del gruppo di disponibilità esistente. L'indirizzo IP può essere un indirizzo IPv4 con subnet o un indirizzo IPv6. | Istanza del server che ospita la replica primaria |
Creazione e gestione di una replica di disponibilità
| Cmdlet | Descrizione | Supportati in |
|---|---|---|
| New-SqlAvailabilityReplica | Crea una nuova replica di disponibilità È possibile usare il parametro -AsTemplate per creare un oggetto della replica di disponibilità in memoria per ogni nuova replica di disponibilità. | Istanza del server che ospita la replica primaria |
| Join-SqlAvailabilityGroup | Viene creato un join della replica secondaria al gruppo di disponibilità. | Istanza del server che ospita la replica secondaria |
| Remove-SqlAvailabilityReplica | Elimina una replica di disponibilità. | Istanza del server che ospita la replica primaria |
| Set-SqlAvailabilityReplica | Imposta le proprietà di una replica di disponibilità. | Istanza del server che ospita la replica primaria |
Aggiunta e gestione di un database di disponibilità
| Cmdlet | Descrizione | Supportati in |
|---|---|---|
| Add-SqlAvailabilityDatabase | Nella replica primaria viene aggiunto un database a un gruppo di disponibilità. In una replica secondaria viene creato un join di un database secondario a un gruppo di disponibilità. |
Qualsiasi istanza del server che ospita una replica di disponibilità (il comportamento è diverso per le repliche primarie e per quelle secondarie) |
| Remove-SqlAvailabilityDatabase | Nella replica primaria il database viene rimosso dal gruppo di disponibilità. In una replica secondaria il database secondario locale viene rimosso dalla replica secondaria locale. |
Qualsiasi istanza del server che ospita una replica di disponibilità (il comportamento è diverso per le repliche primarie e per quelle secondarie) |
| Resume-SqlAvailabilityDatabase | Riprende lo spostamento dati per un database di disponibilità sospeso. | L'istanza del server in cui si trova il database è stata sospesa. |
| Suspend-SqlAvailabilityDatabase | Sospende lo spostamento dati per un database di disponibilità. | Qualsiasi istanza del server che ospita una replica di disponibilità. |
Monitoraggio dello stato di integrità di un gruppo di disponibilità
Con i cmdlet SQL Server seguenti è possibile monitorare lo stato di un gruppo di disponibilità, nonché delle repliche e dei database relativi.
Importante
È necessario disporre delle autorizzazioni CONNECT, VIEW SERVER STATE e VIEW ANY DEFINITION per eseguire questi cmdlet.
| Cmdlet | Descrizione | Supportati in |
|---|---|---|
| Test-SqlAvailabilityGroup | Valuta l'integrità di un gruppo di disponibilità valutando i criteri della gestione basata su criteri di SQL Server. | Qualsiasi istanza del server che ospita una replica di disponibilità*. |
| Test-SqlAvailabilityReplica | Valuta l'integrità delle repliche di disponibilità valutando i criteri della gestione basata su criteri di SQL Server. | Qualsiasi istanza del server che ospita una replica di disponibilità*. |
| Test-SqlDatabaseReplicaState | Valuta l'integrità di un database di disponibilità su tutte le repliche di disponibilità aggiunte valutando i criteri della gestione basata su criteri di SQL Server. | Qualsiasi istanza del server che ospita una replica di disponibilità*. |
* Per visualizzare informazioni su tutte le repliche di disponibilità in un gruppo di disponibilità, usare l'istanza del server che ospita la replica primaria.
Per altre informazioni, vedere Usare i criteri Always On per visualizzare l'integrità di un gruppo di disponibilità (SQL Server).
Vedi anche
Panoramica di Gruppi di disponibilità AlwaysOn (SQL Server)
Visualizzare la Guida di SQL Server PowerShell