Cosa sono i cmdlet di PowerShell e come padroneggiarli?

Quando qualcuno menziona PowerShell, la prima cosa che viene in mente è il suo cmdlet: piccoli ma potenti pezzi che risolvono i compiti con eleganza. Se vieni da cmd.exe o altre shell, noterai subito che non stiamo lavorando solo con testo normale; PowerShell riguarda tutto oggetti, quindi l'esperienza cambia (e in meglio).

In questa guida vi racconto, con un approccio eminentemente pratico, Che cos'è un cmdlet?, come vengono denominati, come vengono combinati e, soprattutto, come sfruttarli in scenari reali. Approfondiremo anche un modulo aziendale chiave: Microsoft.HostIntegration.PowerShell (servizio DRDA su Host Integration Server), con la sua raccolta completa di comandi, parametri, sintassi ed esempi che puoi incollare così come sono nella tua console.

Che cos'è un cmdlet e perché è importante?

Un cmdlet è un comando per PowerShell monofunzionale, leggero e progettato per funzionare con oggetti anziché con stringhe. A differenza di un eseguibile tradizionale, un cmdlet è richiama all'interno del runtime PowerShell si integra con la pipeline e può essere richiamato da script, dalla riga di comando o anche da API di Windows PowerShell.

I cmdlet sono confezionati in moduli che vengono caricati su richiesta. Possono essere scritti in linguaggi .NET compilati o direttamente in PowerShellCiò consente di distribuire le funzionalità senza dover trascinare e rilasciare file binari sparsi e di attivare esattamente ciò di cui si ha bisogno in ogni sessione.

Nomi verbo-sostantivo e coerenza della piattaforma

I cmdlet seguono lo schema Verbo-Sostantivo (separati da un trattino). Il verbo esprime l'azione, mentre il sostantivo esprime la risorsa su cui si agisce. Esempio: Get-Command elenca ciò che viene registrato nella shell. Questa convenzione semplifica scoperta e mantiene la coerenza tra produttori e apparecchiature.

PowerShell mantiene un elenco di verbi approvati (Ottieni, Imposta, Nuovo, Rimuovi, Aggiungi, Avvia, Arresta, ecc.). Il loro utilizzo aiuta i cmdlet essere 'scopribile' con completamento automatico e comandi come Get-Command y Get-Help.

Parametri: obbligatori, posizionali e switch

Un cmdlet dichiara il suo parametri come proprietà pubbliche. Ce ne sono di obbligatorie o facoltative, con un nome o posizionalee tipo di switch (switch interpretati come vero se specificato). Inoltre, ereditano tutti un gruppo di parametri comune (come -Verbose, -ErrorAction, ecc.), accessibili ogni volta che si richiama un cmdlet.

Se si omette un parametro obbligatorio, PowerShell ne richiederà il valore in modo interattivo. Se si omette un parametro facoltativo, verrà applicato il suo valore. valore di default; è un comportamento comodo e molto tipico sulla piattaforma.

Scopri cosa è installato e ottieni assistenza

Per vedere quali moduli hai importato, usa Get-Module -AllSe si desidera elencare assolutamente tutti i cmdlet disponibili (predefiniti o quelli forniti con moduli aggiuntivi), estrarre Get-Command, Qual è il catalogo della casa.

Quando hai bisogno di sintassi dettagliata, esempi e note, chiama Get-Help con il nome del cmdlet o visita consultare l'aiuto e i manualiE se vuoi leggere di più su parametri comuni In generale, puoi consultare get-help about_CommonParameters per chiarire subito i dubbi.

Cmdlet essenziali per tutti i giorni

Questi ti fanno risparmiare un sacco di tempo nella gestione dei team o nell'automazione dei flussi di lavoro. Ecco alcuni punti salienti che vale la pena tenere a portata di mano, con i loro utilità principale e un'idea di utilizzo:

