Questo comando imposta il numero di porta dell'endpoint del mirroring del database denominato MainDbmEndpoint su 5050 nell'istanza del server denominata Computer\Instance.
Esempio 2: Avviare un endpoint del mirroring del database
PS C:\> Set-SqlHADREndpoint -Path "SQLSERVER:\Sql\Computer\Instance\Endpoints\MainDbmEndpoint" -State Started
Questo comando avvia l'endpoint del mirroring del database denominato MainDbmEndpoint nell'istanza Computer\Instancedel server .
Parametri
-AccessToken
Token di accesso usato per eseguire l'autenticazione a SQL Server, come 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.
Proprietà dei parametri
Tipo:
PSObject
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
-AuthenticationOrder
Specifica l'ordine e il tipo di autenticazione usati dall'endpoint.
Se l'opzione specificata chiama un certificato, il parametro Certificate deve essere impostato a meno che un certificato non sia già associato all'endpoint.
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 specificato.
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
-Encrypt
Tipo di crittografia da usare 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, l'impostazione predefinita è Optional (per compatibilità con v21). Nella versione 23+ del modulo, il valore predefinito sarà "Obbligatorio", che potrebbe creare una modifica di rilievo per gli script esistenti.
Questo parametro è nuovo nella versione 22 del modulo.
Proprietà dei parametri
Tipo:
String
Valore predefinito:
None
Valori accettati:
Mandatory, Optional, Strict
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
-Encryption
Specifica l'impostazione di crittografia dell'endpoint.
Proprietà dei parametri
Tipo:
EndpointEncryption
Valore predefinito:
None
Valori accettati:
Disabled, Supported, Required
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.
NOTA: l'algoritmo RC4 è supportato solo per la compatibilità con le versioni precedenti.
Il nuovo materiale può essere crittografato solo usando RC4 o RC4_128 quando il database è a livello 90 di compatibilità o 100, ma questo non è consigliato.
Per una maggiore sicurezza, usare invece un algoritmo più recente, ad esempio uno degli AES algoritmi.
Proprietà dei parametri
Tipo:
EndpointEncryptionAlgorithm
Valore predefinito:
None
Valori accettati:
None, RC4, Aes, AesRC4, RC4Aes
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
-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.
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
-InputObject
Specifica l'endpoint da modificare. Deve trattarsi di un endpoint del mirroring del database.
Proprietà dei parametri
Tipo:
Endpoint
Valore predefinito:
None
Supporta i caratteri jolly:
False
DontShow:
False
Set di parametri
ByObject
Posizione:
1
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 in cui l'endpoint sarà in ascolto.
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
-Owner
Specifica il proprietario dell'endpoint.
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'endpoint del mirroring del database. 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:
1
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-Port
Specifica il numero di porta TCP utilizzato dall'endpoint per l'ascolto delle connessioni.
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
-State
Specifica lo stato dell'endpoint.
Proprietà dei parametri
Tipo:
EndpointState
Valore predefinito:
None
Valori accettati:
Started, Stopped, Disabled
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
-TrustServerCertificate
Indica se il canale verrà crittografato durante il bypass della catena di certificati per convalidare l'attendibilità.
Nella versione 22 del modulo, l'impostazione predefinita è $true (per compatibilità con v21). Nella versione 23+ del modulo, il valore predefinito sarà "$false", che potrebbe creare una modifica di rilievo per gli script esistenti.
Questo parametro è nuovo nella versione 22 del modulo.
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.