Was sind PowerShell-Cmdlets und wie beherrscht man sie?

Wenn jemand PowerShell erwähnt, denkt er als erstes an seine Cmdlets: kleine, aber leistungsstarke Teile, die Aufgaben mit Eleganz lösen. Wenn Sie aus cmd.exe oder andere Shells, werden Sie schnell feststellen, dass wir hier nicht nur mit reinem Text arbeiten; PowerShell ist alles über Objekte, sodass sich das Erlebnis ändert (und zwar zum Besseren).

In diesem Leitfaden erkläre ich Ihnen mit einem äußerst praktischen Ansatz, Was ist ein Cmdlet?, wie sie benannt werden, wie sie kombiniert werden und, am wichtigsten, wie man sie in realen Szenarien nutzt. Wir gehen auch auf ein wichtiges Unternehmensmodul ein: Microsoft.HostIntegration.PowerShell (DRDA-Dienst auf Host Integration Server), mit seiner vollständigen Sammlung von Befehle, Parameter, Syntax und Beispiele, die Sie unverändert in Ihre Konsole einfügen können.

Was ist ein Cmdlet und warum ist es wichtig?

Ein Cmdlet ist ein Befehl zum Powershell Einzelfunktion, leichtgewichtig und für die Arbeit mit Objekten statt mit Strings konzipiert. Im Gegensatz zu einer herkömmlichen ausführbaren Datei ist ein Cmdlet ruft innerhalb der Laufzeit auf PowerShell integriert sich in die Pipeline und kann von Skripten, der Befehlszeile oder sogar von der API von Windows Powershell.

Die Cmdlets sind verpackt in Module die bei Bedarf geladen werden. Sie können in kompilierten .NET-Sprachen oder direkt in PowershellAuf diese Weise können Sie Funktionen verteilen, ohne lose Binärdateien per Drag & Drop verschieben zu müssen, und in jeder Sitzung genau das aktivieren, was Sie benötigen.

Verb-Nomen-Namen und Plattformkonsistenz

Die Cmdlets folgen dem Muster Verb-Nomen (durch einen Bindestrich getrennt). Das Verb drückt die Handlung aus, das Nomen die Ressource, auf die eingewirkt wird. Beispiel: Get-Command listet auf, was in der Shell protokolliert wird. Diese Konvention erleichtert Entdeckung und sorgt für Konsistenz zwischen Herstellern und Geräten.

PowerShell verwaltet eine Liste genehmigter Verben (Get, Set, New, Remove, Add, Start, Stop usw.). Ihre Verwendung hilft Ihren Cmdlets „auffindbar“ sein mit Autovervollständigung und Befehlen wie Get-Command y Get-Help.

Parameter: obligatorisch, positionell und Schalter

Ein Cmdlet deklariert seine Parameter als öffentliche Eigenschaften. Es gibt obligatorische oder optionale, mit einem Namen oder positionellund Schaltertyp (Schalter, die interpretiert werden als was immer dies auch sein sollte. falls angegeben). Darüber hinaus erben sie alle eine Gruppe von Parametern gemeinsam (Wie z -Verbose, -ErrorAction, usw.), auf die bei jedem Aufruf eines Cmdlets zugegriffen werden kann.

Wenn Sie einen erforderlichen Parameter weglassen, werden Sie von PowerShell interaktiv zur Eingabe des Werts aufgefordert. Und wenn Sie einen optionalen Parameter weglassen, wird dessen Wert angewendet. Standardwert; ist ein praktisches und sehr typisches Verhalten auf der Plattform.

Finden Sie heraus, was installiert ist, und erhalten Sie Hilfe

Um zu sehen, welche Module Sie importiert haben, verwenden Sie Get-Module -All. Wenn Sie alle verfügbaren Cmdlets (vordefinierte oder solche, die mit zusätzlichen Modulen geliefert werden) auflisten möchten, ziehen Sie Get-Command, Welches ist das Katalog des Hauses.

Wenn Sie detaillierte Syntax, Beispiele und Hinweise benötigen, rufen Sie Get-Help mit dem Namen des Cmdlets oder besuchen Sie Hilfe und Handbücher konsultieren. Und wenn Sie mehr über die gemeinsame Parameter Im Allgemeinen können Sie konsultieren get-help about_CommonParameters um Zweifel gleich auszuräumen.