• Get-Process: Elenca i processi attivi; aggiunge il nome su cui concentrarsi. Ideal per una diagnosi rapida.
• Stop-Process: arresta i processi in base al nome o all'ID; con -Confirm chiedi conferma e con -PassThru vedi il risultato.
• Get-Service: Visualizza i servizi e il loro stato; combinali con i filtri se ne stai cercando uno specifico. o un tipo preciso.
• Where-Object: filtra gli oggetti che passano attraverso la pipeline; utile per tenere traccia di il pertinente in grandi collezioni.
• Get-History, Clear-History, Add-History: gestire il cronologia dei comandi, dal guardare le ultime novità a pulire le voci.
• ConvertTo-Html, ConvertTo-Xml: esportare i risultati in HTML o XML per la creazione di report e accusa dopo.
• Out-File: scarica l'output in un file; perfetto per i registri o revisione.
• Copy-Item, Move-Item, Get-ChildItem: trio base per copiare, spostare e lista elementi.
• Set-Location, Set-Alias, Select-Object: cambia posizione, crea collegamenti e seleziona proprietà chiave.
• Restart-Computer, Restart-Service, Clear-RecycleBin: azioni di amministrazione diretta ogni giorno.
• Get-ComputerInfo, Test-Path, Test-Connection, comando Get-WinEvent: informazioni di sistema, percorsi, connettività ed eventi del sistema.
• Debug-Process, Enable-PSBreakpoint, Disable-PSBreakpoint, Get-Counter, Start-Sleep: debug e monitoraggio con controllo fine.

Moduli ed esecuzione privilegiata

PowerShell e il suo ISE (Integrated Environment) potrebbero richiedere privilegi elevati per determinate attività. È possibile aprirli come amministratore dall'interfaccia o con questi comandi da PowerShell:

Start-Process PowerShell -Verb RunAs
Start-Process PowerShell_ISE -Verb RunAs

Quando si lavora con moduli specifici, importare l'assembly dal suo percorso. Ad esempio, per il modulo di servizio DRDA in Host Integration Server 2013, è sufficiente importalo come questa:

Import-Module "C:\Program Files\Microsoft Host Integration Server 2013\system\Microsoft.HostIntegration.PowerShell"

Controllalo è caricato e cosa esporta:

Get-Module Microsoft.HostIntegration.PowerShell
Get-Command -Module Microsoft.HostIntegration.PowerShell

Modulo DRDA: Panoramica e requisiti

Il servizio DRDA gestisce le connessioni e le trasformazioni tra i client DRDA e SQL Server, convalidandone la configurazione con un XSD inclusi e monitorando i cambiamenti in MsDrdaService.exe.config. Il modulo Microsoft.HostIntegration.PowerShell raggruppa i cmdlet in raccolte di configurazione e operazioni per configurare il servizio, tracce, trasformazioni SQL, codifiche e altro ancora.

Raccomandazioni de Boot: apri PowerShell/IE come amministratore, importare il modulo dal tuo percorso se non sei registrato, controlla Get-Module ed elenca i comandi con Get-Command -Module Microsoft.HostIntegration.PowerShell.

Elenco completo dei cmdlet del servizio DRDA

Questi sono i cmdlet esposti dal modulo, così come registrati nel sistema. Spaziano dalle codifiche e conversioni a servizio, alias, tracce e collegamento dei pacchetti:

