New-SqlAvailabilityGroupListener
Crea un listener del gruppo di disponibilità e lo collega a un gruppo di disponibilità.
Sintassi
ByPath (impostazione predefinita).
New-SqlAvailabilityGroupListener
[-Name] <String>
[[-Path] <String>]
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
New-SqlAvailabilityGroupListener
[-Name] <String>
[-InputObject] <AvailabilityGroup>
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Script]
[-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 tramite 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 tramite DHCP. In questo esempio viene assegnata la porta 1434 su 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
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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 .
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-InputObject
Specifica il gruppo di disponibilità, come oggetto AvailabilityGroup , a cui questo cmdlet collega il listener.
Proprietà dei parametri
| Tipo: | AvailabilityGroup |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ByObject
| Posizione: | 3 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica un nome per il listener.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 2 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ByPath
| Posizione: | 3 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Port
Specifica la porta su cui il listener è in ascolto delle connessioni. La porta predefinita è la porta TCP 1433.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Script
Indica che questo cmdlet restituisce un Transact-SQL script che esegue l'attività eseguita da questo cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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 .
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.