Panoramica dei cmdlet di PowerShell per Gruppi di disponibilità Always On (SQL Server)Overview of PowerShell Cmdlets for Always On Availability Groups (SQL Server)

QUESTO ARGOMENTO SI APPLICA A:sìSQL Server (a partire dalla versione 2016)noDatabase SQL di AzurenoAzure SQL Data WarehousenoParallel Data WarehouseTHIS TOPIC APPLIES TO: yesSQL Server (starting with 2016)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

MicrosoftMicrosoft PowerShell è una shell della riga di comando basata su attività e un linguaggio di scripting progettato appositamente per l'amministrazione del sistema. PowerShell is a task-based command-line shell and scripting language designed especially for system administration. Gruppi di disponibilità Always OnAlways On availability groups fornisce un set di cmdlet di PowerShell in SQL Server 2017SQL Server 2017 per distribuire, gestire e monitorare gruppi di disponibilità, repliche di disponibilità e database di disponibilità. provides a set of PowerShell cmdlets in SQL Server 2017SQL Server 2017 that enable you to deploy, manage, and monitor availability groups, availability replicas, and availability databases.

Nota

Con l'inizio corretto di un'azione è possibile che venga completato un cmdlet di PowerShell.A PowerShell cmdlet can complete by successfully initiating an action. Ciò non implica che l'azione desiderata, ad esempio il failover di un gruppo di disponibilità, sia stata completata.This does not indicate that the intended work, such as the fail over of an availability group, has completed. Quando si genera lo script di una sequenza di azioni, può essere necessario controllare lo stato delle azioni e attenderne il completamento.When scripting a sequence of actions, you might have to check the status of actions, and wait for them to complete.

In questo argomento vengono presentati i cmdlet per i seguenti set di attività:This topic introduces the cmdlets for the following sets of tasks:

Nota

Per un elenco degli argomenti nella documentazione online di SQL Server 2017SQL Server 2017 che illustrano come usare i cmdlet per eseguire attività Gruppi di disponibilità Always OnAlways On availability groups , vedere la sezione "Attività correlate" di Panoramica di Gruppi di disponibilità Always On (SQL Server).For a list of topics in SQL Server 2017SQL Server 2017 Books Online that describe how to use cmdlets to perform Gruppi di disponibilità Always OnAlways On availability groups tasks, see the "Related Tasks" section of Overview of Always On Availability Groups (SQL Server).

Configuring a Server Instance for Always On Availability Groups Configuring a Server Instance for Always On Availability Groups