• Aggiungi-la-sua-pagina-di-codice-personalizzata
• Aggiungi-la-sua-conversione-personalizzata
• Aggiungi-HisDrdaApplicationEncoding
• Aggiungi-HisDrdaCollationName
• Aggiungi-HisDrdaDatabaseAlias
• Add-HisDrdaDatetimeFormat
• Aggiungi-HisDrdaPackageBindListener
• Ottieni la sua pagina di codice personalizzata
• Ottieni la sua conversione personalizzata
• Get-HisDrdaApplicationEncoding
• Get-HisDrdaCollationName
• Ottieni-HisDrdaDatabaseAlias
• Ottieni-HisDrdaDatetimeFormat
• Get-HisDrdaPackageBindListener
• Get-HisDrdaPackageBindProcessing
• Get-HisDrdaPackageProcedureCache
• Ottieni-HisDrdaService
• Ottieni-HisDrdaSqlServerConnection
• Ottieni-HisDrdaSqlTransform
• Get-HisDrdaTraceListener
• Rimuovi-la-sua-pagina-di-codice-personalizzata
• Rimuovi-la-sua-conversione-personalizzata
• Rimuovi-HisDrdaApplicationEncoding
• Rimuovi-HisDrdaCollationName
• Rimuovi-HisDrdaDatabaseAlias
• Rimuovi-HisDrdaDatetimeFormat
• Rimuovi-HisDrdaPackageBindListener
• Set-HisDrdaConsoleTraceListener
• Set-HisDrdaEtwTraceListener
• Set-HisDrdaEventLogTraceListener
• Set-HisDrdaPackageBindProcessing
• Set-HisDrdaPackageProcedureCache
• Set-HisDrdaService
• Set-HisDrdaSqlServerConnection
• Set-HisDrdaSqlTransform
• Set-HisDrdaTextTraceListener
• Start-HisDrdaTraceListener
• Stop-HisDrdaTraceListener

Connettività DRDA e collegamento pacchetti: configurazione di base

Set-HisDrdaService Configurare il servizio per servire i client DRDA: porta, SSL/TLS, elenco dei client consentiti e server associati. Parametri chiave:

• -AllowClientIpAddresses <string>: Limita i client (IPv4/IPv6 o alias; separati da ";"). Predefinito: stringa vuota (accetta tutti).
• -EnablePerformanceCounters: Abilita i contatori. Booleano; predefinito falso.
• -IsPrimary: Ruolo primario nel gruppo di server. Booleano; predefinito veroPuò restituire l'elenco dei server (SRVLST).
• -PartnerServers <string>: elenco dei secondari IP:puerto (separati da “;”). Obbligatorio se -IsPrimary:$false. Predefinito vuoto.
• -PingInterval <uint32>: Monitora i server associati (EXCSAT/EXCSATRD). Predefinito: 10000 ms.
• -Port <uint32>: Porta di ascolto per i client DRDA. Predefinita 446.
• -UseSsl y -SslCertificatePath <string>: SSL 3.0/TLS 1.0; se SSL è abilitato, specifica il CN del certificato.

Esempio con valori standard:

Set-HisDrdaService -IsPrimary -PingInterval 10000 -Port 446

Per verificare la configurazione corrente, Ottieni-HisDrdaService restituisce proprietà come AllowClientIpAddresses, IsPrimary, PartnerServers, EnablePerformanceCounters, PingInterval, Port, SslCertificatePath y UseSsl.

Get-HisDrdaService

Connessione a SQL Server e Runtime

Con Set-HisDrdaSqlServerConnection È possibile configurare la connessione a SQL Server (stringa di connessione, timeout, regole di confronto predefinite, mapping di autenticazione, ecc.). Tra i parametri più importanti figurano:

• -ConnectionString <string>: Provider ADO.NET per SQL Server. Predefinito: Data Source=; Integrated Security=True; MultipleActiveResultSets=True.
• -AuthenticationLookupRetryCount <uint32> y -AuthenticationLookupTimeoutDuration <string> (ad esempio, formato di durata XML) PT30S).
• -ClientApplicationName <string>: externalName (utilizza i byte 1-8 di EXTNAM) o transactionIdentifier (byte 5-8 EXTNAM in CICS).
• -DefaultCollationName <string>: predefinito SQL_Latin1_General_CP1_CI_AS.
• -EnableArithAbort: emette SET ARITHABORT durante la connessione (falso predefinito).
• -HostInitiatedAffiliateApplication y -WindowsInitiatedAffiliateApplication: integrazione con SSO da Microsoft Enterprise (basato sull'autenticazione).
• -MappedAuthenticationDomain <string>: Dominio AD a cui mappare le credenziali del client DRDA.
• -RollbackTransactionOnError: esegue ROLLBACK dopo l'errore del database (vero predefinito).
• -SecurityTokenTimeoutDuration <string>: durata del token (ad esempio, PT8H).
• -StoredProcedureCallTimeout <uint32>: secondi da attendere CALL (0 = nessun limite; predefinito 30).

Esempio di configurazione valori tipici:

Set-HisDrdaSqlServerConnection -AuthenticationLookupRetryCount 3 -AuthenticationLookupTimeoutDuration PT30S -ClientApplicationName empty -ConnectionString "Data Source=localhost; Integrated Security=True; MultipleActiveResultSets=True" -DefaultCollationName SQL_Latin1_General_CP1_CI_AS -RollbackTransactionOnError -SecurityTokenTimeoutDuration PT8H -StoredProcedureCallTimeout 30

Interrogare la configurazione con Ottieni-HisDrdaSqlServerConnection da vedere ArithAbort, AuthenticationLookupTimeout, AuthenticationLookupRetryCount, ClientApplicationName, ConnectionString, DefaultCollationName, HostInitiatedAffiliateApplication, MappedAuthenticationDomain, RollbackTransactionOnError, SecurityTokenTimeoutSeconds, StoredProcedureCallTimeoutSeconds y WindowsInitiatedAffiliateApplication.

Pacchetti di binding e procedure archiviate

Set-HisDrdaPackageBindProcessing Controlla come trasformare l'SQL statico DRDA in procedure SQL Server, se generare XML del pacchetto, se preservare le proprietà estese, ecc. Parametri chiave:

• -CreatePackageProcedure: trasforma un flusso BGNBND nella procedura (vero predefinito).
• -CreatePackageProcedureWithCustomSqlScripts: processi BGNBND/BNDSQLSTT tramite ascoltatore esterno (falso predefinito).
• -CreatePackageProcedureWithExtendedProperties: conserva opzioni come le proprietà estese (falso predefinito).
• -CreatePackageXml, -PackageXmlFormat <v85|v90> (predefinito v90) Y -PackageXmlLocation (predefinito c:\temp).
• -StoredProcedureNameSeparator: separatore tra il nome del pacchetto e SP (predefinito) _).
• -PackageProcedureSchemaList: schemi alternativi (elenco separato da virgole).

Ejemplo tipico:

Set-HisDrdaPackageBindProcessing -CreatePackageProcedure -PackageXmlFormat v90 -PackageXmlLocation c:\temp -StoredProcedureNameSeparator _

Query di stato con Get-HisDrdaPackageBindProcessing per vedere se vengono create procedure, se viene generato XML, formato, posizione, separatore, proprietà estese, script personalizzati e elenco degli schemi.

Cache dei metadati della procedura

Con Set-HisDrdaPackageProcedureCache È possibile impostare la frequenza con cui la cache dei metadati della procedura (tipo di istruzione, cursori, parametri) viene svuotata. Utilizzare durate XML, ad esempio, P1D per un giorno.

Set-HisDrdaPackageProcedureCache -FlushTimeSpan P1D
Get-HisDrdaPackageProcedureCache

È utile quando si apportano frequenti modifiche di procedure, evitando di utilizzare metadati obsoleti.

Trasformazioni SQL (interne o CLR)

Set-HisDrdaSqlTransform alterna tra trasformazioni interne al servizio o basate su CLR e se l'output deve essere codificato come Unicode o ANSI:

• -Type <Service|Clr>: predefinito Servizio.
• -EnableUnicodeOutput: falso per impostazione predefinita (genera ANSI CHAR/VARCHAR).

