Add-SqlFirewallRule

Module:

SQLServer

Ajoute une règle de Pare-feu Windows pour autoriser les connexions à une instance spécifique de SQL Server.

Syntaxe

Add-SqlFirewallRule
   [-Path <String[]>]
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-SqlFirewallRule
   -InputObject <Server[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-SqlFirewallRule
   -ServerInstance <String[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Add-SqlFirewallRule ajoute une règle de pare-feu Windows pour autoriser les connexions pour l’instance spécifiée de SQL Server. La carte cloud SQL Server doit être en cours d’exécution et accessible sur l’ordinateur qui héberge l’instance de SQL Server.

Cette applet de commande prend en charge les modes de fonctionnement suivants :

• Spécifiez le chemin d’accès Windows PowerShell de l’instance.
• Spécifiez l’objet serveur.
• Spécifiez l’instance de serveur de l’instance cible de SQL Server.

Note: This cmdlet ceased to work a long time ago. It's been removed in version 22 of the module.

Exemples

Exemple 1 : Ajouter une règle de pare-feu Windows sur l’ordinateur local

PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Add-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate

La première commande change le répertoire de l’instance d’ordinateur SQL Server.

Exemple 2 : Ajouter une règle de pare-feu Windows sur l’ordinateur local via un canal

PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer001" | Add-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate

Cette commande obtient l’instance SQL Server en fonction des informations d’identification stockées dans la variable nommée $Credentials. La commande canalise ensuite les instances SQL Server de SQL Server sur l’ordinateur nommé « Computer001 ». La commande ajoute ensuite des règles de pare-feu Windows pour autoriser les connexions pour chacune des instances. Le certificat auto-signé de l’ordinateur cible est automatiquement accepté sans inviter l’utilisateur.

Paramètres

-AutomaticallyAcceptUntrustedCertificates

Indique que cette applet de commande accepte automatiquement les certificats non approuvés.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande. Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Credential

Spécifie un objet PSCredential pour la connexion à SQL Server. Pour obtenir un objet d’informations d’identification, utilisez l’applet de commande Get-Credential. Pour plus d'informations, tapez Get-Help Get-Credential.

Type:	PSCredential
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Spécifie l’objet serveur de l’instance cible de SQL Server.

Type:	Server[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ManagementPublicPort

Spécifie le port de gestion publique sur l’ordinateur cible. Ce paramètre est utilisé lorsque les ports de l’ordinateur cible ne sont pas directement accessibles, mais sont exposés via des points de terminaison, ce qui signifie qu’ils doivent être connectés à un autre port.

La carte cloud SQL Server doit être accessible par ce port.

Type:	Int32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Path

Spécifie le chemin d’accès à l’instance de SQL Server sur laquelle cette applet de commande exécute l’opération. Si ce paramètre n’est pas spécifié, la valeur de ce paramètre est définie par défaut sur l’emplacement de travail actuel.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RetryTimeout

Spécifie la période pour réessayer la commande sur le serveur cible. Une fois le délai d’expiration expiré, aucune nouvelle tentative n’est tentée.

Type:	Int32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ServerInstance

Spécifie le nom d’une instance de SQL Server, sous forme de tableau, qui devient la cible de l’opération.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée. Montre ce qui se passe si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

Sorties

System.Object

Liens associés

• Remove-SqlFirewallRule