Wichtige Cmdlets für den täglichen Gebrauch

Diese sparen Ihnen jede Menge Zeit bei der Verwaltung von Teams oder der Automatisierung von Arbeitsabläufen. Hier sind einige Highlights, die es wert sind, in Ihrer Gesäßtasche zu haben, mit ihren Hauptnutzen und eine Verwendungsidee:

• Get-Process: Listet aktive Prozesse auf; fügt den Namen hinzu, auf den der Fokus gerichtet werden soll. Ideal für die schnelle Diagnostik.
• Stop-Process: stoppt Prozesse nach Name oder ID; mit -Confirm Sie bitten um Bestätigung und mit -PassThru Sie sehen das Ergebnis.
• Get-Service: Zeigt Dienste und deren Status an; kombinieren Sie diese mit Filtern, wenn Sie nach einem bestimmten Dienst suchen. oder ein Typ entschlossen.
• Where-Object: filtert Objekte, die durch die Pipeline laufen; nützlich, um den Überblick zu behalten die entsprechenden in großen Sammlungen.
• Get-History, Clear-History, Add-History: Verwalten Sie die Befehlsverlauf, vom Anschauen der neuesten limpiar Tickets.
• ConvertTo-Html, ConvertTo-Xml: Exportieren Sie Ergebnisse in HTML oder XML für die Berichterstellung und procesamiento später
• Out-File: gibt die Ausgabe in eine Datei aus; ideal für Protokolle oder Prüfung.
• Copy-Item, Move-Item, Get-ChildItem: Basistrio zum Kopieren, Verschieben und listar Elemente.
• Set-Location, Set-Alias, Select-Object: Standort ändern, Verknüpfungen erstellen und Eigenschaften auswählen Notenschlüssel.
• Restart-Computer, Restart-Service, Clear-RecycleBin: direkte Verwaltungsmaßnahmen jeden Tag.
• Get-ComputerInfo, Test-Path, Test-Connection, Befehl Get-WinEvent: Systeminformationen, Routen, Konnektivität und Ereignisse System.
• Debug-Process, Enable-PSBreakpoint, Disable-PSBreakpoint, Get-Counter, Start-Sleep: Debuggen und Überwachen mit Feinsteuerung.

Module und privilegierte Ausführung

PowerShell und seine ISE (Integrated Environment) erfordern möglicherweise erhöhte Berechtigungen für bestimmte Aufgaben. Sie können sie als Administrator über die Benutzeroberfläche oder mit diese Befehle von PowerShell:

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

Wenn Sie mit bestimmten Modulen arbeiten, importieren Sie die Assembly aus ihrem Pfad. Für das DRDA-Dienstmodul in Host Integration Server 2013 würden Sie beispielsweise einfach importiere es Damit:

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

Prüfe das ist geladen und was es exportiert:

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

DRDA-Modul: Übersicht und Anforderungen

Der DRDA-Dienst verwaltet Verbindungen und Transformationen zwischen DRDA-Clients und SQL Server und validiert deren Konfiguration mit einem XSD einbezogen und überwacht Änderungen in MsDrdaService.exe.config. Das Modul Microsoft.HostIntegration.PowerShell gruppiert Cmdlets in Sammlungen von Konfiguration und Vorgänge zum Konfigurieren des Dienstes, Traces, SQL-Transformationen, Kodierungen und mehr.

Empfehlungen de Starten: Öffnen Sie PowerShell/IE als Administrator. Importieren Sie das Modul von Ihrer Route, wenn Sie nicht registriert sind, überprüfen Sie Get-Module und listet die Befehle mit Get-Command -Module Microsoft.HostIntegration.PowerShell.

Vollständige Liste der DRDA-Dienst-Cmdlets

Dies sind die Cmdlets, die das Modul gemäß der Registrierung im System bereitstellt. Sie reichen von Kodierungen und Konvertierungen bis hin zu Service, Aliase, Traces und Paketlink:

• Add-HisCustomCodePage
• Add-HisCustomConversion
• Add-HisDrdaApplicationEncoding
• Add-HisDrdaCollationName
• Add-HisDrdaDatabaseAlias
• Add-HisDrdaDatetimeFormat
• Add-HisDrdaPackageBindListener
• Get-HisCustomCodePage
• Get-HisCustomConversion
• Get-HisDrdaApplicationEncoding
• Get-HisDrdaCollationName
• Get-HisDrdaDatabaseAlias
• Get-HisDrdaDatetimeFormat
• Get-HisDrdaPackageBindListener
• Get-HisDrdaPackageBindProcessing
• Get-HisDrdaPackageProcedureCache
• Get-HisDrdaService
• Get-HisDrdaSqlServerConnection
• Get-HisDrdaSqlTransform
• Get-HisDrdaTraceListener
• Remove-HisCustomCodePage
• Entfernen-HisCustomConversion
• Entfernen-HisDrdaApplicationEncoding
• Remove-HisDrdaCollationName
• Remove-HisDrdaDatabaseAlias
• Remove-HisDrdaDatetimeFormat
• Remove-HisDrdaPackageBindListener
• Set-HisDrdaConsoleTraceListener
• Set-HisDrdaEtwTraceListener
• Set-HisDrdaEventLogTraceListener
• Set-HisDrdaPackageBindProcessing
• Set-HisDrdaPackageProcedureCache
• Set-HisDrdaService
• Set-HisDrdaSqlServerConnection
• Set-HisDrdaSqlTransform
• Set-HisDrdaTextTraceListener
• Start-HisDrdaTraceListener
• Stop-HisDrdaTraceListener

DRDA-Konnektivität und Paketverbindung: Basiskonfiguration

Set-HisDrdaService Konfigurieren Sie den Dienst für die Bedienung von DRDA-Clients: Port, SSL/TLS, Liste der zulässigen Clients und zugehörige Server. Wichtige Parameter:

• -AllowClientIpAddresses <string>: Beschränkt Clients (IPv4/IPv6 oder Aliase; durch „;“ getrennt). Standard: Leere Zeichenfolge (akzeptiert alle).
• -EnablePerformanceCounters: Aktiviert Zähler. Boolean; Standard falsch.
• -IsPrimary: Primäre Rolle in der Servergruppe. Boolesch; Standard was immer dies auch sein sollte.. Kann eine Liste der Server (SRVLST) zurückgeben.
• -PartnerServers <string>: Liste der sekundären IP:puerto (getrennt durch „;“). Erforderlich, wenn -IsPrimary:$false. Standardmäßig leer.
• -PingInterval <uint32>: Überwacht zugehörige Server (EXCSAT/EXCSATRD). Standard: 10000 ms.
• -Port <uint32>: Abhörport für DRDA-Clients. Standard 446.
• -UseSsl y -SslCertificatePath <string>: SSL 3.0/TLS 1.0; wenn SSL aktiviert ist, gibt die CN des Zertifikats an.

Beispiel mit Standardwerte:

Set-HisDrdaService -IsPrimary -PingInterval 10000 -Port 446

Um die aktuelle Konfiguration zu überprüfen, Get-HisDrdaService gibt Eigenschaften zurück wie AllowClientIpAddresses, IsPrimary, PartnerServers, EnablePerformanceCounters, PingInterval, Port, SslCertificatePath y UseSsl.

Get-HisDrdaService

Herstellen einer Verbindung mit SQL Server und Runtime

Mit Set-HisDrdaSqlServerConnection Sie konfigurieren die Verbindung zum SQL Server (Verbindungszeichenfolge, Timeouts, Standardsortierung, Authentifizierungszuordnungen usw.). Wichtige Parameter sind:

• -ConnectionString <string>: ADO.NET-Anbieter für SQL Server. Standard: Data Source=; Integrated Security=True; MultipleActiveResultSets=True.
• -AuthenticationLookupRetryCount <uint32> y -AuthenticationLookupTimeoutDuration <string> (z. B. XML-Dauerformat) PT30S).
• -ClientApplicationName <string>: externalName (benutzt Bytes 1-8 von EXTNAM) oder transactionIdentifier (Bytes 5-8 EXTNAM in CICS).
• -DefaultCollationName <string>: Standard SQL_Latin1_General_CP1_CI_AS.
• -EnableArithAbort: emittiert SET ARITHABORT beim Verbinden (falsch por defekto).
• -HostInitiatedAffiliateApplication y -WindowsInitiatedAffiliateApplication: Integration mit SSO von Microsoft Enterprise (basierend auf Authentifizierung).
• -MappedAuthenticationDomain <string>: AD-Domäne, der die Anmeldeinformationen des DRDA-Clients zugeordnet werden sollen.
• -RollbackTransactionOnError: führt aus ROLLBACK nach Datenbankfehler (was immer dies auch sein sollte. por defekto).
• -SecurityTokenTimeoutDuration <string>: Tokendauer (z. B. PT8H).
• -StoredProcedureCallTimeout <uint32>: Wartezeit in Sekunden CALL (0 = keine Begrenzung; Standard 30).

Beispielkonfiguration typische Werte:

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

Abfrage der Konfiguration mit Get-HisDrdaSqlServerConnection zu sehen ArithAbort, AuthenticationLookupTimeout, AuthenticationLookupRetryCount, ClientApplicationName, ConnectionString, DefaultCollationName, HostInitiatedAffiliateApplication, MappedAuthenticationDomain, RollbackTransactionOnError, SecurityTokenTimeoutSeconds, StoredProcedureCallTimeoutSeconds y WindowsInitiatedAffiliateApplication.

Binden von Paketen und gespeicherten Prozeduren

Set-HisDrdaPackageBindProcessing Steuert, wie statisches DRDA-SQL in SQL Server-Prozeduren umgewandelt wird, ob Paket-XML generiert wird, erweiterte Eigenschaften beibehalten werden usw. Wichtige Parameter:

• -CreatePackageProcedure: transformiert einen Fluss BGNBND im Verfahren (was immer dies auch sein sollte. por defekto).
• -CreatePackageProcedureWithCustomSqlScripts: Prozesse BGNBND/BNDSQLSTT über einen externen Listener (falsch por defekto).
• -CreatePackageProcedureWithExtendedProperties: behält Optionen wie erweiterte Eigenschaften bei (falsch por defekto).
• -CreatePackageXml, -PackageXmlFormat <v85|v90> (Standard v90) Und -PackageXmlLocation (Standard c:\temp).
• -StoredProcedureNameSeparator: Trennzeichen zwischen Paketname und SP (Standard) _).
• -PackageProcedureSchemaList: alternative Schemata (durch Kommas getrennte Liste).

Ejemplo typisch:

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

Statusabfrage mit Get-HisDrdaPackageBindProcessing um zu sehen, ob Prozeduren erstellt werden, ob XML generiert wird, Format, Speicherort, Trennzeichen, erweiterte Eigenschaften, benutzerdefinierte Skripte und die Liste der Schemata.

Prozedurmetadaten-Cache

Mit Set-HisDrdaPackageProcedureCache Sie legen fest, wie oft der Prozedur-Metadaten-Cache (Anweisungstyp, Cursor, Parameter) geleert wird. Verwenden Sie XML-Zeiträume, z. B. P1D für einen Tag.

Set-HisDrdaPackageProcedureCache -FlushTimeSpan P1D
Get-HisDrdaPackageProcedureCache

Dies ist nützlich, wenn Sie häufig Änderungen vornehmen Verfahren, wodurch die Verwendung veralteter Metadaten vermieden wird.

SQL-Transformationen (intern oder CLR)

Set-HisDrdaSqlTransform schaltet zwischen serviceinternen oder CLR-basierten Transformationen um und gibt an, ob die Ausgabe als Unicode oder ANSI:

• -Type <Service|Clr>: Standard Service.
• -EnableUnicodeOutput: falsch standardmäßig (generiert ANSI CHAR/VARCHAR).

Set-HisDrdaSqlTransform -Type Service
Get-HisDrdaSqlTransform

Datenbankaliase (DB2 ⇄ SQL Server)

Mit Add-HisDrdaDatabaseAlias Ordnet RDBNAM und COLID (DB2) der Datenbank und dem Ausgabeschema im SQL Server zu. Parameter:

• -SourceLocation <string>: Quelle RDBNAM (leer = beliebiger Wert).
• -SourceCollection <string>: Quell-COLID (leer = beliebig).
• -TargetDatabase <string> y -TargetSchema <string>: Ziel in SQL Server (leer = beliebig).

Ejemplo:

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

wenden Sie sich an Get-HisDrdaDatabaseAlias um aktive Zuordnungen zu überprüfen und Remove-HisDrdaDatabaseAlias um sie zu entfernen, wenn sie nicht mehr gelten.

Datum und Uhrzeit: Formate und Konvertierungen

Add-HisDrdaDatetimeFormat Deklariert Konvertierungen zwischen DB2- und SQL Server-Formaten für DATE, TIME und DATETIME (einschließlich CHAR/VARCHAR zur Darstellung von Datumsangaben). Parameter:

• -Conversion <Db2ToSql|SqlToDb2>: Konvertierungsrichtung.
• -DateFormat, -TimeFormat, -DateTimeFormat: Formattyp (vom Dienst unterstützte Enumerationen).

Beispiele Stromschnellen:

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

Um zu sehen, was definiert ist, verwenden Sie Get-HisDrdaDatetimeFormat mit -DateTime <Date|Time|DateTime>. Und wenn Sie eine bestimmte Regel entfernen müssen, Remove-HisDrdaDatetimeFormat ermöglicht Ihnen das Löschen der gewünschten Kombination (Adresse und Format).

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

Benutzerdefinierte Kodierungen und Codepages

Der Dienst kann benutzerdefinierte NLS-Codepages über den HIS-Encoder laden. Mit Add-HisCustomCodePage Sie geben die Nummer, den Namen und die Standard-NLS-Basis an, die es ersetzt:

• -CodePage <uint32>, -Name <string>, -NlsCodePage <uint32> und optional -Description.

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

Konsultieren und löschen mit Get-HisCustomCodePage (Filter nach Name oder Nummer) und Remove-HisCustomCodePage (mit Namen). Es ist eine schicke Art sich anpassen Kodierungen für Legacy-Szenarien.

Codepunktkonvertierung (EBCDIC ⇄ Unicode)

Um bestimmte Zuweisungen in Standard- oder benutzerdefinierten Codepages zu überschreiben, verwenden Sie Add-HisCustomConversion. Sie können vorbeikommen -CodePage warum -Nameund definieren Sie Paare mit -EbcdicToUnicode o -UnicodeToEbcdic in Form To=From (hexadezimal).

Überprüfen Sie mit Get-HisCustomConversion Anzeige der -Type (EbcdicToUnicode oder UnicodeToEbcdic) und die Seite oder den Namen und entfernt mit Entfernen-HisCustomConversion wenn das System nicht mehr benötigt wird, Wartung reinigen.

Anwendungskodierungen nach Datenbank

Wenn eine bestimmte Basis eine CCSID spezifisch (oder ein Unicode/EBCDIC/Ansi-Schema) für Ausgabeparameter und Ergebnismengen, Add-HisDrdaApplicationEncoding löst es:

• -Ccsid <uint32> o -CustomCcsid <uint32> y -Database <string> (mehr -Scheme <string>, Standard Unicode).

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

Zum Prüfen oder Bereinigen verwenden Sie Get-HisDrdaApplicationEncoding (Filter nach Ccsid, CustomCcsid oder Datenbank) und Entfernen-HisDrdaApplicationEncoding wie Sie brauchen zurücktreten Definitionen.

Sortierungszuweisung (ORDER BY COLLATE)

Wenn Sie Abfragen transformieren mit ORDER BYkönnen Sie DB2-Sortierungsnamen SQL Server-Sortierungsnamen zuordnen mit Add-HisDrdaCollationName:

• -From <string>: DB2-Sortierungsname (COLLATION_KEY).
• -To <string>: SQL Server-Sortierungsname.

Add-HisDrdaCollationName -From UCA400R1_LEN_AN -To SQL_EBCDIC037_CP1_CS_AS