Set-HisDrdaSqlTransform -Type Service
Get-HisDrdaSqlTransform

Alias ​​del database (DB2 ⇄ SQL Server)

Con Aggiungi-HisDrdaDatabaseAlias Esegue il mapping di RDBNAM e COLID (DB2) al database e allo schema di output in SQL Server. Parametri:

• -SourceLocation <string>: Origine RDBNAM (vuoto = qualsiasi valore).
• -SourceCollection <string>: COLID sorgente (vuoto = qualsiasi).
• -TargetDatabase <string> y -TargetSchema <string>: destinazione in SQL Server (vuoto = qualsiasi).

Ejemplo:

Add-HisDrdaDatabaseAlias -SourceCollection DSN8HC91 -SourceLocation CONTOSO -TargetDatabase ContosoRetailDW -TargetSchema DSN8910

consultare Ottieni-HisDrdaDatabaseAlias per rivedere le mappature attive e Rimuovi-HisDrdaDatabaseAlias per rimuoverli se non sono più validi.

Date e orari: formati e conversioni

Add-HisDrdaDatetimeFormat Dichiara le conversioni tra i formati DB2 e SQL Server per DATE, TIME e DATETIME (inclusi CHAR/VARCHAR che rappresentano le date). Parametri:

• -Conversion <Db2ToSql|SqlToDb2>: direzione della conversione.
• -DateFormat, -TimeFormat, -DateTimeFormat: tipo di formato (enumerazioni supportate dal servizio).

Esempi Veloce:

Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateFormat Usa
Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -TimeFormat HmsPeriod
Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTimeFormat IsoTimestampFormat

Per vedere cosa è definito usa Ottieni-HisDrdaDatetimeFormat con -DateTime <Date|Time|DateTime>E se hai bisogno di rimuovere una regola specifica, Rimuovi-HisDrdaDatetimeFormat consente di eliminare la combinazione desiderata (indirizzo e formato).

Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime Date -Format Usa
Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime Time -Format HmsPeriod
Remove-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTime DateTime -Format IsoTimestampFormat

Codifiche personalizzate e pagine di codice

Il servizio può caricare pagine di codici NLS personalizzate tramite il codificatore HIS. Con Aggiungi-la-sua-pagina-di-codice-personalizzata Indicare il numero, il nome e la base NLS standard che sostituisce:

• -CodePage <uint32>, -Name <string>, -NlsCodePage <uint32> e facoltativo -Description.

Add-HisCustomCodePage -CodePage 21140 -Name Custom21140 -NlsCodePage 1140 -Description "Custom codepage based on 1140"

Consultare ed eliminare con Ottieni la sua pagina di codice personalizzata (filtra per nome o numero) e Rimuovi-la-sua-pagina-di-codice-personalizzata (per nome). È un modo elegante di adattare codifiche per scenari legacy.

Conversione del punto di codice (EBCDIC ⇄ Unicode)

Per sovrascrivere assegnazioni specifiche nelle pagine di codice standard o personalizzate, utilizzare Aggiungi-la-sua-conversione-personalizzataPuoi andare da -CodePage oppure -Namee definire coppie con -EbcdicToUnicode o -UnicodeToEbcdic in forma To=From (esadecimale).

Verificare con Ottieni la sua conversione personalizzata indicando il -Type (EbcdicToUnicode o UnicodeToEbcdic) e la pagina o il nome, e rimuove con Rimuovi-la-sua-conversione-personalizzata quando non è più necessario, mantenere il sistema pulire.

Codifiche delle applicazioni tramite database

Se una base specifica deve utilizzare un CCSID specifico (o uno schema Unicode/EBCDIC/Ansi) per i parametri di output e i set di risultati, Aggiungi-HisDrdaApplicationEncoding risolve il problema:

• -Ccsid <uint32> o -CustomCcsid <uint32> y -Database <string> (più -Scheme <string>, predefinito Unicode).

