Condividi tramite

Convert-UrnToPath

Modulo:
SqlServer Module

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

Sintassi

Default (impostazione predefinita). 

Convert-UrnToPath
    [-Urn] <String>
    [<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

-Urn

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
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.

Input

String

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

Output

String

Specifica una stringa che rappresenta un percorso del provider di SQL Server PowerShell.