Il cmdlet Update-IDQCatalog aggiorna un Catalog alla versione corrente di IrionEDM.

Per poter eseguire questo cmdlet, l'utente necessita del privilegio Import Audit Shelf.

Sintassi

<# Updates a registered Catalog and its DataBases #>

Update-IDQCatalog [-Catalog] <string> [[-ExecutionCredential] <pscredential>] [[-Script] <string>] [[-FromVersion]

<string>] [[-StorageAreaFile] <string>] [[-ReleaseAllSessions]] [[-DatabaseActionBehaviour] {AllActions |

AdminOnlyActions | DbOwnerOnlyActions}] [-WhatIf] [-Confirm] [<CommonParameters>]

<# Updates a Catalog and its DataBases via Server and Instance #>

Update-IDQCatalog [-Server] <string> [[-Instance] <string>] [[-ExecutionCredential] <pscredential>] [[-Script]

<string>] [[-FromVersion] <string>] [[-StorageAreaFile] <string>] [[-ReleaseAllSessions]]

[[-DatabaseActionBehaviour] {AllActions | AdminOnlyActions | DbOwnerOnlyActions}] [-WhatIf] [-Confirm]

[<CommonParameters>]

Argomenti

Parametro	Descrizione	Richiesto
-Server <string>	Server su cui risiede il Catalog.	Y
-Instance <string>	Nome dell’istanza del Catalog.	N
-Catalog <string>	Nome del Catalog.	Y
-ExecutionCredential <pscredential>	Username e password di esecuzione.	N
-Script <string>	File che contiene lo script di update del Catalog. Se specificato, il Catalog non è aggiornato ma è salvato solo lo script di aggiornamento.	N
-FromVersion <string>	Versione IrionEDM a partire dalla quale lo script esegue l’aggiornamento. Efficace solo in presenza del parametro -Script. Non necessita di connessione al Database. Presuppone la presenza obbligatoria del parametro -StorageAreaFile	N
-StorageAreaFile <string>	File contenente l’elenco dei Database di un Catalog IrionEDM che si intende aggiornare, avente la struttura di StorageAreaFile. Efficace solo in presenza del parametro -Script.	N
-ReleaseAllSessions	Forza il rilascio di tutte le sessioni attive.	N
-DatabaseActionBehaviour {AllActions \| AdminOnlyActions \| DbOwnerOnlyActions}	Specifica il comportamento del comando.	N
-Confirm	Visualizza un messaggio di conferma all’atto dell’esecuzione del comando	N
-WhatIf	Simula il commandlet restituendo a video gli step di esecuzione senza effettuarli	N

Catalog

Nome del Catalog a cui la Storage Area deve essere aggiunta. Il catalog deve essere registrato.

In alternativa può essere utilizzato il formalismo -Server <> -instance <>

Server

Nome del DB Server su cui risiede il catalogo.

Instance

Nome dell’istanza di catalogo.

Name

Nome del catalogo.

DatabaseActionBehavior

Determina il comportamento del comando e ammette i valori seguenti:

✓ AllActions, consente tutte le azioni;

✓ AdminOnlyActions, consente le sole azioni che necessitano di permessi amministrativi sul file system;

✓ DbOwnerOnlyActions, consente le sole azioni che necessitano di permessi di db owner.

Script

File che contiene lo script di aggiornamento del Catalog. Se specificato, il Catalog non è creato ma è salvato solo lo script di aggiornamento.

Il parametro -Script consente di salvare su file i comandi anziché eseguirli immediatamente. Solo nel caso in cui si intenda generare questi comandi senza accesso al Catalog ovvero senza connessione ad un database, occorre specificare i entrambi i parametri -FromVersion e -StorageAreaFile.

ESEMPI:

A. Aggiornamento di un Catalog MyCatalog sul server MyServer e istanza MyInstance

Update-IDQCatalog -Server MyServer -Instance MyInstance

B. Aggiornamento di un Catalog MyCatalog registrato sul server MyServer e istanza MyInstance

Update-IDQCatalog -Catalog MyCatalog

C. Creazione di uno script MyScriptFullName per l'aggiornamento di un Catalog MyCatalog registrato sul server MyServer e istanza MyInstance

Update-IDQCatalog -Catalog MyCatalog -Script MyScriptFullName