Introduktion til installaationswebtjenesten
Udgivet: januar 2017
Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Installationstjeneste giver dig mulighed for at oprette løsninger, så du kan drage fordel af understøttelse af flere organisationer – også kaldet understøttelse af flere brugere.Microsoft Dynamics 365 giver dig mulighed for at være vært for flere kundeorganisationer i en enkelt installation. Denne funktion er en stor fordel for værtsbaserede løsninger eller virksomheder, der kræver, at data i organisationen er adskilt. Da det at bruge installationstjenesten kræver adgang til Dynamics 365-serveren, kan den kun bruges til lokale Microsoft Dynamics 365-installationer.
Med understøttelse af flere organisation understøtter Microsoft Dynamics 365-webprogrammet og webtjenester lagring og hentning af data på tværs af flere virksomhedsorganisationer, samtidig med at sikkerhed og beskyttelse af personlige oplysninger for hver enkelt organisation opretholdes. En enkel Microsoft Dynamics 365-konfigurationsdatabase lagrer oplysninger om metadata og lokation for alle kundeorganisationer. Hver kundeorganisation har imidlertid sin egen database på en server, der kører Microsoft SQL Server. Du kan få yderligere oplysninger om objekter og konfigurationsindstillinger styres af installationstjenesten i Indstillinger for installationsobjekter og installationskonfiguration.
Microsoft Dynamics 365 understøtter ikke et bagudkompatibelt slutpunkt til installationstjenesten, så skal enhver kode, der er skrevet til installationstjenesten Microsoft Dynamics CRM 4.0 være opdateret og kompileres med den nye assembly.
Føj installationstjenesten til dit projekt
Du kan bruge installationstjenesten ved at føje en reference til samlingen Microsoft.Xrm.Sdk.Deployment.dll, som du kan finde i mappen SDK\bin. Du kan evt. føje følgende servicereference til din løsning.
http://myservername/xrmdeployment/2011/deployment.svc
svcutil.exe http:// myservername/XRMDeployment/2011/Deployment.svc?wsdl
Der oprettes en konfigurationsfil og en kodefil, der indeholder klientklassen. Føj disse to filer til klientprogrammet, og brug den oprettede klientklasse til at kalde servicen.
Installation af installationstjeneste
Til at udføre kald mod Microsoft Dynamics 365-installationsobjekter skal serverrollen Installationstjeneste være korrekt installeret på en Microsoft Dynamics 365-server. Sørg for, at følgende kriterier er opfyldt i installationen Installationstjeneste:
Hvis du vil bruge organisationshandlingerne f.eks oprette eller opgradere, skal du installere serverrollen Installationstjeneste vha. en domænebruger. Domænebrugerkontoen skal have rettigheder som lokal administrator og systemadministrator på SQL Server, som skal være vært for organisationsdatabaser.
Installationstjeneste skal køres med en anden serviceidentitet end de andre Microsoft Dynamics 365-services og programservere. Hvis du bruger Netværkstjeneste, skal serverrollen være installeret på en separat server alene uden andre Microsoft Dynamics 365-serverroller installeret. Hvis du installere rollen Installationstjeneste sammen med andre serverroller, kan medføre sikkerhedsrisici, fordi begge servere kører under kontoen Netværkstjeneste. Hvis du bruger kontoen Netværkstjeneste, kan du ikke udføre organisationshandlinger ved at bruge Windows PowerShell eller installationswebtjenesten.
Du kan finde flere oplysninger om installation af udrulningstjenesten under Microsoft Dynamics CRM-serverroller.
Microsoft Dynamics 365 består af to primære serverkomponenter: Microsoft Dynamics 365-programserveren og Microsoft Dynamics 365-serveren. Hver indeholder en separat gruppe af serverroller, der installeres, når installationsprogrammet køres. Rollen Installationstjeneste installeres automatisk, når du bruger guiden Installation til at installere Microsoft Dynamics 365-platformserveren.
Godkendelse af installationsservice og repræsentation
Godkendelse af Installationstjeneste håndteres via Active Directory, der er også kaldes Windows-integreret godkendelse. Du kan også bruge repræsentation, som gør det muligt at kalde webtjenestemetoderne på vegne af en anden bruger, der er godkendt til at levere en ønsket funktion eller tjeneste. Hvis du vil kalde installationswebtjeneste, skal du være Microsoft Dynamics 365-installationsadministrator. Du kan finde flere oplysninger under Tilføj en installationsadministrator.
I følgende eksempel vises, hvordan du kan bruge klassen ProxyClientHelper til at godkende og bruge installationstjenesten vha. standardlegitimationsoplysninger.
DeploymentServiceClient service = Microsoft.Xrm.Sdk.Deployment.Proxy.ProxyClientHelper.CreateClient(new Uri("http://MyServerName/XRMDeployment/2011/Deployment.svc"));
RetrieveAllRequest request = new RetrieveAllRequest()
{
EntityType = DeploymentEntityType.DefaultOrganization};
RetrieveAllResponse response = (RetrieveAllResponse) service.Execute(request);
}
Microsoft Dynamics 365 webtjenester kan kaldes af forskellige klienter og tjenester på vegne af en Microsoft Dynamics 365-bruger. Hvert kald skal være et godkendt kald. Repræsentation bruges til at udføre et kald på vegne af en godkendt Microsoft Dynamics 365-bruger. Når du bruger repræsentation, kan du undgå problemer med godkendelse og autorisation i webtjenestekoden (ASP.NET). I stedet skal du bruge IIS (Internet Information Services) til at godkende brugeren og videregive et token, der er godkendt til webtjenesten. Hvis brugeren ikke kan godkendes, sender IIS et ikke-godkendt token.
I følgende eksempel vises, hvordan du anvender repræsentation med installationstjenesten.
DeploymentServiceClient service = Microsoft.Xrm.Sdk.Deployment.Proxy.ProxyClientHelper.CreateClient(new Uri("http://myservername/XRMDeployment/2011/Deployment.svc"));
service.ClientCredentials.Windows.ClientCredential = new NetworkCredential("administrator", "myp@ssword!", "myservernamedom");
RetrieveAllRequest request = new RetrieveAllRequest()
{
EntityType = DeploymentEntityType.DefaultOrganization};
RetrieveAllResponse response = (RetrieveAllResponse) service.Execute(request);
}
Installationstjenestemuligheder
Installationstjenesten følger en udviklingsmodel, der svarer til den vigtigste Microsoft Dynamics 365-webtjeneste. Der er objekter, metoder og meddelelser, som du bruger til at kommunikere med installationstjenesten. Du kan finde flere oplysninger om den vigtigste Microsoft Dynamics 365-webtjeneste i Brug Microsoft Dynamics 365 tjenester i kode.
Der er to typer objekter for installationstjenesten: installationsobjekter og installationskonfigurationsindstillinger. Begge får adgang til det samme sæt af metoder. Du kan få flere oplysninger om disse objekter i Indstillinger for installationsobjekter og installationskonfiguration.
Ud over kerneinstallationsobjekterne giver installationstjenesten mulighed for at læse og redigere avancerede indstillinger, der drives af metadata. Disse avancerede indstillinger giver adgang til oplysninger, der er gemt i konfigurationsdatabasen.
Installationstjenesten understøtter både synkrone og asynkrone meddelelser for metoden Execute. Du kan finde flere oplysninger under Meddelelse til udrulning af webtjeneste.
I følgende tabel vises de metoder, der er tilgængelige i installationstjenesten.
Metodenavn |
Beskrivelse |
|---|---|
Sletter en post fra et installationsobjekt. |
|
Udfører en anmodning for installationstjenesten. Du kan finde flere oplysninger under Meddelelse til udrulning af webtjeneste. |
|
Henter en post fra et installationsobjekt eller installationskonfigurationsindstillinger. |
|
Henter alle poster fra et installationsobjekt eller installationskonfigurationsindstillinger. |
|
Opdaterer en post fra et installationsobjekt eller installationskonfigurationsindstillinger. |
Se også
IDeploymentService
Microsoft.Xrm.Sdk.Deployment.Proxy
ProxyClientHelper
Administrer udrulning ved hjælp af udrulningswebtjenesten
Indstillinger for installationsobjekter og installationskonfiguration
Meddelelse til udrulning af webtjeneste
Microsoft Dynamics 365
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret