Add-SqlFirewallRule
SQL Server의 특정 인스턴스에 대한 연결을 허용하는 Windows 방화벽 규칙을 추가합니다.
구문
ByPath (기본값)
Add-SqlFirewallRule
[-Credential] <PSCredential>
[-Path <String[]>]
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Add-SqlFirewallRule
[-Credential] <PSCredential>
-InputObject <Server[]>
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByName
Add-SqlFirewallRule
[-Credential] <PSCredential>
-ServerInstance <String[]>
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Add-SqlFirewallRule cmdlet은 지정된 SQL Server 인스턴스에 대한 연결을 허용하는 Windows 방화벽 규칙을 추가합니다. SQL Server 클라우드 어댑터는 SQL Server 인스턴스를 호스트하는 컴퓨터에서 실행되고 액세스할 수 있어야 합니다.
이 cmdlet은 다음과 같은 작업 모드를 지원합니다.
- 인스턴스 Windows PowerShell 경로를 지정합니다.
- 서버 개체를 지정합니다.
- SQL Server 대상 인스턴스의 서버 인스턴스를 지정합니다.
Note: This cmdlet ceased to work a long time ago. It's been removed in version 22 of the module.
예제
예제 1: 로컬 컴퓨터에 Windows 방화벽 규칙 추가
PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Add-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate
첫 번째 명령은 디렉터리를 SQL Server 컴퓨터 인스턴스로 변경합니다.
예제 2: 파이프를 통해 로컬 컴퓨터에 Windows 방화벽 규칙 추가
PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer001" | Add-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate
이 명령은 $Credentials 변수에 저장된 자격 증명을 기반으로 SQL Server 인스턴스를 가져옵니다. 그런 다음 이 명령은 'Computer001'이라는 컴퓨터에서 SQL Server의 SQL Server 인스턴스를 파이프합니다. 그런 다음 이 명령은 각 인스턴스에 대한 연결을 허용하는 Windows 방화벽 규칙을 추가합니다. 대상 컴퓨터의 자체 서명된 인증서는 사용자에게 메시지를 표시하지 않고 자동으로 허용됩니다.
매개 변수
-AutomaticallyAcceptUntrustedCertificates
이 cmdlet이 신뢰할 수 없는 인증서를 자동으로 수락한다는 것을 나타냅니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다. cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Credential
SQL Server 연결에 대한 PSCredential 개체를 지정합니다. 자격 증명 개체를 가져오려면 Get-Credential cmdlet을 사용합니다. 자세한 내용은 get-credential Get-Help 입력합니다.
매개 변수 속성
| 형식: | PSCredential |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-InputObject
SQL Server 대상 인스턴스의 서버 개체를 지정합니다.
매개 변수 속성
| 형식: | Server[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
ByObject
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ManagementPublicPort
대상 컴퓨터의 공용 관리 포트를 지정합니다. 이 매개 변수는 대상 컴퓨터의 포트에 직접 액세스할 수 없지만 엔드포인트를 통해 노출될 때 사용됩니다. 즉, 다른 포트에 연결해야 합니다.
이 포트에서 SQL Server 클라우드 어댑터에 액세스할 수 있어야 합니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Path
이 cmdlet이 작업을 실행하는 SQL Server 인스턴스의 경로를 지정합니다. 이 매개 변수를 지정하지 않으면 이 매개 변수의 값은 기본적으로 현재 작업 위치로 설정됩니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
ByPath
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RetryTimeout
대상 서버에서 명령을 다시 시도하는 기간을 지정합니다. 제한 시간이 만료되면 다시 시도되지 않습니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ServerInstance
SQL Server 인스턴스의 이름을 배열로 지정하여 작업의 대상이 됩니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
ByName
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다. cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
Microsoft.SqlServer.Management.Smo.Server
System.String[]