wenden Sie sich an Get-HisDrdaCollationName (Filter nach -From o -To) und entfernen Sie mit Remove-HisDrdaCollationName (Optionen zum Löschen eines oder aller), wenn Sie Ihre estrategia der Kollation.

Traces: Konsole, ETW, Ereignisprotokoll und Text

Der Dienst unterstützt mehrere gleichzeitige Listener. Typische Level-Einstellungen (0 bis 4): 0: keine Ausgabe, 1: Fehler, 2: Warnungen und Fehler, 3 enthält Informationen, 4 alles. Konfigurieren Sie jeden wie folgt:

• Konsole: Set-HisDrdaConsoleTraceListener -Level 3
• ETW: Set-HisDrdaEtwTraceListener -Level 3
• Ereignisprotokoll: Set-HisDrdaEventLogTraceListener -InitializeData Error,Warning,Information (Sie können beschränken auf Warning).
• Text: Set-HisDrdaTextTraceListener -Level 3 -AutoFlush $True -InitializeData MsDrdaService.DSTF -MaxTraceEntryCount 1000000 -MaxTraceFileCount 10

So starten oder stoppen Sie Listener: Start-HisDrdaTraceListener y Stop-HisDrdaTraceListener mit -Listener <Console|Text|Etw|EventLog>. Und um seinen Status zu sehen, Get-HisDrdaTraceListener Es gibt Eigenschaften zurück wie Status, Level, InitializeData, Eingabe- und Dateilimits usw. unter Beibehaltung der Feinsteuerung der Beobachtbarkeit.

Benutzerdefinierter Paketbindungs-Listener

Wenn Sie die Ausgabe der Paketbindung mit .NET abfangen und verarbeiten müssen, können Sie Ihren eigenen Listener mit registrieren Add-HisDrdaPackageBindListener:

• -TypeName <string>: vollständig qualifizierter Typ, zum Beispiel CustomListeners.MyPackageBindListener, CustomListeners, Version=1.0.0.0, Culture=neutral, PublicKeyToken=34013cf74da51d17, processorArchitecture=MSIL.
• -ThrowWhenNoCallback: Wenn kein Rückruf erfolgt, kehren Sie zurück BGNBNDRM an den Kunden (was immer dies auch sein sollte. por defekto).

Add-HisDrdaPackageBindListener -TypeName CustomListeners.MyPackageBindListener -ThrowWhenNoCallback

wenden Sie sich an Get-HisDrdaPackageBindListener um den registrierten Typ und das Fehlerverhalten zu überprüfen und entfernt mit Remove-HisDrdaPackageBindListener wenn die Haken nicht mehr notwendig sind.

Schnelle Best Practices für komfortableres Arbeiten

Für tägliche Skripte erstellen Sie Aliase mit Set-Alias (zum Beispiel, ci für Get-ChildItem) und verwendet Wo-Objekt Mit „Auswählen/Sortieren“ können Sie auflisten, was wichtig ist: beispielsweise die drei speicherintensivsten Prozesse oder nur Dienste in einem bestimmten Zustand.

Wenn Sie Berichte erstellen, ConvertTo-Html y Out-File sind Ihre Verbündeten. Und wenn Sie Leistung oder Konnektivität validieren, Zähler abrufen y Befehl Test-Connection Sie geben Ihnen mit sehr wenigen Befehlen ein realistisches Bild des Systems und des Netzwerks.

Nützliche Beispiele (Kopieren und Einfügen)

Einige sofort nutzbare Blöcke, um Ihren Alltag mit dem DRDA-Modul zu beschleunigen und Powershell en allgemein:

# 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

Wenn Sie es bis hierher geschafft haben, beherrschen Sie bereits die Grundlagen von Cmdlets (Namen, Parameter, Hilfe und Pipeline) und auch ein Top-Level-Enterprise-Modul wie der DRDA-Dienst: von der Dienstkonfiguration und Verbindungen zu SQL Server bis hin zu Traces, Aliasen, Sortierungen, Kodierungen, Datums-/Zeitkonvertierungen und Paketbindung. Mit diesem Repertoire können Sie alles von täglichen Automatisierungen bis hin zu hybriden Szenarien bewältigen mit Vertrauen und Rückverfolgbarkeit.