CmdletCmdlets DescrizioneDescription Supportati inSupported on
Disable-SqlAlwaysOnDisable-SqlAlwaysOn Disabilita la funzionalità Gruppi di disponibilità Always OnAlways On availability groups su un'istanza del server.Disables the Gruppi di disponibilità Always OnAlways On availability groups feature on a server instance. L'istanza del server è specificata dal parametro Path, InputObjecto Name .The server instance that is specified by the Path, InputObject, or Name parameter. (L'edizione di SQL ServerSQL Server deve supportare Gruppi di disponibilità Always OnAlways On availability groups).(Must be an edition of SQL ServerSQL Server that supports Gruppi di disponibilità Always OnAlways On availability groups.)
Enable-SqlAlwaysOnEnable-SqlAlwaysOn Abilita Gruppi di disponibilità Always OnAlways On availability groups su un'istanza di SQL Server 2017SQL Server 2017 che supporta la funzionalità Gruppi di disponibilità Always OnAlways On availability groups .Enables Gruppi di disponibilità Always OnAlways On availability groups on an instance of SQL Server 2017SQL Server 2017 that supports the Gruppi di disponibilità Always OnAlways On availability groups feature. Per informazioni sul supporto per Gruppi di disponibilità Always OnAlways On availability groups, vedere Prerequisiti, restrizioni e consigli per i gruppi di disponibilità Always On (SQL Server).For information about support for Gruppi di disponibilità Always OnAlways On availability groups, see Prerequisites, Restrictions, and Recommendations for Always On Availability Groups (SQL Server). Qualsiasi edizione di SQL ServerSQL Server che supporta Gruppi di disponibilità Always OnAlways On availability groups.Any edition of SQL ServerSQL Server that supports Gruppi di disponibilità Always OnAlways On availability groups.
New-SqlHadrEndPointNew-SqlHadrEndPoint Crea un nuovo endpoint del mirroring del database in un'istanza del server.Creates a new database mirroring endpoint on a server instance. Questo endpoint è richiesto per lo spostamento di dati tra il database primario e quelli secondari.This endpoint is required for data movement between primary and secondary databases. Qualsiasi istanza di SQL ServerSQL ServerAny instance of SQL ServerSQL Server
Set-SqlHadrEndpointSet-SqlHadrEndpoint Modifica le proprietà di un endpoint del mirroring del database esistente, ad esempio il nome, lo stato o le proprietà di autenticazione.Changes the properties of an existing database mirroring endpoint, such as the name, state, or authentication properties. Istanza del server che supporta Gruppi di disponibilità Always OnAlways On availability groups e in cui non è presente un endpoint del mirroring del databaseA server instance that supports Gruppi di disponibilità Always OnAlways On availability groups and lacks a database mirroring endpoint

Backing Up and Restoring Databases and Transaction Logs Backing Up and Restoring Databases and Transaction Logs

CmdletCmdlets DescrizioneDescription Supportati inSupported on
Backup-SqlDatabaseBackup-SqlDatabase Crea un backup dei dati o del log.Creates a data or log backup. Qualsiasi database online (per Gruppi di disponibilità Always OnAlways On availability groups, un database nell'istanza del server che ospita la replica primaria)Any online database (for Gruppi di disponibilità Always OnAlways On availability groups, a database on the server instance that hosts the primary replica)
Restore-SqlDatabaseRestore-SqlDatabase Ripristina un backup.Restores a backup. Qualsiasi istanza di SQL ServerSQL Server (per Gruppi di disponibilità Always OnAlways On availability groups, un'istanza del server che ospita una replica secondaria)Any instance of SQL ServerSQL Server (for Gruppi di disponibilità Always OnAlways On availability groups, a server instance that hosts a secondary replica)

** Importante *\* Quando si prepara un database secondario, è necessario usare il parametro -NoRecovery in ogni comando Restore-SqlDatabase .** Important *\* When preparing a secondary database, you must use the -NoRecovery parameter in every Restore-SqlDatabase command.

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).For information about using these cmdlets to prepare a secondary database, see Manually Prepare a Secondary Database for an Availability Group (SQL Server).

Creating and Managing an Availability Group Creating and Managing an Availability Group

CmdletCmdlets DescrizioneDescription Supportati inSupported on
New-SqlAvailabilityGroupNew-SqlAvailabilityGroup Crea un nuovo gruppo di disponibilità.Creates a new availability group. Istanza del server per ospitare la replica primariaServer instance to host primary replica
Remove-SqlAvailabilityGroupRemove-SqlAvailabilityGroup Elimina un gruppo di disponibilità.Deletes availability group. Istanza del server abilitata per HADRHADR-enabled server instance
Set-SqlAvailabilityGroupSet-SqlAvailabilityGroup Imposta le proprietà di un gruppo di disponibilità; porta un gruppo di disponibilità online/offlineSets the properties of an availability group; take an availability group online/offline Istanza del server che ospita la replica primariaServer instance that hosts primary replica
Switch-SqlAvailabilityGroupSwitch-SqlAvailabilityGroup Inizia una delle seguenti modalità di failover:Initiates one of the following forms of failover:

Failover forzato di un gruppo di disponibilità (con possibile perdita di dati).A forced failover of an availability group (with possible data loss).

Failover manuale di un gruppo di disponibilità.A manual failover of an availability group.
Istanza del server che ospita la replica secondaria di destinazioneServer instance that hosts target secondary replica

Creating and Managing an Availability Group Listener Creating and Managing an Availability Group Listener

CmdletCmdlet DescrizioneDescription Supportati inSupported on
New-SqlAvailabilityGroupListenerNew-SqlAvailabilityGroupListener Crea un nuovo listener del gruppo di disponibilità e lo collega a un gruppo di disponibilità esistente.Creates a new availability group listener and attaches it to an existing availability group. Istanza del server che ospita la replica primariaServer instance that hosts primary replica
Set-SqlAvailabilityGroupListenerSet-SqlAvailabilityGroupListener Modifica l'impostazione della porta su un listener del gruppo di disponibilità esistente.Modifies the port setting on an existing availability group listener. Istanza del server che ospita la replica primariaServer instance that hosts primary replica
Add-SqlAvailabilityGroupListenerStaticIpAdd-SqlAvailabilityGroupListenerStaticIp Aggiunge un indirizzo IP statico a una configurazione del listener del gruppo di disponibilità esistente.Adds a static IP address to an existing availability group listener configuration. L'indirizzo IP può essere un indirizzo IPv4 con subnet o un indirizzo IPv6.The IP address can be an IPv4 address with subnet, or an IPv6 address. Istanza del server che ospita la replica primariaServer instance that hosts primary replica

Creating and Managing an Availability Replica Creating and Managing an Availability Replica

CmdletCmdlets DescrizioneDescription Supportati inSupported on
New-SqlAvailabilityReplicaNew-SqlAvailabilityReplica Crea una nuova replica di disponibilitàCreates a new availability replica. È possibile usare il parametro -AsTemplate per creare un oggetto della replica di disponibilità in memoria per ogni nuova replica di disponibilità.You can Use the -AsTemplate parameter to create an in-memory availability-replica object for each new availability replica. Istanza del server che ospita la replica primariaServer instance that hosts primary replica
Join-SqlAvailabilityGroupJoin-SqlAvailabilityGroup Viene creato un join della replica secondaria al gruppo di disponibilità.Joins a secondary replica to the availability group. Istanza del server che ospita la replica secondariaServer instance that hosts secondary replica
Remove-SqlAvailabilityReplicaRemove-SqlAvailabilityReplica Elimina una replica di disponibilità.Deletes an availability replica. Istanza del server che ospita la replica primariaServer instance that hosts primary replica
Set-SqlAvailabilityReplicaSet-SqlAvailabilityReplica Imposta le proprietà di una replica di disponibilità.Sets the properties of an availability replica. Istanza del server che ospita la replica primariaServer instance that hosts primary replica

Adding and Managing an Availability Database Adding and Managing an Availability Database

CmdletCmdlets DescrizioneDescription Supportati inSupported on
Add-SqlAvailabilityDatabaseAdd-SqlAvailabilityDatabase Nella replica primaria viene aggiunto un database a un gruppo di disponibilità.On the primary replica, adds a database to an availability group.

In una replica secondaria viene creato un join di un database secondario a un gruppo di disponibilità.On a secondary replica, joins a secondary database to an availability group.
Qualsiasi istanza del server che ospita una replica di disponibilità (il comportamento è diverso per le repliche primarie e per quelle secondarie)Any server instance that hosts an availability replica (behavior differs for primary and secondary replicas)
Remove-SqlAvailabilityDatabaseRemove-SqlAvailabilityDatabase Nella replica primaria il database viene rimosso dal gruppo di disponibilità.On the primary replica, removes the database from the availability group.

In una replica secondaria il database secondario locale viene rimosso dalla replica secondaria locale.On a secondary replica, removes the local secondary database from the local secondary replica.
Qualsiasi istanza del server che ospita una replica di disponibilità (il comportamento è diverso per le repliche primarie e per quelle secondarie)Any server instance that hosts an availability replica (behavior differs for primary and secondary replicas)
Resume-SqlAvailabilityDatabaseResume-SqlAvailabilityDatabase Riprende lo spostamento dati per un database di disponibilità sospeso.Resumes the data movement for a suspended availability database. L'istanza del server in cui si trova il database è stata sospesa.The server instance on which the database was suspended.
Suspend-SqlAvailabilityDatabaseSuspend-SqlAvailabilityDatabase Sospende lo spostamento dati per un database di disponibilità.Suspends the data movement for an availability database. Qualsiasi istanza del server che ospita una replica di disponibilità.Any server instance that hosts an availability replica.

Monitoring Availability Group Health Monitoring Availability Group Health

Con i cmdlet SQL ServerSQL Server seguenti è possibile monitorare lo stato di un gruppo di disponibilità, nonché delle repliche e dei database relativi.The following SQL ServerSQL Server cmdlets enable you to monitor the health of an availability group and its replicas and databases.

Importante

È necessario disporre delle autorizzazioni CONNECT, VIEW SERVER STATE e VIEW ANY DEFINITION per eseguire questi cmdlet.You must have CONNECT, VIEW SERVER STATE, and VIEW ANY DEFINITION permissions to execute these cmdlets.

CmdletCmdlet DescrizioneDescription Supportati inSupported on
Test-SqlAvailabilityGroupTest-SqlAvailabilityGroup Valuta l'integrità di un gruppo di disponibilità valutando i criteri della gestione basata su criteri di SQL Server.Assesses the health of an availability group by evaluating SQL Server policy based management (PBM) policies. Qualsiasi istanza del server che ospita una replica di disponibilità.Any server instance that hosts an availability replica.
Test-SqlAvailabilityReplicaTest-SqlAvailabilityReplica Valuta l'integrità delle repliche di disponibilità valutando i criteri della gestione basata su criteri di SQL Server.Assesses the health of availability replicas by evaluating SQL Server policy based management (PBM) policies. Qualsiasi istanza del server che ospita una replica di disponibilità.Any server instance that hosts an availability replica.
Test-SqlDatabaseReplicaStateTest-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.Assesses the health of an availability database on all joined availability replicas by evaluating SQL Server policy based management (PBM) policies. Qualsiasi istanza del server che ospita una replica di disponibilità.Any server instance that hosts an availability replica.

* Per visualizzare informazioni su tutte le repliche di disponibilità in un gruppo di disponibilità, usare l'istanza del server che ospita la replica primaria.*To view information about all of the availability replicas in an availability group, use to the server instance that hosts the primary replica.

Per altre informazioni, vedere Usare i criteri Always On per visualizzare l'integrità di un gruppo di disponibilità (SQL Server).For more information, see Use Always On Policies to View the Health of an Availability Group (SQL Server).

Vedere ancheSee Also

Panoramica di Gruppi di disponibilità Always On (SQL Server) Overview of Always On Availability Groups (SQL Server)
Visualizzare la Guida di SQL Server PowerShellGet Help SQL Server PowerShell