Convert-UrnToPath

Riferimento

Modulo:: SQLServer

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

Sintassi

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

Descrizione

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

Gli oggetti SMO (SQL Server Management Object) contengono una proprietà Urn che restituisce una stringa che indica il percorso nella gerarchia di oggetti SQL Server.

Se i nodi nell'Urn sono SQL Server identificatori delimitati con caratteri estesi non supportati nei nodi del percorso 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 SQL Server.

Esempio 3: Ottenere i 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

-Urn

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

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

Input

String

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

Output