New-SqlHADREndpoint
Crea un endpoint del mirroring del database in un'istanza di SQL Server.
Sintassi
New-SqlHADREndpoint
[-Port <Int32>]
[-Owner <String>]
[-Certificate <String>]
[-IpAddress <IPAddress>]
[-AuthenticationOrder <EndpointAuthenticationOrder>]
[-Encryption <EndpointEncryption>]
[-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
[-Name] <String>
[[-Path] <String>]
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-SqlHADREndpoint
[-Port <Int32>]
[-Owner <String>]
[-Certificate <String>]
[-IpAddress <IPAddress>]
[-AuthenticationOrder <EndpointAuthenticationOrder>]
[-Encryption <EndpointEncryption>]
[-EncryptionAlgorithm <EndpointEncryptionAlgorithm>]
[-Name] <String>
[-InputObject] <Server>
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet New-SqlHADREndpoint crea un endpoint del mirroring del database in un'istanza di SQL Server. Questo endpoint viene richiesto in ogni istanza del server che ospita una replica di disponibilità per qualsiasi gruppo di disponibilità. In ogni istanza del server può essere disponibile un solo endpoint del mirroring del database. Se un'istanza del server possiede un endpoint di mirroring del database, usare l'endpoint esistente.
Esempio
Esempio 1: Creare un endpoint di 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 per la AES
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 creato effettivamente tramite questo comando.
Parametri
-AccessToken
Token di accesso usato per eseguire l'autenticazione per SQL Server, in alternativa all'autenticazione utente/password o Windows.
Può essere usato, ad esempio, per connettersi a SQL Azure DB
e SQL Azure Managed Instance
usando un Service Principal
oggetto o .Managed Identity
Il parametro da usare può essere una stringa che rappresenta il token o un PSAccessToken
oggetto restituito eseguendo Get-AzAccessToken -ResourceUrl https://database.windows.net
.
Questo parametro è nuovo nella versione 22 del modulo.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AuthenticationOrder
Specifica l'ordine e il tipo di autenticazione utilizzati dall'endpoint.
Se l'opzione specificata chiama un certificato, è necessario impostare il parametro Certificate.
Type: | EndpointAuthenticationOrder |
Accepted values: | Ntlm, Kerberos, Negotiate, Certificate, NtlmCertificate, KerberosCertificate, NegotiateCertificate, CertificateNtlm, CertificateKerberos, CertificateNegotiate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma dell'utente prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encrypt
Tipo di crittografia da utilizzare per la connessione a SQL Server.
Questo valore esegue il Encrypt
mapping alla proprietà SqlConnectionEncryptOption
nell'oggetto SqlConnection del driver Microsoft.Data.SqlClient.
Nella versione 22 del modulo il valore predefinito è Optional
(per compatibilità con la versione 21). Nella versione 23+ del modulo il valore predefinito sarà "Obbligatorio", che può creare una modifica di rilievo per gli script esistenti.
Questo parametro è nuovo nella versione 22 del modulo.
Type: | String |
Accepted values: | Mandatory, Optional, Strict |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encryption
Specifica l'opzione di crittografia per l'endpoint.
Il valore predefinito è Required
.
Type: | EndpointEncryption |
Accepted values: | Disabled, Supported, Required |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EncryptionAlgorithm
Specifica la forma di crittografia utilizzata dall'endpoint.
Per impostazione predefinita, verrà utilizzata la crittografia Aes dall'endpoint.
NOTA: l'algoritmo RC4 è supportato solo per la compatibilità con le versioni precedenti.
Il nuovo materiale può essere crittografato solo con 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 AES
algoritmi.
Type: | EndpointEncryptionAlgorithm |
Accepted values: | None, RC4, Aes, AesRC4, RC4Aes |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostNameInCertificate
Nome host da usare per la convalida del certificato TLS/SSL di SQL Server. È necessario passare questo parametro se l'istanza di SQL Server è abilitata per Forza crittografia e si vuole connettersi a un'istanza usando nome host/nome breve. Se questo parametro viene omesso, è necessario passare il nome di dominio completo (FQDN) a -ServerInstance per connettersi a un'istanza di SQL Server abilitata per Forza crittografia.
Questo parametro è nuovo nella versione 22 del modulo.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifica l'oggetto server dell'istanza di SQL Server in cui viene creato l'endpoint.
Type: | Server |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | IPAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specifica il nome dell'endpoint.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Owner
Specifica l'account di accesso del proprietario dell'endpoint. Per impostazione predefinita, si tratta dell'account di accesso corrente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Specifica il percorso dell'istanza di SQL Server dell'endpoint. Se non specificato, viene utilizzata la posizione di lavoro corrente.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Specifica la porta TCP in cui l'endpoint sarà in ascolto delle connessioni.
Il valore predefinito è 5022
.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Script
Indica che questo cmdlet restituisce uno script Transact-SQL che esegue l'attività.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TrustServerCertificate
Indica se il canale verrà crittografato durante il bypass della catena di certificati per convalidare l'attendibilità.
Nella versione 22 del modulo il valore predefinito è $true
(per compatibilità con la versione 21). Nella versione 23+ del modulo il valore predefinito sarà "$false", che può creare una modifica di rilievo per gli script esistenti.
Questo parametro è nuovo nella versione 22 del modulo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.SqlServer.Management.Smo.Server
Output
SMO.Endpoint