Citrix Insight Services
Citrix Insight Services (CIS) ist eine Plattform von Citrix für Instrumentierung, Telemetrie und Ablaufverfolgung. Mit ihren Funktionen für Instrumentierung und Telemetrie können technische Benutzer (Kunden, Partner und Techniker) Probleme selbst diagnostizieren und beseitigen und die IT-Umgebung optimieren. Einzelheiten und aktuelle Informationen zu CIS und seiner Funktionsweise finden Sie unter https://cis.citrix.com (Citrix Anmeldeinformationen sind erforderlich).
Die an Citrix hochgeladenen Informationen werden für die Problembehandlung und zu Diagnosezwecken verwendet sowie zum Verbessern der Qualität, Zuverlässigkeit und Leistung von Produkten. Dabei gelten folgende Richtlinien:
- Citrix Insight Services-Richtlinie unter https://cis.citrix.com/legal
- Citrix Datenschutzrichtlinie unter https://www.cloud.com/privacy-policy
Dieses Release von Citrix Virtual Apps and Desktops unterstützt die nachfolgend aufgeführten Technologien.
- Analyse für Installationen und Upgrades von Citrix Virtual Apps and Desktops
- Citrix-Programm zur Verbesserung der Benutzerfreundlichkeit (CEIP)
- Citrix Call Home
- Citrix Scout
Zusätzlich zu CIS und Citrix Analytics-Daten werden Google Analytics-Daten bei der Installation (oder dem Upgrade) von Studio automatisch und separat erfasst und später hochgeladen. Nach der Installation von Studio können Sie diese Einstellung über den Registrierungsschlüssel “HKLM\Software\Citrix\DesktopStudio\GAEnabled” ändern. Der Wert 1 ermöglicht Sammeln und Upload, 0 deaktiviert Sammeln und Upload.
Analysedaten zu Installationen und Upgrades
Wenn Sie mit dem Produktinstallationsprogramm Citrix Virtual Apps and Desktops-Komponenten bereitstellen oder aktualisieren, werden anonyme Informationen über den Installationsvorgang gesammelt und auf der Maschine gespeichert, auf der Sie die Komponente installieren/aktualisieren. Mithilfe dieser Daten verbessert Citrix das Kundenerlebnis bei der Installation.
Die Informationen werden lokal unter %ProgramData%\Citrix\CTQs gespeichert.
Der automatische Upload dieser Daten ist in der grafischen Oberfläche und der Befehlszeilenschnittstelle des Installationsprogramms für das komplette Produkt standardmäßig aktiviert.
- Sie können die Standardeinstellung über eine Registrierungseinstellung ändern. Wenn Sie die Registrierungseinstellung vor dem Installieren/Upgrade ändern, wird der gewählte Wert angewendet, wenn Sie das Installationsprogramm für das komplette Produkt verwenden.
- Sie können die Standardeinstellung beim Installieren bzw. Upgrade für die Befehlszeilenschnittstelle außer Kraft setzen, indem Sie eine Option mit dem Befehl eingeben.
Steuern automatischer Uploads:
-
Registrierungseinstellung zur Steuerung des automatischen Uploads von Installations-/Upgradeanalysedaten (Standard = 1):
- Ort: HKLM:\Software\Citrix\MetaInstall
- Name: SendExperienceMetrics
- Wert: 0 = deaktiviert , 1 = aktiviert
-
Das folgende PowerShell-Cmdlet deaktiviert den automatischen Upload von Installations-/Upgradeanalysedaten:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\MetaInstall -Name SendExperienceMetrics -PropertyType DWORD -Value 0 <!--NeedCopy-->
-
Zum Deaktivieren des automatischen Uploads über den Befehl “XenDesktopServerSetup.exe” oder “XenDesktopVDASetup.exe” verwenden Sie die Option
/disableexperiencemetrics
.Zum Aktivieren des automatischen Uploads über den Befehl “XenDesktopServerSetup.exe” oder “XenDesktopVDASetup.exe” verwenden Sie die Option
/sendexperiencemetrics
.
Citrix Programm zur Verbesserung der Benutzerfreundlichkeit
Wenn Sie am Programm zur Verbesserung der Benutzerfreundlichkeit (Customer Experience Improvement Program, CEIP) teilnehmen, werden anonyme Statistiken und Nutzungsinformationen an Citrix gesendet, damit Citrix die Qualität und Leistung seiner Produkte verbessern kann. Weitere Informationen finden Sie unter https://more.citrix.com/XD-CEIP.
Registrierung bei Erstellung/Upgrade der Site
Beim Erstellen einer Site werden Sie (nach Installation des ersten Delivery Controllers) automatisch für das Programm zur Verbesserung der Benutzerfreundlichkeit registriert. Der erste Datenupload erfolgt ca. sieben Tage nach dem Erstellen der Site.
Sie können Ihre Teilnahme nach dem Erstellen der Site jederzeit beenden. Wählen Sie im linken Bereich von Web Studio den Knoten Einstellungen (Registerkarte Produktsupport) und deaktivieren Sie die Einstellung für das Citrix Programm zur Verbesserung der Benutzerfreundlichkeit.
Beim Upgrade einer Citrix Virtual Apps and Desktops-Bereitstellung:
- Wenn Sie ein Upgrade von einer Version durchführen, die CEIP nicht unterstützte, werden Sie gefragt, ob Sie teilnehmen möchten.
- Wenn Sie ein Upgrade von einer Version durchführen, die CEIP unterstützte und die Teilnahme war aktiviert, ist CEIP in der aktualisierten Site aktiviert.
- Wenn Sie ein Upgrade von einer Version durchführen, die CEIP unterstützte und die Teilnahme war deaktiviert, ist CEIP in der aktualisierten Site deaktiviert.
- Wenn Sie ein Upgrade von einer Version durchführen, die CEIP unterstützte und die Teilnahme ist nicht bekannt, werden Sie gefragt, ob Sie teilnehmen möchten.
Die erfassten Informationen sind anonym, daher können sie nach dem Upload auf Citrix Insight Services nicht angezeigt werden.
Registrierung beim Installieren eines VDAs
Standardmäßig werden Sie automatisch beim CEIP registriert, wenn Sie einen Windows-VDA installieren. Sie können die Standardeinstellung über eine Registrierungseinstellung ändern. Wenn Sie die Registrierungseinstellung ändern, bevor Sie den VDA installieren, wird der neue Wert verwendet.
Registrierungseinstellung zur Steuerung der automatischen Registrierung in CEIP (Standard = 1):
Ort: HKLM: \Software\Citrix\Telemetry\CEIP Name: Enabled Wert: 0 = disabled, 1 = enabled
Standardmäßig ist die Eigenschaft Enabled
in der Registrierung verborgen. Wird sie nicht festgelegt, dann ist der automatische Upload aktiviert.
Mit dem folgenden PowerShell-Cmdlet wird die Registrierung beim CEIP deaktiviert:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0
<!--NeedCopy-->
Die erfassten Laufzeitdatenpunkte werden regelmäßig als Datei in einen Ausgabeordner geschrieben (standardmäßig %programdata%/Citrix/VdaCeip).
Der erste Datenupload erfolgt ca. sieben Tage nach der Installation des VDAs.
Registrierung bei der Installation anderer Produkte und Komponenten
Sie können auch am Programm zur Verbesserung der Benutzerfreundlichkeit teilnehmen, wenn Sie andere Produkte, Komponenten und Technologien von Citrix installieren, z. B. Citrix Provisioning, AppDNA, Citrix Lizenzserver, die Citrix Workspace-App für Windows, den universellen Druckserver und die Sitzungsaufzeichnung. Standardwerte für die Installation und Teilnahme finden Sie in der Dokumentation dieser Komponenten.
Citrix Call Home
Wenn Sie bestimmte Komponenten und Features in Citrix Virtual Apps and Desktops installieren, wird Ihnen angeboten, an Citrix Call Home teilzunehmen. Call Home erfasst Diagnosedaten und lädt in regelmäßigen Abständen Telemetriepakete mit den Daten über HTTPS am Standardport 443 direkt zu Citrix Insight Services zur Analyse und Problembehandlung hoch.
Call Home wird in Citrix Virtual Apps and Desktops als Hintergrunddienst unter dem Namen “Citrix Telemetry Service” ausgeführt. Weitere Informationen finden Sie unter https://more.citrix.com/XD-CALLHOME.
Die Call Home-Planungsfunktion ist auch in Citrix Scout verfügbar. Weitere Informationen finden Sie unter Citrix Scout.
Folgendes wird erfasst
Die Citrix Diagnostic Facility (CDF)-Ablaufverfolgung protokolliert Informationen, die für die Problembehandlung hilfreich sein können. Call Home erfasst eine Untergruppe der CDF-Ablaufverfolgungen, die bei der Problembehandlung allgemeiner Fehler, z. B. bei VDA-Registrierungen und Starts von Anwendung und Desktops, hilfreich sein können. Diese Technologie wird auch als Always-On-Ablaufverfolgung (Always-On Tracing, AOT) bezeichnet. AOT-Protokolle werden im Ordner C:\Users\CitrixTelemetryService\Appdata\Local\CitrixAOT gespeichert.
Call Home erfasst keine anderen ETW-Informationen (Ereignisablaufverfolgung für Windows) und kann auch nicht dafür konfiguriert werden.
Call Home erfasst auch andere Informationen, z. B.:
- Von Citrix Virtual Apps and Desktops unter
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix
erstellte Registrierungseinträge - Informationen zu Windows Management Instrumentation (WMI) unter dem Citrix Namespace.
- Liste der aktuellen Prozesse
- Absturzabbilder von Citrix Prozessen, die unter %PROGRAM DATA%\Citrix\CDF gespeichert wurden
- Informationen zu Installation und Upgrade. Diese können das Protokoll des Metainstallers für das vollständige Produkt, Protokolle über MSI-Fehler, die Ausgabe der MSI-Protokollanalyse, StoreFront-Protokolle, Protokolle der Lizenzkompatibilitätsprüfung und Ergebnisse vorläufiger Site-Upgradetests umfassen.
Die Ablaufverfolgungsinformationen werden bei der Erfassung komprimiert. Der Citrix Telemetriedienst speichert maximal 10 MB Ablaufverfolgungsinformationen in komprimierter Form für maximal acht Tage.
- Durch das Komprimieren der Daten benötigt Call Home nicht viel Speicherplatz auf dem VDA.
- Ablaufverfolgungen bleiben im Speicher erhalten, damit auf bereitgestellten Maschinen keine IOPS erfolgen müssen.
- Der Ablaufverfolgungspuffer verwendet einen kreisförmigen Mechanismus, um Ablaufverfolgungen im Speicher zu erhalten.
Call Home erfasst die unter Schlüsseldatenpunkte in Call Home aufgeführten wichtigen Datenpunkte.
Konfigurations- und Verwaltungszusammenfassung
Sie können sich bei Call Home mit dem Assistenten des Produktinstallationsprogramms oder später mit PowerShell-Cmdlets registrieren. Wenn Sie sich registrieren, werden standardmäßig Diagnosedaten erfasst und jeden Sonntag um ca. 03.00 Uhr Ortszeit an Citrix hochgeladen. Der Zeitpunkt des Uploads wird innerhalb eines Zwei-Stunden-Fensters ab dem angegebenen Zeitpunkt zufällig festgelegt. Dies bedeutet, dass ein Upload nach dem Standardzeitplan zwischen 03:00 und 05:00 Uhr morgens erfolgt.
Wenn Sie keine Diagnosedaten nach Plan hochladen oder den Zeitplan ändern möchten, können Sie mit PowerShell-Cmdlets Call Home-Daten manuell erfassen und hochladen.
Bei der Registrierung für geplante Call Home-Uploads und beim manuellen Hochladen von Diagnoseinformationen an Citrix geben Sie Ihre Anmeldeinformationen für Ihr Citrix Konto oder Citrix Cloud an. Citrix ersetzt die Anmeldeinformationen durch ein Uploadtoken zum Identifizieren des Kunden und Hochladen der Daten. Die Anmeldeinformationen werden nicht gespeichert.
Wenn Upload ausgeführt wird, wird per E-Mail eine Benachrichtigung an die Adresse des Citrix Kontos gesendet.
Wenn Sie Call Home bei Installation einer Komponente aktivieren, können Sie es später deaktivieren.
Voraussetzungen
- Auf der Maschine muss PowerShell 3.0 oder höher ausgeführt werden.
- Der Citrix Telemetriedienst muss auf der Maschine ausgeführt werden.
- Die Systemvariable
PSModulePath
muss auf den Installationspfad des Telemetriediensts festgelegt werden (z. B. C:\Programme\Citrix\Telemetry Service\)
Aktivieren von Call Home während der Komponenteninstallation
VDA-Installation/-Upgrade: Wenn Sie einen Virtual Delivery Agent über die grafische Benutzeroberfläche des Produktinstallationsprogramms installieren oder aktualisieren, werden Sie gefragt, ob Sie an Call Home teilnehmen möchten. Es gibt zwei Optionen:
- An Call Home teilnehmen
- Nicht an Call Home teilnehmen
Wenn Sie einen VDA aktualisieren und zuvor für Call Home registriert waren, wird diese Seite des Assistenten nicht angezeigt.
Controller-Installation/-Upgrade: Wenn Sie einen Delivery Controller über die grafische Benutzeroberfläche installieren oder aktualisieren, werden Sie gefragt, ob Sie an Call Home teilnehmen möchten. Es gibt drei Optionen:
Wenn Sie einen Controller installieren, können Sie Informationen nicht mehr über die Call Home-Seite des Installationsassistenten konfigurieren, wenn auf den Server ein Active Directory-Gruppenrichtlinienobjekt mit der Richtlinieneinstellung “Als Dienst anmelden” angewendet wurde. Weitere Informationen finden Sie unter CTX218094.
Wenn Sie einen Controller aktualisieren und bereits bei Call Home registriert sind, werden Sie nicht gefragt, ob teilnehmen möchten.
PowerShell-Cmdlets
Die PowerShell-Hilfe enthält umfassende Syntax, einschließlich Beschreibungen von Cmdlets und Parametern, die nicht so häufig verwendet werden.
Informationen zur Verwendung eines Proxyservers für Uploads finden Sie unter Konfigurieren eines Proxyservers.
-
Aktivieren geplanter Uploads: Diagnosedaten werden automatisch an Citrix hochgeladen. Wenn Sie keine zusätzlichen Cmdlets für einen benutzerdefinierten Zeitplan eingeben, wird der Standardzeitplan verwendet.
$cred = Get-Credential Enable-CitrixCallHome -Credential $cred <!--NeedCopy-->
Um sicherzustellen, dass geplante Uploads aktiviert sind, geben Sie
Get-CitrixCallHomeGet-CitrixCallHome
ein. Wenn die Option aktiviert ist, wirdIsEnabled=True
undIsMasterImage=False
zurückgegeben. -
Aktivieren von geplanten Uploads für Maschinen, die von einem Masterimage erstellt wurden: Wenn Sie geplante Uploads in einem Masterimage konfigurieren, brauchen Sie nicht jede einzelne im Maschinenkatalog erstellte Maschine zu konfigurieren.
Enable-CitrixCallHome -Credential $cred -MasterImage
Um sicherzustellen, dass geplante Uploads aktiviert sind, geben Sie Get-CitrixCallHome ein. Wenn die Option aktiviert ist, wird
IsEnabled=True
undIsMasterImage=True
zurückgegeben. -
Erstellen eines benutzerdefinierten Zeitplans: Es kann ein Zeitplan für die tägliche oder wöchentliche Erfassung und Übermittlung von Diagnosedaten erstellt werden.
$timespan = New-TimeSpan –Hours hours -Minutes minutes Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek day -UploadFrequency {Daily|Weekly} <!--NeedCopy-->
Beispiele:
Das folgende Cmdlet erstellt einen Zeitplan, nach dem Datenpakete jeden Abend um 22:20 Uhr erstellt und hochgeladen werden. Der Parameter für Stunden verwendet das 24-Stunden-Format. Wenn der Wert für den Parameter UploadFrequency
auf “Daily” festgelegt ist, wird der Parameter DayOfWeek
ignoriert, wenn er angegeben ist.
$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan -UploadFrequency Daily
<!--NeedCopy-->
Um den Zeitplan zu bestätigen, geben Sie Get-CitrixCallHomeSchedule
ein. Im vorangegangenen Beispiel wird StartTime=22:20:00, DayOfWeek=Sunday (ignored), Upload Frequency=Daily
zurückgegeben.
Das folgende Cmdlet erstellt einen Zeitplan, nach dem Datenpakete mittwochabends um 22:20 Uhr erstellt und hochgeladen werden.
$timespan – New-TimeSpan –Hours 22 –Minutes 20
Set-CitrixCallHomeSchedule –TimeOfDay $timespan –DayOfWeek Wed -UploadFrequency Weekly
<!--NeedCopy-->
Um den Zeitplan zu bestätigen, geben Sie Get-CitrixCallHomeSchedule
ein. Im vorangegangenen Beispiel wird StartTime=22:20:00, DayOfWeek=Wednesday, Upload Frequency=Weekly
zurückgegeben.
Deaktivieren von Call Home
Sie können Call Home mit einem PowerShell-Cmdlet oder mit Citrix Scout deaktivieren.
AOT-Protokolle werden erfasst und auf dem Datenträger gespeichert, selbst wenn geplante Uploads von Call Home deaktiviert sind. (Wenn geplante Uploads deaktiviert sind, werden AOT-Protokolle nicht automatisch an Citrix hochgeladen.) Sie können die Erfassung und lokale Speicherung von AOT-Protokollen deaktivieren.
Deaktivieren von Call Home mit PowerShell
Nach Ausführen des folgenden Cmdlets werden Diagnosedaten nicht automatisch an Citrix hochgeladen. (Sie können Pakete mit Diagnosedaten weiterhin mit PowerShell-Telemetrie-Cmdlets oder Citrix Scout hochladen.)
Disable-CitrixCallHome
Geben Sie Get-CitrixCallHome
ein, um zu bestätigen, dass Call Home deaktiviert werden soll. Wenn die Option deaktiviert ist, wird IsEnabled=False
und IsMasterImage=False
zurückgegeben.
Deaktivieren eines Erfassungszeitplans mit Citrix Scout
Folgen Sie zum Deaktivieren eines Zeitplans zur Diagnosedatenerfassung mit Citrix Scout den Anweisungen unter Planen der Sammlung. Klicken Sie in Schritt 3 auf Aus, um den Zeitplan für die ausgewählten Maschinen zu deaktivieren.
Deaktivieren der Erfassung von AOT-Protokollen
Nach Ausführen des folgenden Cmdlets (mit Feld Enabled
= false
) werden AOT- Protokolle nicht weiter erfasst.
Enable-CitrixTrace -Listen'{"trace":{"enabled":false,"persistDirectory":"C:\Users\Public","maxSizeBytes":1000000, "sliceDurationSeconds":300}}'
Der Parameter Listen
enthält Argumente im JSON-Format.
Konfigurieren eines Proxyservers für Call Home-Uploads
Führen Sie die folgenden Aufgaben auf der Maschine aus, auf der Call Home aktiviert ist. Die Beispiele im nachfolgenden Verfahren enthalten die Serveradresse und Port 10.158.139.37:3128. Die entsprechenden Adressen in Ihrer Umgebung sind anders.
-
Geben Sie Proxyserverinformationen im Browser ein. Wählen Sie in Internet Explorer Internetoptionen > Verbindungen > LAN-Einstellungen. Wählen Sie Proxyserver für das LAN verwenden und geben Sie die Adresse und Portnummer des Proxyservers ein.
-
Führen Sie in PowerShell
netsh winhttp import proxy source=ie
aus. -
Bearbeiten Sie mit einem Text-Editor die Konfigurationsdatei TelemetryService.exe in C:\Programme\Citrix\Telemetry Service. Fügen Sie die in dem roten Feld dargestellten Informationen hinzu.
-
Starten Sie den Telemetriedienst neu.
Führen Sie die Call Home-Cmdlets in PowerShell aus.
Manuelles Erfassen und Hochladen von Diagnoseinformationen
Sie können über die CIS-Website ein Diagnoseinformationspaket nach CIS hochladen. Sie können auch PowerShell-Cmdlets zum Erfassen und Hochladen von Diagnoseinformationen nach CIS verwenden.
Hochladen eines Pakets über die CIS-Website:
- Melden Sie sich mit Ihren Citrix Kontoanmeldeinformationen an Citrix Insight Services an.
- Wählen Sie My Workspace.
- Wählen Sie Healthcheck und navigieren Sie zum Speicherort der Daten.
CIS unterstützt mehrere PowerShell-Cmdlets, die Datenuploads verwalten. In dieser Dokumentation werden die Cmdlets für zwei häufige Fälle behandelt:
- Verwenden Sie das Cmdlet
Start-CitrixCallHomeUpload
, um ein Diagnoseinformationspaket manuell zu erfassen und nach CIS hochzuladen. (Das Paket wird nicht lokal gespeichert.) - Verwenden Sie das Cmdlet
Start-CitrixCallHomeUpload
, um Daten manuell zu erfassen und ein Diagnoseinformationspaket lokal zu speichern. Auf diese Weise können Sie eine Vorschau der Daten anzeigen. Später können Sie das CmdletSend-CitrixCallHomeBundle
verwenden, um eine Kopie des Pakets manuell nach CIS hochzuladen. (Die ursprünglichen Daten bleiben lokal gespeichert.)
Die PowerShell-Hilfe enthält umfassende Syntax, einschließlich Beschreibungen von Cmdlets und Parametern, die nicht so häufig verwendet werden.
Wenn Sie ein Cmdlet zum Hochladen von Daten nach CIS eingeben, werden Sie aufgefordert, den Upload zu bestätigen. Wenn ein Timeout des Cmdlets erfolgt, bevor der Upload abgeschlossen ist, überprüfen Sie den Status des Uploads im Systemereignisprotokoll. Die Uploadanforderung wird möglicherweise abgelehnt, wenn der Dienst bereits einen Upload ausführt.
Sammeln von Daten und Hochladen des Pakets in CIS:
Start-CitrixCallHomeUpload [-Credential] PSCredential [-InputPath string] [-Description string] [-IncidentTime string] [-SRNumber string] [-Name string] [-UploadHeader string] [-AppendHeaders string] [-Collect string] [<CommonParameters>]
<!--NeedCopy-->
Sammeln von Daten und lokales Speichern:
Start-CitrixCallHomeUpload -OutputPath <String> [-InputPath string] [-Description string] [-IncidentTime string] [-SRNumber string] [-Name string] [-UploaderHeader string] [-AppendHeaders string] [-Collect strings] [<CommonParameters>]
<!--NeedCopy-->
Die folgenden Parameter sind gültig:
- Credential: leitet den Upload nach CIS.
- InputPath: Speicherort der ZIP-Datei, die zum Paket gehört. Das kann eine weitere Datei sein, die Citrix Support benötigt. Stellen Sie sicher, dass die Erweiterung .zip eingeschlossen ist.
- OutputPath: Speicherort, an dem die Diagnoseinformationen gespeichert werden. Dieser Parameter ist erforderlich, wenn Call Home-Daten lokal gespeichert werden.
- Description and Incident Time: Informationen über den Upload.
- SRNumber: Incident-Nummer des technischen Supports von Citrix.
- Name: Name des Pakets.
- UploadHeader: Zeichenfolge im JSON-Format zur Angabe der Uploadheader, die nach CIS hochgeladen werden.
- AppendHeaders: Zeichenfolge im JSON-Format zur Angabe der angefügten Header, die nach CIS hochgeladen werden.
-
Collect: Zeichenfolge im JSON-Format zur Angabe, welche Daten erfasst oder ausgelassen werden, das Format ist {‘collector’:{‘enabled’:Boolean}}, wobei Boolean “true” oder “false” ist. Gültige Datensammelpunktwerte sind:
- ‘wmi’
- ‘process’
- ‘registry
- ‘crashreport’
- ‘trace’
- ‘file’
- ‘msi’
- ‘localdata’
- ‘sitedata’
- ‘sfb’
Standardmäßig sind alle Datensammelpunkte außer “sfb” aktiviert.
Der Datensammelpunkt “sfb” ist für die Verwendung bei Bedarf zur Diagnose von Problemen mit Skype for Business vorgesehen. Neben dem Parameter “enabled” unterstützt sfb die Parameter “account” und “accounts” zur Angabe von Zielbenutzern. Verwenden Sie eines der folgenden Syntaxmuster:
- “-Collect “{‘sfb’:{‘account’:’domain\\user1’}}”
- “-Collect “{‘sfb’:{‘accounts’:[‘domain\\\user1’, ‘domain\\\user2’]}}”
- Allgemeine Parameter: siehe PowerShell-Hilfe.
Hochladen von Daten, die zuvor lokal gespeichert waren:
Send-CitrixCallHomeBundle -Credential <PSCredentia\> -Path string [<CommonParameters>]
Mit dem Parameter Path
geben Sie den Speicherort des zuvor gespeicherten Pakets an.
Beispiele:
Mit dem folgenden Cmdlet wird ein Upload von Call Home-Daten (mit Ausnahme von Daten vom WMI-Datensammelpunkt) nach CIS angefordert. Diese Daten beziehen sich auf Registrierungsfehler bei Citrix Provisioning-VDAs, die um 14:30 Uhr für den Citrix Supportfall 123456 vermerkt wurden. Zusätzlich zu den Call Home-Daten wird die Datei c:\Diagnostics\ExtraData.zip in das Uploadpaket eingeschlossen.
C:\PS>Start-CitrixCallHomeUpload -InputPath "c:\Diagnostics\ExtraData.zip" -Description "Registration failures with Citrix Provisioning VDAs" -IncidentTime "14:30" -SRNumber 123456 -Name "RegistrationFailure-021812016" -Collect "{'wmi':{'enabled':false}}" -UploadHeader "{'key1':'value1'}" -AppendHeaders "{'key2':'value2'}"
<!--NeedCopy-->
Das folgende Cmdlet speichert Call Home-Daten, die sich auf den Citrix Supportfall 223344 beziehen, der um 8:15 Uhr bemerkt wurde. Die Daten werden in der Datei mydata.zip auf einer Netzwerkfreigabe gespeichert. Zusätzlich zu den Call Home-Daten wird die Datei c:\Diagnostics\ExtraData.zip in das gespeicherte Paket eingeschlossen.
C:\PS>Start-CitrixCallHomeUpload -OutputPath \mynetwork\myshare\mydata.zip -InputPath "c:\Diagnostics\ExtraData.zip" -Description "Diagnostics for incident number 223344" -IncidentTime "8:15" -SRNumber 223344
<!--NeedCopy-->
Das folgende Cmdlet lädt das Datenpaket hoch, das Sie zuvor gespeichert haben.
$cred=Get-Credential
C:\PS>Send-CitrixCallHomeBundle –Credential $cred -Path \mynetwork\myshare\mydata.zip
<!--NeedCopy-->