Add-HisDrdaApplicationEncoding -Ccsid 1140 -Database NWIND1 -Scheme Ebcdic
Add-HisDrdaApplicationEncoding -CustomCcsid 1234 -Database NWIND1 -Scheme Ebcdic

Per controllare o pulire, utilizzare Get-HisDrdaApplicationEncoding (filtri per Ccsid, CustomCcsid o Database) e Rimuovi-HisDrdaApplicationEncoding come ti serve ritirarsi definizioni.

Assegnazione della collazione (ORDER BY COLLATE)

Quando si trasformano le query con ORDER BY, è possibile mappare i nomi delle regole di confronto DB2 ai nomi delle regole di confronto SQL Server con Aggiungi-HisDrdaCollationName:

• -From <string>: Nome della collazione DB2 (COLLATION_KEY).
• -To <string>: Nome_collazione di SQL Server.

Add-HisDrdaCollationName -From UCA400R1_LEN_AN -To SQL_EBCDIC037_CP1_CS_AS

consultare Get-HisDrdaCollationName (filtra per -From o -To) e rimuovere con Rimuovi-HisDrdaCollationName (opzioni per eliminarne uno o tutti) quando modifichi il tuo Estrategia di collazione.

Tracce: console, ETW, registro eventi e testo

Il servizio supporta più listener simultanei. Impostazioni di livello tipiche (da 0 a 4): 0: nessun output, 1: errori, 2: avvertenze e gli errori, 3 include informazioni, 4 tutto. Configura ognuno in questo modo:

• consolle: Set-HisDrdaConsoleTraceListener -Level 3
• ETW: Set-HisDrdaEtwTraceListener -Level 3
• Registro eventi: Set-HisDrdaEventLogTraceListener -InitializeData Error,Warning,Information (puoi limitare a Warning).
• Testo: Set-HisDrdaTextTraceListener -Level 3 -AutoFlush $True -InitializeData MsDrdaService.DSTF -MaxTraceEntryCount 1000000 -MaxTraceFileCount 10

Per avviare o interrompere gli ascoltatori: Start-HisDrdaTraceListener y Stop-HisDrdaTraceListener con -Listener <Console|Text|Etw|EventLog>E per vedere il suo stato, Get-HisDrdaTraceListener Restituisce proprietà come Status, Level, InitializeData, limiti di ingresso e di file, ecc., mantenendo al contempo il controllo fine di osservabilità.

Listener di binding di pacchetti personalizzato

Se è necessario intercettare ed elaborare l'output del binding dei pacchetti utilizzando .NET, è possibile registrare il proprio listener con Aggiungi-HisDrdaPackageBindListener:

• -TypeName <string>: tipo completamente qualificato, ad esempio CustomListeners.MyPackageBindListener, CustomListeners, Version=1.0.0.0, Culture=neutral, PublicKeyToken=34013cf74da51d17, processorArchitecture=MSIL.
• -ThrowWhenNoCallback: se non c'è callback, restituisci BGNBNDRM al cliente (vero predefinito).

Add-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener -ThrowWhenNoCallback

consultare Get-HisDrdaPackageBindListener per verificare il tipo registrato e il comportamento dell'errore e rimuove con Rimuovi-HisDrdaPackageBindListener quando il gancio cessano di essere necessari.

Le migliori pratiche rapide per lavorare più comodamente

Per gli script giornalieri, crea alias con Set-Alias (per esempio, ci per Get-ChildItem) e usi Dove-Oggetto con Seleziona/Ordina per elencare ciò che è importante: ad esempio, i 3 processi che consumano più memoria o solo i servizi in uno stato specifico.

Quando si generano report, ConvertTo-Html y Out-File sono i tuoi alleati. E se stai convalidando le prestazioni o la connettività, Get-Counter y comando Test-Connection Ti danno un quadro reale del sistema e della rete in pochissimi comandi.

Esempi utili (copia e incolla)

Alcuni blocchi di utilizzo immediato per velocizzare la tua giornata con il modulo DRDA e PowerShell generalmente:

# Abrir consola/ISE como administrador
Start-Process PowerShell -Verb RunAs
Start-Process PowerShell_ISE -Verb RunAs

# Importar el módulo DRDA
Import-Module "C:\Program Files\Microsoft Host Integration Server 2013\system\Microsoft.HostIntegration.PowerShell"
Get-Module Microsoft.HostIntegration.PowerShell
Get-Command -Module Microsoft.HostIntegration.PowerShell

# Servicio DRDA (valores por defecto)
Set-HisDrdaService -IsPrimary -PingInterval 10000 -Port 446
Get-HisDrdaService

# Conexión a SQL Server
Set-HisDrdaSqlServerConnection -AuthenticationLookupRetryCount 3 -AuthenticationLookupTimeoutDuration PT30S -ClientApplicationName empty -ConnectionString "Data Source=localhost; Integrated Security=True; MultipleActiveResultSets=True" -DefaultCollationName SQL_Latin1_General_CP1_CI_AS -RollbackTransactionOnError -SecurityTokenTimeoutDuration PT8H -StoredProcedureCallTimeout 30
Get-HisDrdaSqlServerConnection

# Enlace de paquetes y caché
Set-HisDrdaPackageBindProcessing -CreatePackageProcedure -PackageXmlFormat v90 -PackageXmlLocation c:\temp -StoredProcedureNameSeparator _
Get-HisDrdaPackageBindProcessing
Set-HisDrdaPackageProcedureCache -FlushTimeSpan P1D
Get-HisDrdaPackageProcedureCache

# Transformaciones SQL
Set-HisDrdaSqlTransform -Type Service
Get-HisDrdaSqlTransform

# Alias DB
Add-HisDrdaDatabaseAlias -SourceCollection DSN8HC91 -SourceLocation CONTOSO -TargetDatabase ContosoRetailDW -TargetSchema DSN8910
Get-HisDrdaDatabaseAlias

# Conversiones de fecha y hora
Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateFormat Usa
Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -TimeFormat HmsPeriod
Add-HisDrdaDatetimeFormat -Conversion Db2ToSql -DateTimeFormat IsoTimestampFormat
Get-HisDrdaDatetimeFormat -DateTime Date

# Codificaciones y conversiones personalizadas
Add-HisCustomCodePage -CodePage 21140 -Name Custom21140 -NlsCodePage 1140 -Description "Custom codepage based on 1140"
Get-HisCustomCodePage -CodePage 21140 -Name Custom21140 -NlsCodePage 1140

# Trazas
Set-HisDrdaConsoleTraceListener -Level 3
Set-HisDrdaEtwTraceListener -Level 3
Set-HisDrdaEventLogTraceListener -InitializeData Warning
Set-HisDrdaTextTraceListener -Level 3 -AutoFlush $True -InitializeData MsDrdaService.DSTF -MaxTraceEntryCount 1000000 -MaxTraceFileCount 10
Start-HisDrdaTraceListener -Listener Text
Get-HisDrdaTraceListener -Listener Text
Stop-HisDrdaTraceListener -Listener Text

# Listener de enlace de paquetes
Add-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener -ThrowWhenNoCallback
Get-HisDrdaPackageBindListener
Remove-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener

Se sei arrivato fin qui, hai già le nozioni di base di cmdlet (nomi, parametri, help e pipeline) e anche un modulo aziendale di alto livello come il servizio DRDA: dalla configurazione del servizio e dalle connessioni a SQL Server, alle tracce, agli alias, alle collazioni, alle codifiche, alle conversioni di data/ora e al binding dei pacchetti. Con questo repertorio, è possibile affrontare qualsiasi cosa, dalle automazioni quotidiane agli scenari ibridi con fiducia e tracciabilità.