SDKs und APIs
Citrix DaaS Remote PowerShell-SDK
Das Remote PowerShell-SDK automatisiert komplexe und repetitive Aufgaben. Es bietet den Mechanismus zum Einrichten und Verwalten der Citrix DaaS-Umgebung (ehemals Citrix Virtual Apps and Desktops Service), ohne Studio zu verwenden.
- Einzelheiten zu den Cmdlets finden Sie unter Citrix DaaS-SDK.
- Die unterstützten Module sind unter Unterstützung und Einschränkungen aufgeführt. Der Abschnitt enthält zudem eine Liste der in diesem SDK deaktivierten Cmdlets.
- Das Remote PowerShell SDK steht auf der Citrix-Website zum Download zur Verfügung.
Dieses Produkt unterstützt die PowerShell-Versionen 3 bis 7.3.
Hinweis
Derzeit befindet sich die Unterstützung für die Powershell-Version 7.4 in Technical Preview.
Unterschiede zwischen diesem und dem SDK für kundenverwaltete Bereitstellungen
Bei von Administratoren des Kunden installierten und verwalteten Citrix Virtual Apps and Desktops-Bereitstellungen führen die Administratoren Cmdlets und Skripts in einer Site aus, die VDAs und Delivery Controller in einer gemeinsamen Domänenstruktur enthält. Bei Citrix DaaS sind die VDAs und Controller hingegen auf einen Ressourcenstandort und eine Steuerungsebene aufgeteilt. Aufgrund dieser Aufteilung funktioniert das ursprüngliche Citrix Virtual Apps and Desktops PowerShell SDK nicht in einer Citrix DaaS-Umgebung. Es kann die sichere Grenze vom Ressourcenstandort zur Steuerungsebene nicht überqueren.
Die Lösung ist das Citrix DaaS Remote PowerShell-SDK. Wenn das Remote PowerShell-SDK am Ressourcenstandort ausgeführt wird, greift es auf die Steuerungsebene zu als wäre es lokal. Die Funktionalität entspricht der einer einzelnen Citrix Virtual Apps and Desktops-Site. Es gibt nur die niedrigste, nicht sichtbare Kommunikationsschicht, die entweder für den Betrieb in einer einzelnen lokalen Site oder in der Cloudumgebung optimiert ist. Die Cmdlets sind die gleichen und die meisten bestehenden Skripts sind unverändert.
Das Cmdlet Get-XdAuthentication bietet die Berechtigung zum Passieren der Grenze zwischen sicherem Ressourcenstandort und Steuerungsebene. Standardmäßig fordert Get-XdAuthentication die Benutzer zur Eingabe von CAS-Anmeldeinformationen auf, was einmal pro PowerShell-Sitzung erforderlich ist. Alternativ können Benutzer Authentifizierungsprofile mit einem API Access Secure Client definieren, der in der Citrix Cloud-Konsole erstellt wurde. In beiden Fällen bleiben die Sicherheitsinformationen für die Verwendung in nachfolgenden PowerShell-SDK-Aufrufen erhalten. Wenn das Cmdlet nicht explizit ausgeführt wird, wird es vom ersten PowerShell-SDK-Cmdlet aufgerufen.
Voraussetzungen
Um das Remote PowerShell-SDK von Citrix DaaS zu verwenden, setzen Sie die folgenden URLs auf die Positivliste:
Kommerziell
https://*.cloud.comhttps://*.citrixworkspacesapi.net/[customerid]https://[customerid].xendesktop.net:443
Japan
https://*.citrixcloud.jphttps://*.citrixworkspacesapi.jp/[customerid]https://[customerid].apps.citrixworkspacesapi.jp:443
Behörden
hhttps://*.cloud.ushttps://*.citrixworkspacesapi.us/[customerid]https://[customerid].xendesktop.us:443
Installieren und Verwenden des Remote PowerShell SDKs
Anforderungen und Überlegungen:
Hinweis
Installieren Sie das Remote PowerShell SDK nicht auf einer Citrix Cloud Connector-Maschine. Es kann auf jeder in der Domäne eingebundenen Maschine am gleichen Ressourcenstandort installiert werden.
Citrix unterstützt die Ausführung der Cmdlets dieses SDK auf Cloud Connectors nicht. Am SDK-Betrieb sind die Cloud Connectors nicht beteiligt.
Wenn Sie auch eine Bereitstellung von Citrix Virtual Apps and Desktops verwenden (zusätzlich zur Citrix DaaS-Bereitstellung), installieren Sie nicht das Remote PowerShell-SDK auf einer on-premises Delivery Controller-Maschine.
- Installieren Sie Microsoft Edge WebView2.
- Achten Sie darauf, dass PowerShell 3.0, 4.0, 5.0, 6.0 oder 7.0 auf der Maschine verfügbar ist.
- Das SDK-Installationsprogramm lädt .NET Framework 4.8 (oder eine spätere unterstützte Version) herunter und installiert es, sofern es noch nicht installiert ist.
- Wenn auf der Maschine das Citrix Virtual Apps and Desktops-SDK bereits installiert ist, entfernen Sie es (über Windows Programme und Funktionen), bevor Sie das Remote PowerShell-SDK installieren.
- Verwenden Sie für eine automatisierte Umgebung den Parameter
-quiet, um das SDK ohne Benutzereingabe zu installieren.
Installieren des Remote PowerShell SDKs:
- Laden Sie von der Downloadseite das Virtual Apps and Desktops Remote PowerShell SDK herunter.
- Installieren Sie das SDK und führen Sie es aus.
Installationsprotokolle werden in %TEMP%\CitrixLogs\CitrixPoshSdk erstellt. Protokolle können beim Beheben von Installationsproblemen helfen.
Führen Sie das SDK auf einem Computer in der Domäne innerhalb des Ressourcenstandorts aus:
- Öffnen Sie eine PowerShell-Eingabeaufforderung. Das Programm muss nicht als Administrator ausgeführt werden.
- Wenn Sie das Snap-In (anstelle des Moduls) verwenden möchten, fügen Sie das Snap-In mit dem Cmdlet
Add-PSSnapin(oderasnp) hinzu. - Sie können sich explizit über das Cmdlet
Get-XdAuthenticationauthentifizieren. Führen Sie alternativ Ihren ersten Remote PowerShell SDK-Befehl aus, der Sie zur gleichen Authentifizierung wieGet-XdAuthenticationauffordert. Wenn Sie einen Proxy verwenden, müssen Sie sich beim Proxy authentifizieren, um das CmdletGet-XdAuthenticationverwenden zu können. Weitere Informationen finden Sie unter Remote PowerShell SDK mit einem Proxy verwenden. - Um die Authentifizierungsaufforderung zu umgehen, können Sie das Cmdlet
Set-XdCredentialsverwenden, um ein Standardauthentifizierungsprofil zu erstellen, indem Sie einen sicheren Client verwenden, der in der Citrix Cloud-Konsole erstellt wurde. - Fahren Sie mit dem Ausführen von PowerShell-SDK-Cmdlets bzw. -Automatisierungsskripts fort. Sehen Sie ein Beispiel.
Um das Remote PowerShell-SDK zu deinstallieren, wählen Sie im Windows-Feature zum Entfernen oder Ändern von Programmen die Option Citrix Virtual Apps and Desktops Remote PowerShell-SDK. Klicken Sie mit der rechten Maustaste und wählen Sie Deinstallieren. Folgen Sie den Dialogfeldern.
Remote PowerShell-SDK mit einem Proxy verwenden
Wenn Sie einen Proxy verwenden, können Sie das Cmdlet Get-xdAuthentication möglicherweise nicht verwenden, da der Proxy die HTTP-Anforderungen des Cmdlets blockiert.
Es gibt zwei Möglichkeiten, sich beim Proxy zu authentifizieren. Sie können entweder den Parameter ProxyUseDefault oder die Parameter ProxyUsername und proxyPassword verwenden:
-
Der Parameter
ProxyUseDefaultermöglicht die Authentifizierung am Proxy unter Verwendung der Standard-Proxy-Anmeldeinformationen. Beispiel:Get-XdAuthentication -ProxyUseDefault <!--NeedCopy--> -
Die Parameter
ProxyUsernameundProxyPasswordermöglichen die Authentifizierung am Proxy innerhalb der PowerShell-Sitzung. Beispiel:$secureString = ConvertTo-SecureString -String "password" -AsPlainText -Force Get-XdAuthentication -ProxyUsername user1 -ProxyPassword $secureString <!--NeedCopy-->
Hinweis
Sie erhalten eine Fehlermeldung, wenn Sie einen Befehl mit
XDHyp:\im Remote-PowerShell-SDK ausführen. Lösen des Problems:
- Führen Sie einen Befehl mit
Hypaus. Beispiel:Get-HypServiceStatus- Führen Sie einen Befehl mit
XDHyp:\aus. Beispiel:Get-ChildItem XDHyp:\Connections``
Beispielaktivitäten
Zu den häufigen Aktivitäten gehören das Einrichten von Maschinenkatalogen, Anwendungen und Benutzern. Siehe Beispielskript unten.
$users = "xd.local\Domain Users"
$TSVDACatalogName = "TSVDA"
$TSVDADGName = "TSVDA"
$TSVDAMachineName = "xd\ds-tsvda2"
#Create TSVDA Catalog
$brokerUsers = New-BrokerUser -Name $users
$catalog = New-BrokerCatalog -Name $TSVDACatalogName -AllocationType "Random" -Description $TSVDACatalogName -PersistUserChanges "OnLocal" -ProvisioningType "Manual" -SessionSupport "MultiSession" -MachinesArePhysical $true
#Add TSVDA Machine to Catalog
$BrokeredMachine = New-BrokerMachine -MachineName $TSVDAMachineName -CatalogUid $catalog.uid
#Create new desktops & applications delivery group
$dg = New-BrokerDesktopGroup -Name $TSVDADGName -PublishedName $TSVDADGName -DesktopKind "Shared" -SessionSupport "MultiSession" -DeliveryType DesktopsAndApps -Description $TSVDADGName
#Create notepad application
New-BrokerApplication -ApplicationType HostedOnDesktop -Name "Notepad" -CommandLineExecutable "notepad.exe" -DesktopGroup $dg
#Assign users to desktops and applications
New-BrokerEntitlementPolicyRule -Name $TSVDADGName -DesktopGroupUid $dg.Uid -IncludedUsers $brokerUsers -description $TSVDADGName
New-BrokerAccessPolicyRule -Name $TSVDADGName -IncludedUserFilterEnabled $true -IncludedUsers $brokerUsers -DesktopGroupUid $dg.Uid -AllowedProtocols @("HDX","RDP")
New-BrokerAppEntitlementPolicyRule -Name $TSVDADGName -DesktopGroupUid $dg.Uid -IncludedUsers $brokerUsers -description $TSVDADGName
#Add machine to delivery group
Add-BrokerMachine -MachineName $TSVDAMachineName -DesktopGroup $dg
<!--NeedCopy-->
Unterstützung und Einschränkungen
Die folgenden Betriebssysteme werden vom Remote PowerShell SDK unterstützt:
- Windows 11
- Windows 10
- Windows 10 IoT Enterprise LTSC x32 2019
- Windows 10 IoT Enterprise LTSC x64 2019
- Windows 10 IoT Enterprise 21h1 x64
- Windows Server 2022
- Windows Server 2019
- Windows Server 2016
Die folgenden PowerShell-Module von Citrix Virtual Apps and Desktops werden in diesem Release unterstützt:
- Broker
- Active Directory-Identität
- Maschinenerstellung
- Konfiguration
- Konfigurationsprotokollierung
- Host
- Delegierte Administration
- Analytics
Weitere Informationen zu Cmdlets finden Sie unter Citrix Virtual Apps and Desktops SDK.
Nach der Authentifizierung bleibt der Remotezugriff in der aktuellen PowerShell-Sitzung 24 Stunden lang gültig. Nach Ablauf dieser Zeit müssen Sie Ihre Anmeldeinformationen eingeben.
Das Remote PowerShell-SDK muss auf einem Computer im gleichen Ressourcenstandort ausgeführt werden.
Die folgenden Cmdlets sind bei Remotevorgängen deaktiviert, um die Integrität und Sicherheit der Citrix Cloudsteuerungsebene zu gewährleisten.
Citrix.ADIdentity.Admin.V2:
- Copy-AcctIdentityPool
- Get-AcctDBConnection
- Get-AcctDBSchema
- Get-AcctDBVersionChangeScript
- Get-AcctInstalledDBVersion
- Remove-AcctServiceMetadata
- Reset-AcctServiceGroupMembership
- Set-AcctDBConnection
- Set-AcctServiceMetadata
- Set-AcctADAccountUserCert
- Test-AcctDBConnection
Citrix.Analytics.Admin.V1:
- Get-AnalyticsDBConnection
- Get-AnalyticsDBSchema
- Get-AnalyticsDBVersionChangeScript
- Get-AnalyticsInstalledDBVersion
- Import-AnalyticsDataDefinition
- Remove-AnalyticsServiceMetadata
- Reset-AnalyticsServiceGroupMembership
- Set-AnalyticsDBConnection
- Set-AnalyticsServiceMetadata
- Set-AnalyticsSite
- Set-AnalyticsDBConnection
Citrix.DelegatedAdmin.Admin.V1:
- Add-AdminRight
- Get-AdminDBConnection
- Get-AdminDBSchema
- Get-AdminDBVersionChangeScript
- Get-AdminInstalledDBVersion
- Import-AdminRoleConfiguration
- New-AdminAdministrator
- Remove-AdminAdministrator
- Remove-AdminAdministratorMetadata
- Remove-AdminRight
- Remove-AdminServiceMetadata
- Reset-AdminServiceGroupMembership
- Set-AdminAdministrator
- Set-AdminAdministratorMetadata
- Set-AdminDBConnection
- Set-AdminServiceMetadata
- Test-AdminDBConnection
Citrix.Broker.Admin.V2:
- Get-BrokerDBConnection
- Get-BrokerDBSchema
- Get-BrokerDBVersionChangeScript
- Get-BrokerInstalledDBVersion
- Get-BrokerLease
- Get-BrokerController
- New-BrokerMachineConfiguration
- Remove-BrokerControllerMetadata
- Remove-BrokerLease
- Remove-BrokerLeaseMetadata
- Remove-BrokerMachineConfigurationMetadata
- Remove-BrokerMachineConfiguration
- Remove-BrokerSiteMetadata
- Remove-BrokerUserFromApplication
- Reset-BrokerLicensingConnection
- Reset-BrokerServiceGroupMembership
- Set-BrokerControllerMetadata
- Set-BrokerDBConnection
- Set-BrokerLeaseMetadata
- Set-BrokerMachineConfiguration
- Set-BrokerMachineConfigurationMetadata
- Set-BrokerSiteMetadata
- Test-BrokerDBConnection
- Test-BrokerLicenseServer
- Update-BrokerBrokerLocalLeaseCache
Citrix.Configuration.Admin.V2:
- Export-ConfigFeatureTable
- Get-ConfigDBConnection
- Get-ConfigDBSchema
- Get-ConfigDBVersionChangeScript
- Get-ConfigInstalledDBVersion
- Get-ConfigServiceGroup
- Import-ConfigFeatureTable
- Register-ConfigServiceInstance
- Remove-ConfigRegisteredServiceInstanceMetadata
- Remove-ConfigServiceGroup
- Remove-ConfigServiceGroupMetadata
- Remove-ConfigServiceMetadata
- Remove-ConfigSiteMetadata
- Reset-ConfigServiceGroupMembership
- Set-ConfigDBConnection
- Set-ConfigRegisteredServiceInstance
- Set-ConfigRegisteredServiceInstanceMetadata
- Set-ConfigServiceGroupMetadata
- Set-ConfigServiceMetadata
- Set-ConfigSite
- Set-ConfigSiteMetadata
- Test-ConfigDBConnection
- Unregister-ConfigRegisteredServiceInstance
Citrix.Host.Admin.V2:
- Get-HypDBConnection
- Get-HypDBSchema
- Get-HypDBVersionChangeScript
- Get-HypInstalledDBVersion
- Remove-HypServiceMetadata
- Reset-HypServiceGroupMembership
- Set-HypDBConnection
- Set-HypServiceMetadata
- Test-HypDBConnection
Citrix.ConfigurationLogging.Admin.V1:
- Get-LogDBConnection
- Get-LogDBSchema
- Get-LogDBVersionChangeScript
- Get-LogInstalledDBVersion
- Remove-LogOperation
- Remove-LogServiceMetadata
- Remove-LogSiteMetadata
- Reset-LogDataStore
- Reset-LogServiceGroupMembership
- Set-LogDBConnection
- Set-LogServiceMetadata
- Set-LogSite
- Set-LogSiteMetadata
- Test-LogDBConnection
Citrix.MachineCreation.Admin.V2:
- Get-ProvDBConnection
- Get-ProvDBSchema
- Get-ProvDBVersionChangeScript
- Get-ProvInstalledDBVersion
- Get-ProvServiceConfigurationData
- Remove-ProvServiceConfigurationData
- Remove-ProvServiceMetadata
- Reset-ProvServiceGroupMembership
- Set-ProvDBConnection
- Set-ProvServiceMetadata
- Test-ProvDBConnection
Citrix.EnvTest.Admin.V1:
- Get-EnvTestDBConnection
- Get-EnvTestDBSchema
- Get-EnvTestDBVersionChangeScript
- Get-EnvTestInstalledDBVersion
- Remove-EnvTestServiceMetadata
- Reset-EnvTestServiceGroupMembership
- Set-EnvTestDBConnection
- Set-EnvTestServiceMetadata
- Test-EnvTestDBConnection
Citrix.Monitor.Admin.V1:
- Get-MonitorConfiguration
- Get-MonitorDBConnection
- Get-MonitorDBSchema
- Get-MonitorDBVersionChangeScript
- Get-MonitorDataStore
- Get-MonitorDataStore
- Get-MonitorInstalledDBVersion
- Remove-MonitorServiceMetadata
- Reset-MonitorDataStore
- Reset-MonitorServiceGroupMembership
- Set-MonitorConfiguration
- Set-MonitorDBConnection
- Set-MonitorServiceMetadata
- Test-MonitorDBConnection
Citrix.Storefront.Admin.V1:
- Build-SfCluster
- Get-SfClusters
- Get-SfDBConnection
- Get-SfDBSchema
- Get-SfDBVersionChangeScript
- Get-SfInstalledDBVersion
Citrix DaaS-Discoverymodul für App-V-Pakete und Server
Citrix DaaS kann Anwendungen in App-V-Paketen mit einer der folgenden Methoden für die Endpunkte bereitstellen:
- Methode der Einzelverwaltung (Zugriff auf Pakete von einer Netzwerkfreigabe)
- Methode der dualen Verwaltung (Zugriff auf Pakete von einem Microsoft App-V-Verwaltungsserver)
Das Registrieren von App-V-Paketen und Microsoft App-V-Verwaltungsservern und -Veröffentlichungsservern bei der Anwendungsbibliothek über Citrix DaaS unterscheidet sich geringfügig von der Registrierung über eine On-Premises-Bereitstellung. Das Zuweisen von Anwendungen für Benutzer und Starten auf dem Endpunkt eines Benutzers ist jedoch identisch.
Die Citrix DaaS-Verwaltungskonsole in Citrix Cloud kann keine Dateien an einem Ressourcenstandort anzeigen. Außerdem kann sie App-V-Pakete oder Microsoft App-V-Server in Ihrer Infrastruktur nicht direkt ermitteln. Das Discoverymodul bietet Funktionen, mit denen App-V-Paketinformationen in Ihrer On-Premises-Infrastruktur ermittelt und in Citrix DaaS hochgeladen werden. Dabei handelt es sich um App-V-Pakete, Microsoft App-V-Server und die Apps, die in den Paketen enthalten sind.
Das Discoverymodul verwendet das Virtual Apps and Desktops Remote PowerShell-SDK. Er kann Paketinformationen in einer Netzwerkfreigabe oder auf einem Microsoft App-V-Verwaltungsserver ermitteln. Sie verwenden das Discoverymodul auf einer Maschine an Ihrem Ressourcenstandort.
Voraussetzungen für die Verwendung des Discoverymoduls:
- Vergewissern Sie sich, dass auf der Maschine PowerShell 3.0 oder höher verfügbar ist.
- Vergewissern Sie sich, dass das Citrix Virtual Apps and Desktops Remote PowerShell SDK auf der Maschine installiert ist.
- Vergewissern Sie sich, dass Sie Lesezugriff auf die Netzwerkfreigabe mit den App-V-Paketen haben.
- Vergewissern Sie sich, dass Sie Zugriff auf den Server haben, auf dem die Citrix Cloud Connectors installiert sind und der Microsoft App-V-Verwaltungsserver gehostet wird.
Hinzufügen von App-V-Paketen zur Anwendungsbibliothek in der Citrix Cloud
Das folgende Verfahren gilt für das Hinzufügen von App-V-Paketen aus Netzwerkfreigaben (Einzelverwaltung) und für das Hinzufügen aller veröffentlichten App-V-Pakete vom Microsoft App-V-Verwaltungsserver (duale Verwaltung). Bei der dualen Verwaltung müssen Sie die hinzugefügten App-V-Pakete genauso verwalten, wie bei der Einzelverwaltung.
-
Laden Sie das Discovery-Modul von der Citrix DaaS-Downloadseite https://www.citrix.com/downloads/citrix-cloud/product-software/xenapp-and-xendesktop-service.html herunter. Extrahieren Sie die ZIP-Datei
Citrix.Cloud.AppLibrary.Admin.v1.psm1in einen geeigneten Ordner.Hinweis
Diese Datei wird auch auf Citrix Virtual Apps and Desktops-ISO in
Support\TTools\ Scriptsbereitgestellt. Sie können sie lokal kopieren oder direkt vom CD-Laufwerk referenzieren. -
Sicherstellen, dass das Citrix Virtual Apps and Desktops Remote PowerShell-SDK auf der Maschine installiert ist
-
Navigieren Sie zu dem Ordner mit dem Discoverymodul Geben Sie im PowerShell-Fenster den vollständigen Pfad des Ordners mit dem Discoverymodul ein und drücken Sie die Eingabetaste.
-
Importieren Sie das Discovery-Modul mit dem Befehl
Import-Module.\Citrix.Cloud.AppLibrary.Admin.v1.psm1. -
Fügen Sie App-V-Pakete mit einer der folgenden Methoden zur Anwendungsbibliothek in der Citrix Cloud hinzu.
-
Um App-V-Pakete von einer Netzwerkfreigabe hinzuzufügen, führen Sie das PowerShell-Cmdlet aus:
Import-AppVPackageToCloud.Beispiel:
Import-AppVPackageToCloud –PackagePath \\AppVSrv\share\Notepad++.appvGeben Sie
Get-Help Import-AppVPackageToCloudein, um die Cmdlet-Hilfe zu erhalten. -
Um App-V-Pakete von einem Microsoft App-V Management Server hinzuzufügen, führen Sie das PowerShell-Cmdlet
Import-AppVPackagesFromManagementServerToCloudaus.Beispiel:
Import-AppVPackagesFromManagementServerToCloud –ManagementSrvFQDN AppVMngSrv.domain.localGeben Sie
Get-Help Import-AppVPackagesFromManagementServerToCloudein, um Hilfe für Cmdlets zu erhaltenMit diesem Befehl werden alle veröffentlichten App-V-Pakete vom Microsoft App-V-Verwaltungsserver in Citrix Cloud importiert.
Wenn Sie die App-V-Pakete zu Citrix Cloud hinzugefügt haben, müssen Sie sie wie bei der Einzelverwaltungsmethode verwalten.
-
-
Melden Sie sich bei Citrix Cloud an. Wählen Sie den Zielkunden aus. Durch die Ausführung des Skripts werden die App-V-Pakete der Anwendungsbibliothek in Citrix Cloud hinzugefügt.
Allgemeine PowerShell-Funktionen
Das Modul enthält die folgenden High-Level-Funktionen, die Sie aus Ihrem eigenen PowerShell-Skript aufrufen können:
-
Import-AppVPackageToCloud -PackagePath <Full UNC path to App-V package>Discovery und Upload aller Informationen, die zum Veröffentlichen von Anwendungen aus einem einzigen App-V-Paket erforderlich sind, an Citrix DaaS.
-
Import-AppVPackagesFromManagementServerToCloud -ManagementSrvFQDN <FQDN of a Microsoft App-V Management Server>Führt die Discovery der UNC-Pfade der Pakete durch, die vom Management Server veröffentlichten wurden. Anschließend wird Import-AppVPackageToCloud nacheinander für jedes Paket aufgerufen.
Auf diese Weise erkannte Pakete werden mit der Einzelverwaltungsmethode in Citrix DaaS geladen. Citrix DaaS kann keine Pakete mit der Dualverwaltungsmethode bereitstellen.
-
Import-AppVDualAdminToCloud -ManagementSrvUrl <URL of a Microsoft App-V Management Server> -PublishingServerUrl <URL of a Microsoft App-V Publishing Server>Erkennt Microsoft App-V-Verwaltungsserver und -Veröffentlichungsserver und importiert den Inhalt zur Anwendungsbibliothek. Mit diesem Cmdlet werden alle mit Microsoft App-V-Verwaltungsserver verwalteten Pakete sowie zugehörige Informationen importiert. Server können über PowerShell hinzugefügt und entfernt werden.
Das Cmdlet fügt App-V-Pakete im Dualverwaltungsmodus hinzu. Es werden nur App-V-Pakete importiert, die auf dem Microsoft App-V-Verwaltungsserver veröffentlicht werden und denen AD-Gruppen hinzugefügt wurden. Wenn Sie Änderungen am Microsoft App-V-Verwaltungsserver vornehmen, führen Sie des Cmdlet erneut aus, um die Anwendungsbibliothek mit dem Microsoft App-V-Verwaltungsserver zu synchronisieren.
-
Remove-AppVServerFromCloud -ManagementSrvUrl <URL of a Microsoft App-V Management Server> -PublishingServerUrl <URL of a Microsoft App-V Publishing Server>Entfernt die zur Anwendungsbibliothek hinzugefügten Microsoft App-V-Verwaltungsserver und -Veröffentlichungsserver.
Mit diesem Cmdlet werden die angegebenen Microsoft App-V Verwaltungsserver und -Veröffentlichungsserver sowie alle zugehörigen App-V-Pakete entfernt.
Führen Sie das Discoverymodul für App-V-Pakete und Server auf einem Domänencomputer innerhalb des Ressourcenstandorts aus. Folgen Sie den Anweisungen unter Installieren und Verwenden des Remote PowerShell SDKs, um zu beginnen. Fahren Sie mit dem Ausführen von PowerShell-Cmdlets bzw. -Skripts fort. Siehe die folgenden Beispiele.
Beispielaktivitäten
Importieren Sie das App-V-Paketdiscoverymodul für Citrix DaaS.
import-module "D:\Support\Tools\Scripts\Citrix.Cloud.AppLibrary.Admin.v1.psm1"
<!--NeedCopy-->
Durchlaufen Sie das App-V-Paketspeicherverzeichnis und laden Sie jedes Paket hoch.
Get-ChildItem -Path "\\FileServer.domain.net\App-V Packages" -Filter *.appv |
Foreach-Object{
Import-AppVPackageToCloud -PackagePath $_.FullName
}
<!--NeedCopy-->
Führen Sie eine Discovery und einen Upload von Paketen aus, die bei einem Microsoft App-V-Verwaltungsserver registriert sind.
Import-AppVPackagesFromManagementServerToCloud -ManagementSrvFQDN AppVManagementServer.domain.net
<!--NeedCopy-->
Führen Sie eine Discovery von Microsoft App-V-Verwaltungsservern und -Veröffentlichungsservern aus und fügen Sie die Konfiguration zur Anwendungsbibliothek hinzu. Dabei werden auch alle vom Microsoft App-V-Verwaltungsserver verwalteten Pakete im Dualverwaltungsmodus importiert.
Import-AppVDualAdminCloud -ManagementSrvUrl http://AppVManagementServer.domain.net –PublishingServerUrl http://AppVManagementServer.domain.net:8001
<!--NeedCopy-->
Lesen Sie die zum Modul gehörende PowerShell-Hilfedokumentation.
Get-Help Import-AppVPackageToCloud
<!--NeedCopy-->
Einschränkungen
- Die Discovery von App-V-Paketen in Ihrer Ressourcenstandortinfrastruktur kann nicht direkt über die Citrix DaaS-Verwaltungskonsole in Citrix Cloud erfolgen. Weitere Informationen zu Citrix Cloud finden Sie in der Dokumentation zu Citrix Cloud.
- Die Citrix DaaS-Verwaltungskonsole in Citrix Cloud hat keine Liveverbindung zum Microsoft App-V-Verwaltungsserver. Änderungen an Paketen und anderen Konfigurationen auf dem Microsoft App-V Management Server werden erst in der Citrix DaaS Management Console widergespiegelt, wenn
Import-AppVDualAdminClouderneut ausgeführt wird.
Monitor Service OData API
Zusätzlich zur Anzeige von Verlaufsdaten über die Überwachungsfunktionen können Sie Daten mit der API des Überwachungsdiensts abfragen. Verwenden Sie die API für Folgendes:
- Analysieren historischer Trends für die Planung
- Durchführen einer eingehenden Problembehandlung bei Verbindungs- und Maschinenfehlern
- Extrahieren von Informationen für die Eingabe in andere Tools und Prozesse, z. B. wenn PowerPivot-Tabellen in Microsoft Excel für die Anzeige von Daten auf verschiedene Weise verwendet werden
- Erstellen einer benutzerdefinierten Benutzeroberfläche auf der Basis der von der API bereitgestellten Daten
Weitere Informationen finden Sie unter Monitor Service OData API. Informationen zum Zugriff auf die Monitor Service API finden Sie unter Access Monitor Service data using the OData v4 endpoint in Citrix Cloud.
Citrix DaaS APIs
Die Citrix DaaS-APIs sind unter https://developer.cloud.com/citrixworkspace/citrix-daas verfügbar.
Haftungsausschluss
Diese Software bzw. der Mustercode wird wie besehen und ohne Zusicherungen, Gewährleistungen und Bedingungen zur Verfügung gestellt. Verwendung, Modifizierung und Verteilung erfolgen auf eigene Gefahr. CITRIX SCHLIESST SÄMTLICHE AUSDRÜCKLICHEN, STILLSCHWEIGENDEN, GESETZLICHEN ODER ANDERWEITIGEN GEWÄHRLEISTUNGEN AUS. HIERZU ZÄHLEN U. A. DIE HAFTUNG FÜR RECHTSMÄNGEL, DIE GEWÄHRLEISTUNG DER MARKTGÄNGIGKEIT UND DER EIGNUNG FÜR EINEN BESTIMMTEN ZWECK, DIE RECHTSGEWÄHRLEISTUNG UND DIE GEWÄHRLEISTUNG DER NICHTVERLETZUNG. Unbeschadet der Allgemeingültigkeit des vorstehend Gesagten anerkennen Sie und erklären sich einverstanden, dass (a) die Software bzw. der Mustercode Fehler, Mängel oder andere Probleme aufweisen kann, die zu Datenverlusten oder Eigentumsbeschädigung führen können, (b) es ggf. nicht möglich ist, die Software bzw. den Mustercode vollfunktional zu verwenden und (c) Citrix ohne Ankündigung und oder Haftung die aktuelle Version und/oder zukünftige Versionen die Software bzw. des Mustercodes zurückziehen kann. Die Software bzw. der Mustercode darf unter keinen Umständen im Rahmen risikobehafteter Aktivitäten, zum Beispiel bei der Lebenserhaltung oder für Sprengungen, eingesetzt werden. CITRIX UND VON CITRIX ABHÄNGIGE UNTERNEHMEN SOWIE REPRÄSENTANTEN VON CITRIX ÜBERNEHMEN IM RAHMEN VERTRAGLICHER VERPFLICHTUNGEN ODER JEGLICHER ANDERER HAFTUNGSTHEORIE KEINERLEI HAFTUNG FÜR SCHÄDEN, DIE DURCH DIE VERWENDUNG DER SOFTWARE BZW. DES MUSTERCODES ENTSTEHEN. DAZU GEHÖREN DIREKTE UND SPEZIELLE SCHÄDEN, NEBENSCHÄDEN, SCHADENSERSATZ MIT STRAFWIRKUNG, FOLGESCHÄDEN UND ANDERE SCHÄDEN, SELBST WENN AUF DIE MÖGLICHKEIT SOLCHER SCHÄDEN HINGEWIESEN WURDE. Sie erklären sich damit einverstanden, Citrix gegen jegliche Ansprüche, die aus einer Verwendung, Modifikation oder Verteilung des Codes durch Sie entstehen, zu verteidigen und schadlos zu halten.