Add-SqlFirewallRule

Référence

Module:: SQLServer

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

Syntax

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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	Server[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

Sorties

System.Object

Remove-SqlFirewallRule