Add-SqlAvailabilityGroupListenerStaticIp
Ajoute une adresse IP statique à un écouteur de groupe de disponibilité.
Syntaxe
ByPath (Par défaut)
Add-SqlAvailabilityGroupListenerStaticIp
[[-Path] <String[]>]
-StaticIp <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Add-SqlAvailabilityGroupListenerStaticIp
[-InputObject] <AvailabilityGroupListener[]>
-StaticIp <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Add-SqlAvailabilityGroupListenerStaticIp ajoute une adresse IP statique à une configuration d’écouteur de groupe de disponibilité existante. Vous pouvez spécifier une adresse IPv4 et un masque de sous-réseau ou une adresse IPv6 Exécuter cette applet de commande sur l’instance de serveur qui héberge le réplica principal.
Exemples
Exemple 1 : Ajouter une adresse IPv4
PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener" -StaticIp "192.169.0.1/255.255.252.0"
Cette commande ajoute une adresse IPv4 statique à l’écouteur du groupe de disponibilité MainListener sur le groupe de disponibilité nommé MainAG. Cette adresse IPv4 sert d’adresse IP virtuelle de l’écouteur sur le sous-réseau 255.255.252.0. Si le groupe de disponibilité s’étend sur plusieurs sous-réseaux, ajoutez une adresse IP statique pour chaque sous-réseau à l’écouteur. Exécutez cette applet de commande sur l’instance de serveur qui héberge le réplica principal.
Exemple 2 : Ajouter une adresse IPv6
PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener" -StaticIp "2001:0db8:85a3:0000:0000:8a2e:0370:7334"
Cette commande ajoute une adresse IPv6 statique à l’écouteur MainListener sur le groupe de disponibilité MainAG.
Exemple 3 : Créer un script qui ajoute une adresse IPv4
PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAg\AvailabilityGroupListeners\MainListener" -StaticIp "192.168.0.1/255.255.255.0" -Script
Cela crée un script Transact-SQL qui ajoute une adresse IPv4 statique à l’écouteur du groupe de disponibilité MainListener sur le groupe de disponibilité nommé « MainAG ».
Paramètres
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-InputObject
Spécifie l’écouteur, en tant qu’objet AvailabilityGroupListener , que cette applet de commande modifie.
Propriétés du paramètre
| Type: | AvailabilityGroupListener[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ByObject
| Position: | 2 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Path
Spécifie le chemin d’accès de l’écouteur de groupe de disponibilité que cette applet de commande modifie. Si vous ne spécifiez pas ce paramètre, cette applet de commande utilise l’emplacement de travail actuel.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ByPath
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Script
Indique que cette applet de commande retourne un script Transact-SQL qui effectue la tâche effectuée par cette applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-StaticIp
Spécifie un tableau d’adresses. Chaque entrée d’adresse est une adresse IPv4 et un masque de sous-réseau ou une adresse IPv6. L’écouteur écoute les adresses spécifiées par ce paramètre.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.