Convert-UrnToPath

Riferimento

Modulo:: SQLServer

Converte un URN dell'oggetto di gestione di SQL Server in un percorso del provider Windows PowerShell.

Sintassi

Convert-UrnToPath
       [-Urn] <String>
       [-ProgressAction <ActionPreference>]
       [<CommonParameters>]

Descrizione

Il cmdlet Convert-UrnToPath converte un URN (SQL Server Management Object Resource Name) in un percorso del provider SQL Server.

SQL Server Management Objects dispone di una proprietà Urn che restituisce una stringa che indica la posizione nella gerarchia di oggetti di SQL Server.

Se i nodi nell'URn sono identificatori delimitati di SQL Server con caratteri estesi non supportati nei nodi del percorso di Windows PowerShell, i caratteri estesi vengono codificati con la relativa rappresentazione esadecimale.

Ad esempio, il nome di tabella "Main:Table" viene codificato come "Main%3ATable".

Esempio

Esempio 1: Ottenere una stringa contenente il percorso corrente

PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014"
PS SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014> Convert-UrnToPath -Urn (Get-Item .).Urn.ToString()

SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014

Questo comando restituisce una stringa contenente il percorso corrente. Nell'esempio viene utilizzata la funzione ToString() della proprietà Urn per restituire l'Urn come stringa.

Esempio 2: Impostare il percorso in base a un URN

PS C:\> Set-Location (Convert-UrnToPath -Urn "Server[@Name='MyComputer']/Database[@Name='AdventureWorks']/Table[@Name='Address' and @Schema = 'Person']")

Questo comando imposta il percorso del percorso specificato in un URN dell'oggetto di gestione di SQL Server.

Esempio 3: Ottenere percorsi di database

PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\DEFAULT\Databases"
PS SQLSERVER:\SQL\MyComputer\DEFAULT\Databases> foreach ($Item in Get-ChildItem) { $Item.Urn.ToString() | Convert-UrnToPath }

SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2014

Questo comando restituisce una matrice di stringhe che contengono il percorso di un database nell'istanza predefinita. L'operatore pipeline viene usato per passare l'URN del nodo corrente a Convert-UrnToPath.

Parametri

-ProgressAction

Determina in che modo PowerShell risponde agli aggiornamenti dello stato generati da uno script, un cmdlet o un provider, ad esempio le barre di stato generate dal cmdlet Write-Progress. Il cmdlet Write-Progress crea barre di stato che mostrano lo stato di un comando.

Tipo:	ActionPreference
Alias:	proga
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Urn

Specifica un URN di SQL Server che identifica la posizione di un oggetto nella gerarchia di SQL Server.

Tipo:	String
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

Input

String

Specifica una stringa che rappresenta un URN dell'oggetto di gestione di SQL Server.

Output