Informazioni generali sui 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

Un cmdlet di PowerShell può completarsi con l'avvio corretto di un'azione. Ciò non indica che l'operazione prevista, come 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 server per gli Always On Availability Groups

Cmdlet	Descrizione	Supportato su
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 per il mirroring del database su 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

Cmdlets	Descrizione	Supportato su
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 su
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à in linea/fuori linea	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

Gestione e creazione di un listener per gruppi di disponibilità

Cmdlet	Descrizione	Supportato su
New-SqlAvailabilityGroupListener	Crea un listener nuovo per il 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 di 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	Supportato su
New-SqlAvailabilityReplica	Crea una nuova replica di disponibilità È possibile usare il parametro -AsTemplate per creare un oggetto replica di disponibilità in memoria per ogni nuova replica di disponibilità.	Istanza del server che ospita la replica primaria
Join-SqlAvailabilityGroup	Unisce una 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à

Cmdlets	Descrizione	Supportato su
Add-SqlAvailabilityDatabase	Nella replica primaria viene aggiunto un database a un gruppo di disponibilità. Nella replica secondaria, un database secondario si connette 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)
Riprendi-SqlAvailabilityDatabase	Riprende lo spostamento dei dati per il 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à.	Ogni istanza di 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	Supportato su
Test-SqlAvailabilityGroup	Valuta l'integrità di un gruppo di disponibilità attraverso la valutazione delle politiche della gestione basata su criteri (PBM) di SQL Server.	Ogni istanza del server che ospita una replica di disponibilità.*
Test-SqlAvailabilityReplica	Valuta lo stato di salute delle repliche di disponibilità esaminando le policy di gestione basata su criteri (PBM) 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 utilizzando i criteri di gestione basata su policy 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 monitorare la salute di un gruppo di disponibilità (SQL Server).

Vedi anche

Panoramica di Gruppi di disponibilità AlwaysOn (SQL Server)
Visualizzare la Guida di SQL Server PowerShell