Condividi tramite

New-SqlHADREndpoint

Modulo:
SQLPS Module

Crea un endpoint del mirroring del database in un'istanza di SQL Server.

Sintassi

ByPath (impostazione predefinita). 

New-SqlHADREndpoint
    [-Name] <String>
    [[-Path] <String>]
    [-Port <Int32>]
    [-Owner <String>]
    [-Certificate <String>]
    [-IpAddress <IPAddress>]
    [-AuthenticationOrder <EndpointAuthenticationOrder>]
    [-Encryption <EndpointEncryption>]
    [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObject 

New-SqlHADREndpoint
    [-Name] <String>
    [-InputObject] <Server>
    [-Port <Int32>]
    [-Owner <String>]
    [-Certificate <String>]
    [-IpAddress <IPAddress>]
    [-AuthenticationOrder <EndpointAuthenticationOrder>]
    [-Encryption <EndpointEncryption>]
    [-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
    [-Script]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet New-SqlHADREndpoint crea un endpoint del mirroring del database in un'istanza di SQL Server. Questo endpoint è necessario in ogni istanza del server che ospita una replica di disponibilità per qualsiasi gruppo di disponibilità. Ogni istanza del server può avere un solo endpoint del mirroring del database. Se un'istanza del server dispone di un endpoint del mirroring del database, usare l'endpoint esistente.

Esempio

Esempio 1: Creare un endpoint del mirroring del database

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint"

Questo comando crea un endpoint del mirroring del database denominato MainEndpoint nell'istanza del server che si trova nel percorso specificato. Questo endpoint usa la porta predefinita 5022.

Esempio 2: Creare un endpoint del mirroring del database che richiede la crittografia

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -Port 4022 -EncryptionAlgorithm Aes' -Encryption Required

Questo comando crea un endpoint del mirroring del database denominato MainEndpoint nell'istanza del server che si trova nel percorso specificato. Questo endpoint è in ascolto sulla porta 4022. L'endpoint usa l'algoritmo AES per la crittografia e richiede che le connessioni usino la crittografia.

Esempio 3: Creare un endpoint del mirroring del database crittografato con un certificato

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -AuthenticationOrder
Certificate -Certificate "EncryptionCertificate"

Questo comando crea un endpoint del mirroring del database denominato MainEndpoint nell'istanza del server che si trova nel percorso specificato. Questo endpoint usa il certificato denominato EncryptionCertificate per autenticare le connessioni.

Esempio 4: Creare uno script dell'endpoint del mirroring del database

PS C:\> New-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance" -Name "MainEndpoint" -Script

Questo comando restituisce lo script Transact-SQL che crea un endpoint del mirroring del database denominato MainEndpoint nell'istanza del server che si trova nel percorso specificato. L'endpoint non viene effettivamente creato da questo comando.

Parametri

-AuthenticationOrder

Specifica l'ordine e il tipo di autenticazione usati dall'endpoint. I valori validi sono:

  • Certificato
  • CertificateKerberos
  • CertificateNegotiate
  • CertificateNtlm
  • Kerberos
  • KerberosCertificate
  • Negoziare
  • NegotiateCertificate
  • Ntlm
  • NtlmCertificate.

Se l'opzione specificata chiama un certificato, è necessario impostare il parametro Certificate .

Proprietà dei parametri

Tipo:EndpointAuthenticationOrder
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

-Certificate

Specifica il nome del certificato che verrà usato dall'endpoint per autenticare le connessioni. L'endpoint lontano deve avere un certificato con la chiave pubblica corrispondente alla chiave privata del certificato.

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

-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

-Encryption

Specifica l'opzione di crittografia per l'endpoint. I valori validi sono:

  • Disabilitato
  • Sostenuto
  • Obbligatorio

Obbligatorio è il valore predefinito.

Proprietà dei parametri

Tipo:EndpointEncryption
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

-EncryptionAlgorithm

Specifica la forma di crittografia utilizzata dall'endpoint. I valori validi sono:

  • Aes
  • AesRC4
  • Nessuno
  • RC4
  • RC4Aes

Per impostazione predefinita, l'endpoint userà la crittografia Aes.

L'algoritmo RC4 è supportato solo per motivi di compatibilità con le versioni precedenti. Il nuovo materiale può essere crittografato solo usando RC4 o RC4_128 quando il database è nel livello di compatibilità 90 o 100, ma questo non è consigliato. Per una maggiore sicurezza, usare invece un algoritmo più recente, ad esempio uno degli algoritmi AES.

Proprietà dei parametri

Tipo:EndpointEncryptionAlgorithm
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 l'oggetto server dell'istanza di SQL Server in cui viene creato l'endpoint.

Proprietà dei parametri

Tipo:Server
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

-IpAddress

Specifica l'indirizzo IP dell'endpoint. Il valore predefinito è ALL, che indica che il listener accetta una connessione su qualsiasi indirizzo IP valido.

Proprietà dei parametri

Tipo:IPAddress
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

-Name

Specifica il nome dell'endpoint. Questo parametro è obbligatorio.

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

-Owner

Specifica l'account di accesso del proprietario dell'endpoint. Per impostazione predefinita, si tratta dell'account di accesso corrente.

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

-Path

Specifica il percorso dell'istanza di SQL Server dell'endpoint. Questo parametro è facoltativo. Se non specificato, viene utilizzata 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 TCP in cui l'endpoint sarà in ascolto delle connessioni. Il valore predefinito è 5022.

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 uno script Transact-SQL che esegue l'attività.

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

-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.

Input

SMO.Server

Output

SMO.Endpoint