Test-SqlSmartAdmin

Riferimento

Modulo:: SQLServer

Verifica l'integrità delle Amministrazione intelligenti valutando i criteri di gestione basata su criteri (PBM) SQL Server.

Sintassi

Test-SqlSmartAdmin
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Test-SqlSmartAdmin
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <SmartAdmin[]>
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Test-SqlSmartAdmin verifica l'integrità di Smart Amministrazione per l'istanza di SQL Server valutando i criteri di gestione basata su criteri (PBM) SQL Server.

Questo cmdlet supporta le seguenti modalità di esecuzione per restituire l'oggetto.

Passare il percorso dell'istanza di SQL Server al parametro Path.
Passare un oggetto Smo.Server al parametro InputObject , direttamente o tramite la pipeline.

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

Esempio

Esempio 1: Testare lo stato del SQL Server Smart Amministrazione

PS C:\> cd SQLSERVER:\SQL\Computer\MyInstance 
PS SQLSERVER:\SQL\Computer\MyInstance> Get-SqlSmartAdmin | Test-SqlSmartAdmin

Il primo comando modifica la directory nell'istanza Computer\MyInstancedi SQL .

Esempio 2: Valutare i risultati dei test del SQL Server Smart Amministrazione

PS C:\> cd SQLSERVER:\SQL\Computer\MyInstance
PS SQLSERVER:\SQL\Computer\MyInstance> $PolicyResults = Get-SqlSmartAdmin | Test-SqlSmartAdmin 
PS SQLSERVER:\SQL\Computer\MyInstance> $PolicyResults.PolicyEvaluationDetails | select Name, Category, Result, Expression

Il primo comando modifica la directory nell'istanza di SQL Computer\MyInstance.

Esempio 3: Restituire lo stato del Amministrazione smart SQL Server

PS C:\> PS SQLSERVER:\SQL\COMPUTER\DEFAULT> (Get-SqlSmartAdmin).EnumHealthStatus()

number_of_storage_connectivity_errors: 0 
number_of_sql_errors: 2 
number_of_invalid_credential_errors: 0 
number_of_other_errors : 0 
number_of_corrupted_or_deleted_backups: 0 
number_of_backup_loops: 2 
number_of_retention_loops: 2

Questo comando restituisce lo stato del SQL Server Amministrazione smart locale.

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

-AllowUserPolicies

Indica che questo cmdlet esegue i criteri utente trovati nelle categorie di criteri di avviso e di errore smart Amministrazione.

Type:	SwitchParameter
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

-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 una matrice di oggetti SmartAdmin. Per ottenere questo oggetto, usare il cmdlet Get-SqlSmartAdmin.

Type:	SmartAdmin[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoRefresh

Indica che questo cmdlet non aggiornerà manualmente l'oggetto specificato dai parametri Path o InputObject .

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Specifica il percorso dell'istanza di SQL Server, come matrice di stringhe. Se non si specifica un valore per questo parametro, il cmdlet usa il percorso di lavoro corrente.

Type:	String[]
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ShowPolicyDetails

Indica che questo cmdlet mostra il risultato del criterio. Il cmdlet genera uno oggetto per ogni valutazione dei criteri. L'output include i risultati della valutazione, ad esempio il nome del criterio, della categoria e dell'integrità.

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.SmartAdmin[]

Output

Questo cmdlet restituisce i risultati dalla valutazione dei criteri.

Test-SqlSmartAdmin

Sintassi

Descrizione

Esempio

Esempio 1: Testare lo stato del SQL Server Smart Amministrazione

Esempio 2: Valutare i risultati dei test del SQL Server Smart Amministrazione

Esempio 3: Restituire lo stato del Amministrazione smart SQL Server

Parametri

-AccessToken

-AllowUserPolicies

-Confirm

-Encrypt

-HostNameInCertificate

-InputObject

-NoRefresh

-Path

-ShowPolicyDetails

-TrustServerCertificate

-WhatIf

Input

Output

Collegamenti correlati

Risorse aggiuntive