New-SqlAvailabilityGroupListener
Crea un listener del gruppo di disponibilità e lo collega a un gruppo di disponibilità.
Sintassi
New-SqlAvailabilityGroupListener
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Name] <String>
[[-Path] <String>]
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-SqlAvailabilityGroupListener
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Name] <String>
[-InputObject] <AvailabilityGroup>
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet New-SqlAvailabilityGroupListener crea un listener del gruppo di disponibilità e lo collega a un gruppo di disponibilità. Eseguire questo cmdlet nell'istanza del server che ospita la replica primaria.
Esempio
Esempio 1: Creare un listener per un gruppo di disponibilità
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"
Questo comando crea un listener del gruppo di disponibilità denominato 'MainListener' per il gruppo di disponibilità denominato 'MainAG'. Questo listener acquisisce un indirizzo IP virtuale usando DHCP. Eseguire questo comando nell'istanza del server che ospita la replica primaria.
Esempio 2: Creare un listener per un gruppo di disponibilità con una porta non predefinita
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Port 1434
Questo comando crea un listener del gruppo di disponibilità denominato 'MainListener' per il gruppo di disponibilità denominato 'MainAG'. Come nell'esempio precedente, questo listener acquisisce un indirizzo IP virtuale usando DHCP. In questo esempio viene assegnata la porta 1434 in cui è in ascolto.
Esempio 3: Creare un listener per un gruppo di disponibilità che usa DHCP
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -DhcpSubnet "192.169.0.1/255.255.252.0" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"
Questo comando crea un listener del gruppo di disponibilità denominato 'MainListener' per il gruppo di disponibilità denominato 'MainAG'. Questo listener acquisisce un indirizzo IP virtuale nella subnet specificata usando DHCP.
Esempio 4: Creare un listener per un gruppo di disponibilità che usa un indirizzo statico
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -StaticIp "192.168.3.1/255.255.252.0" -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG"
Questo comando crea un listener del gruppo di disponibilità denominato 'MainListener' per il gruppo di disponibilità denominato 'MainAG'. Questo listener usa l'indirizzo IPv4 specificato dal parametro StaticIp come indirizzo IP virtuale.
Esempio 5: Creare uno script che crea un listener
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG" -Script
Questo comando crea uno script Transact-SQL che crea un listener del gruppo di disponibilità denominato 'MainListener' per il gruppo di disponibilità denominato 'MainAG'. Il comando non crea un listener.
Parametri
-AccessToken
Token di accesso usato per eseguire l'autenticazione per SQL Server, in alternativa all'autenticazione utente/password o Windows.
Può essere usato, ad esempio, per connettersi a SQL Azure DB
e SQL Azure Managed Instance
usando un Service Principal
oggetto o .Managed Identity
Il parametro da usare può essere una stringa che rappresenta il token o un PSAccessToken
oggetto restituito eseguendo Get-AzAccessToken -ResourceUrl https://database.windows.net
.
Questo parametro è nuovo nella versione 22 del modulo.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma dell'utente prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DhcpSubnet
Specifica un indirizzo IPv4 e una subnet mask di una rete. Il listener determina l'indirizzo in questa rete tramite DHCP. Specificare l'indirizzo in per il formato seguente: 192.168.0.1/255.255.255.0.
Se si specifica questo parametro, non specificare il parametro StaticIp .
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encrypt
Tipo di crittografia da utilizzare per la connessione a SQL Server.
Questo valore esegue il Encrypt
mapping alla proprietà SqlConnectionEncryptOption
nell'oggetto SqlConnection del driver Microsoft.Data.SqlClient.
Nella versione 22 del modulo il valore predefinito è Optional
(per compatibilità con la versione 21). Nella versione 23+ del modulo il valore predefinito sarà "Obbligatorio", che può creare una modifica di rilievo per gli script esistenti.
Questo parametro è nuovo nella versione 22 del modulo.
Type: | String |
Accepted values: | Mandatory, Optional, Strict |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostNameInCertificate
Nome host da usare per la convalida del certificato TLS/SSL di SQL Server. È necessario passare questo parametro se l'istanza di SQL Server è abilitata per Forza crittografia e si vuole connettersi a un'istanza usando nome host/nome breve. Se questo parametro viene omesso, è necessario passare il nome di dominio completo (FQDN) a -ServerInstance per connettersi a un'istanza di SQL Server abilitata per Forza crittografia.
Questo parametro è nuovo nella versione 22 del modulo.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifica il gruppo di disponibilità, come oggetto AvailabilityGroup , a cui questo cmdlet collega il listener.
Type: | AvailabilityGroup |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Specifica un nome per il listener.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Specifica il percorso del gruppo di disponibilità a cui questo cmdlet collega un listener. Se non si specifica questo parametro, questo cmdlet usa la posizione di lavoro corrente.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Specifica la porta in cui il listener è in ascolto delle connessioni. La porta predefinita è la porta TCP 1433.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Script
Indica che questo cmdlet restituisce uno script Transact-SQL che esegue l'attività eseguita da questo cmdlet.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StaticIp
Specifica una matrice di indirizzi. Ogni voce di indirizzo è un indirizzo IPv4 e una subnet mask o un indirizzo IPv6. Il listener è in ascolto sugli indirizzi specificati da questo parametro.
Se si specifica questo parametro, non specificare il parametro DhcpSubnet .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustServerCertificate
Indica se il canale verrà crittografato durante il bypass della catena di certificati per convalidare l'attendibilità.
Nella versione 22 del modulo il valore predefinito è $true
(per compatibilità con la versione 21). Nella versione 23+ del modulo il valore predefinito sarà "$false", che può creare una modifica di rilievo per gli script esistenti.
Questo parametro è nuovo nella versione 22 del modulo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.SqlServer.Management.Smo.AvailabilityGroup