pac admin
Mit Ihrem Power Platform-Administratorkonto arbeiten
Befehle
Command | Eigenschaft |
---|---|
Pac-Admin-Anwendungsliste | Microsoft Entra ID-Anwendungen auflisten, die unter Ihrem Mandanten registriert sind. |
PAC-Admin-Anwendungsregister | Microsoft Entra ID-Anwendung bei Ihrem Mandanten registrieren. |
Abmelden der Pac-Admin-Anwendung | Die Registrierung der Microsoft Entra ID-Anwendung bei Ihrem Mandanten aufheben. |
Pac-Admin-Zuweisungsgruppe | Weisen Sie einer Dataverse-Zielumgebung Gruppen mit angegebenen Sicherheitsrollen zu. |
Pac-Admin: Benutzer zuweisen | Weisen Sie einer Dataverse-Zielumgebung Benutzer mit angegebenen Sicherheitsrollen zu. |
PAC-Admin-Backup | Ihre Umgebung wird hiermit manuell gesichert. |
Pac-Admin-Kopie | Kopieren Sie die Quellumgebung in eine Zielumgebung. |
Pac-Admin erstellen | Erstellt eine Dataverse-Instanz in Ihrem Mandanten. |
Pac-Admin erstellt Service-Principal | Fügen Sie der Dataverse-Umgebung die Microsoft Entra-ID-Anwendung und den zugehörigen Anwendungsbenutzer hinzu. |
Pac-Admin löschen | Löscht die Umgebung aus Ihrem Mandanten. |
Pac-Admin-Liste | Führt alle Umgebungen aus Ihrem Mandanten auf. |
Pac-Admin-Liste-App-Vorlagen | Listet alle unterstützten Dataverse-Vorlagen von modellgesteuerten Apps in Dynamics 365 auf. |
Pac-Admin-Liste – Backups | Listet alle Sicherungen Ihrer Umgebung auf. |
pac-Admin-Liste-Dienstprinzipal | Listen Sie Microsoft Entra-ID-Anwendungen mit Zugriff auf Dataverse auf. |
PAC-Administratorliste – Mandanteneinstellungen | Mandanteneinstellungen auflisten. |
Pac-Admin-Zurücksetzung | Setzt die Umgebung aus Ihrem Mandanten zurück. |
Pac-Admin-Wiederherstellung | Stellt eine Umgebung für eine bestimmte Sicherung wieder her. |
Pac-Admin legt Aufbewahrungszeitraum für Backups fest | Legt den Aufbewahrungszeitraum zur Sicherung in Tagen wie angegeben fest. Gültige Werte sind: 7, 14, 21 und 28. |
Pac-Administrator-Set-Governance-Konfiguration | Verwaltete Umgebungen aktivieren, deaktivieren und bearbeiten |
Pac-Admin setzt Laufzeitstatus | Modus der Umgebungsverwaltung aktualisieren. |
Pac-Administratorstatus | Mit diesem Befehl wird der Status aller in Bearbeitung befindlichen Vorgänge aufgeführt. |
Pac-Admin aktualisiert Mandanteneinstellungen | Mandanteneinstellungen aktualisieren. |
Liste der Pac-Administratoranwendungen
Microsoft Entra ID-Anwendungen auflisten, die unter Ihrem Mandanten registriert sind.
Registrieren der Pac-Administratoranwendungen
Microsoft Entra ID-Anwendung bei Ihrem Mandanten registrieren.
Erforderliche Parameter für das Admin-Anwendungsregister
--application-id
-id
Anwendungs-ID
Registrierung aufheben der Pac-Administratoranwendungen
Die Registrierung der Microsoft Entra ID-Anwendung bei Ihrem Mandanten aufheben.
Erforderliche Parameter für Registrierung aufheben der Admin-Anwendung
--application-id
-id
Anwendungs-ID
PAC Administrator-Zuweisungsgruppe
Weisen Sie einer Dataverse-Zielumgebung Gruppen mit angegebenen Sicherheitsrollen zu.
Erforderliche Parameter für die Administratorzuweisungsgruppe
--group
-g
Objekt-ID der Microsoft Entra-ID der Gruppe, die der Dataverse-Zielumgebung zugewiesen werden soll.
--group-name
-gn
Name der Gruppe oder des Teams, die/das in Dataverse erstellt werden soll.
--membership-type
-mt
Typ der Teammitgliedschaft.
Verwenden Sie einen dieser Werte:
MembersAndGuests
Members
Owners
Guests
--role
-r
Name oder ID der Sicherheitsrolle, die auf den Benutzer angewendet werden soll
--team-type
-tt
Typ des Teams.
Verwenden Sie einen dieser Werte:
Owner
Access
AadSecurityGroup
AadOfficeGroup
Optionale Parameter für die Administratorzuweisungsgruppe
--business-unit
-bu
ID der Unternehmenseinheit, der der Anwendungsbenutzer zugeordnet werden soll.
--environment
-env
ID oder URL der Umgebung, der ein Benutzer zugewiesen werden soll.
pac admin assign-user
Weisen Sie einer Dataverse-Zielumgebung Benutzer mit angegebenen Sicherheitsrollen zu.
Beispiele
Die folgenden Beispiele zeigen die Verwendung des pac admin assign-user
Befehls.
- Weisen Sie einen Benutzer per E-Mail einem Umgebung mit der grundlegenden Benutzerrolle zu
- Weisen Sie einen Benutzer per GUID einem Umgebung mit der Systemrolle Administrator zu und fügen Sie den Benutzer einer angegebenen Geschäftseinheit hinzu
- Weisen Sie einem Umgebung einen Anwendungsbenutzer mit der Systemrolle Administrator zu.
Einen Benutzer per E-Mail einer Umgebung mit der Basisbenutzerrolle zuweisen
pac admin assign-user `
--environment 00000000-0000-0000-0000-000000000000 `
--user "user@company.com" `
--role "Basic User"
Weisen Sie einen Benutzer per GUID einer Umgebung mit der Systemrolle Administrator zu und fügen Sie den Benutzer einer bestimmten Geschäftseinheit hinzu
pac admin assign-user `
--environment 00000000-0000-0000-0000-000000000000 `
--user 00000000-0000-0000-0000-000000000000 `
--business-unit` 00000000-0000-0000-0000-000000000000 `
--role "System Administrator"
Einen Anwendungsbenutzer einer Umgebung mit der Systemadministratorrolle zuweisen
pac admin assign-user `
--environment 00000000-0000-0000-0000-000000000000 `
--user 00000000-0000-0000-0000-000000000000 `
--role "System Administrator"
--application-user
Erforderliche Parameter für den Administratorzuweisungsbenutzenden
--role
-r
Name oder ID der Sicherheitsrolle, die auf den Benutzer angewendet werden soll
--user
-u
Objekt-ID oder Prinzipalname des Benutzers (UPN) des Microsoft Entra-ID-Benutzers, der der Umgebung oder Anwendungs-ID zugewiesen werden soll, wenn ein Anwendungsbenutzer zugewiesen wird.
Optionale Parameter für den Administratorzuweisungsbenutzenden
--application-user
-au
Gibt an, ob der Eingabebenutzer ein Anwendungsbenutzer ist. Wenn keine Unternehmenseinheit angegeben ist, wird der Anwendungsbenutzende der authentifizierten Benutzerunternehmenseinheit hinzugefügt.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--async
-a
Veraltet: Dieser Parameter wird ignoriert.
--business-unit
-bu
ID der Unternehmenseinheit, der der Anwendungsbenutzer zugeordnet werden soll.
--environment
-env
ID oder URL der Umgebung, der ein Benutzer zugewiesen werden soll.
pac admin backup
Ihre Umgebung wird hiermit manuell gesichert.
Beispiel
Erstellen einer manuellen Sicherung für eine Umgebung
pac admin backup `
--environment 00000000-0000-0000-0000-000000000000 `
--label "Manual Backup October 2022"
Erforderliche Parameter für die Administratorsicherung
--label
-l
Legt die Sicherungsbezeichnung wie angegeben fest.
Optionale Parameter für die Administratorsicherung
--environment
-env
Umgebungs-URL oder ID der Umgebung, die eine Sicherung erfordert.
pac admin copy
Kopieren Sie die Quellumgebung in eine Zielumgebung.
Beispiele
Die folgenden Beispiele zeigen die Verwendung des pac admin copy
Befehls.
- Kopieren Sie ein Umgebung von einer Quelle Umgebung in ein Ziel Umgebung unter Verwendung einer minimalen Kopie
- Kopieren Sie ein Umgebung von einer Quelle Umgebung in ein Ziel Umgebung unter Verwendung einer vollständigen Kopie
Kopieren Sie eine Umgebung mit einer minimalen Kopie aus einer Quellumgebung in eine Zielumgebung
In diesem Beispiel werden Anpassungen und Schemas nur von einer Quellumgebung in eine Zielumgebung kopiert.
pac admin copy `
--name "Environment Name" `
--source-env 00000000-0000-0000-0000-000000000000 `
--target-env 00000000-0000-0000-0000-000000000000 `
--type MinimalCopy
Kopieren Sie eine Umgebung mit einer vollständigen Kopie aus einer Quellumgebung in eine Zielumgebung
In diesem Beispiel wird die komplette Umgebung von einer Quellumgebung in eine Zielumgebung kopiert.
pac admin copy `
--name "Environment Name" `
--source-env 00000000-0000-0000-0000-000000000000 `
--target-env 00000000-0000-0000-0000-000000000000 `
--type FullCopy
Optionale Parameter für das Kopieren des Administrators
--async
-a
Optionales boolesches Argument zum asynchronen Ausführen von pac-Verben, standardmäßig „false“.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--max-async-wait-time
-wt
Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten
--name
-n
Name der Zielumgebung
--skip-audit-data
-sa
Schalter, der angibt, ob Überwachungsdaten übersprungen werden sollen
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--source-env
-se
Umgebungs-URL oder ID der Quellumgebung, die gerade kopiert wird
--target-env
-te
Umgebungs-URL oder ID der Zielumgebung.
--type
-t
Verwenden Sie einen dieser Werte:
MinimalCopy
FullCopy
--json
Gibt die Ausgabe des Befehls als JSON-formatierte Zeichenfolge zurück.
pac admin create
Erstellt eine Dataverse-Instanz in Ihrem Mandanten.
Beispiele
Die folgenden Beispiele zeigen die Verwendung des pac admin create
Befehls.
Einfache Erstellung einer Umgebung
In diesem Beispiel erstellen wir eine Sandbox-Umgebung mit den Standardeinstellungen:
- Währung: USD
- Sprache: Englisch
- Region: Vereinigte Staaten
Wir müssen diese Eigenschaften nicht hinzufügen, da diese Werte die Standardwerte sind.
pac admin create `
--name "Contoso Test" `
--type Sandbox `
--domain ContosoTest
Erweiterte Erstellung einer Umgebung
In diesem Beispiel erstellen wir eine Produktionsumgebung in der Region Europa, wobei die Währung auf Euro und die Sprache auf Englisch eingestellt ist.
Wir müssen die Eigenschaft language nicht hinzufügen, da dies der Standardwert ist.
pac admin create `
--name "Contoso Marketing" `
--currency EUR `
--region europe `
--type Production `
--domain ContosoMarketing
Mithilfe einer Eingabedatei erstellen
In diesem Beispiel erstellen wir dieselbe Umgebung wie unter Erweiterte Erstellung einer Umgebung beschrieben, außer dass wir uns auf Daten in einer JSON-Datei mit dem Namen config.json
beziehen, bei der „config.json“ diese Daten enthält:
{
"name": "Contoso Marketing",
"currency": "EUR",
"region": "europe",
"type": "Production",
"domain": "ContosoMarketing"
}
Verweisen Sie dann auf die Datei, wenn Sie den Befehl pac admin create
verwenden:
pac admin create --input-file C:\config.json
Erforderliche Parameter für das Erstellen des Administrators
--type
-t
Legt den Umgebungstyp fest.
Verwenden Sie einen dieser Werte:
Trial
Sandbox
Production
Developer
Teams
SubscriptionBasedTrial
Optionale Parameter für das Erstellen des Administrators
--async
-a
Optionales boolesches Argument zum asynchronen Ausführen von pac-Verben, standardmäßig „false“.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--currency
-c
Legt die für Ihre Umgebung verwendete Währung fest. [standardmäßig USD]
--domain
-d
Der Domänenname ist Teil der Umgebungs-URL. Wenn der Domänenname bereits in Gebrauch ist, wird ein numerischer Wert an den Domänennamen angehängt. Beispiel: Wenn „contoso“ bereits verwendet wird, wird die Umgebungs-URL auf https://{contoso}0.crm.dynamics.com aktualisiert.
Hinweis: Es sind nur Zeichen innerhalb der Bereiche [A – Z], [a – z], [0 – 9] oder '-' zulässig. Das erste und letzte Zeichen darf nicht das „-“-Zeichen sein. Aufeinanderfolgende „-“-Zeichen sind nicht zulässig.
--input-file
-if
Die Verbargumente, die an eine .json-Eingabedatei zu übergeben sind. Zum Beispiel: {„name“ : „contoso“}. Die über die Befehlszeile übergebenen Argumente haben Vorrang vor Argumenten aus der .json-Eingabedatei.
--language
-l
Legt die für Ihre Umgebung verwendete Sprache fest. [standardmäßig Englisch]
--max-async-wait-time
-wt
Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten
--name
-n
Legt den Namen der Umgebung fest.
--region
-r
Legt den Regionsnamen der Umgebung fest. [standardmäßig unitedstates]
--security-group-id
-sgid
Microsoft Entra ID-Sicherheitsgruppen-ID oder Microsoft 365-Gruppen-ID (für Teams-Umgebung erforderlich).
Hinweis: Die Sicherheitsgruppen-ID muss eine gültige GUID sein.
--templates
-tm
Legt die Dynamics 365-App fest, die bereitgestellt werden muss, übergeben als kommagetrennte Werte. Beispielsweise: -tm „D365_Sample, D365_Sales“
--user
-u
Die Objekt-ID oder der Benutzerprinzipalname (UPN) des Benutzers von Microsoft Entra ID, der der Umgebung oder Anwendungs-ID zugewiesen werden soll.
--json
Gibt die Ausgabe des Befehls als JSON-formatierte Zeichenfolge zurück.
Dienstprinzipal PAC-Administrator erstellen
Fügen Sie der Dataverse-Umgebung die Microsoft Entra-ID-Anwendung und den zugehörigen Anwendungsbenutzer hinzu.
Beispiel
pac admin create-service-principal --environment <environment id>
Mehr Informationen: Konfigurieren Sie Dienstverbindungen mithilfe eines Dienstprinzipals
Optionale Parameter für das Erstellen des Dienstprinzipals für den Administrierenden
--environment
-env
Umgebung (ID, Organisations-ID, URL, eindeutiger Name oder teilweiser Name)
--name
-n
In Entra-ID zu erstellender Anwendungsname.
--role
-r
Name oder ID der Sicherheitsrolle, die auf den Anwendungsbenutzenden angewendet werden soll. Der Standardwert ist: „Systemadministrator“.
Anmerkungen
Bei Erfolg werden vier Spalten angezeigt:
- Power Platform TenantId
- Application ID
- Geheimer Clientschlüssel (im Klartext)
- Ablauf
Zum Beispiel:
PS C:\>pac admin create-service-principal --environment d3fcc479-0122-e7af-9965-bde57f69ee1d
Connected as admin@M365x57236226.onmicrosoft.com
Successfully assigned user adde6d52-9582-4932-a43a-beca5d182301 to environment d3fcc479-0122-e7af-9965-bde57f69eeld with security role System Administrator
Tenant ID Application ID Client Secret Expiration
2b0463ed-efd7-419d-927d-a9dca49d899c adde6d52-9582-4932-a43a-beca5d182301 beY8Q~JBZ~CBDgIKKBjbZ3g6BofKzoZkYj23Hbf 7/31/2024 4:27:03 PM
pac admin delete
Löscht die Umgebung aus Ihrem Mandanten.
Beispiele
Die folgenden Beispiele zeigen die Verwendung des pac admin delete
Befehls.
Umgebung nach GUID löschen
pac admin delete --environment 00000000-0000-0000-0000-000000000000
Umgebung nach URL löschen
pac admin delete --environment https://contosomarketing.crm4.dynamics.com
Optionale Parameter für das Löschen des Administrators
--async
-a
Optionales boolesches Argument zum asynchronen Ausführen von pac-Verben, standardmäßig „false“.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--environment
-env
Umgebungs-URL oder ID der Umgebung, die aus dem Mandanten gelöscht werden soll.
--max-async-wait-time
-wt
Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten
pac admin list
Führt alle Umgebungen aus Ihrem Mandanten auf.
Beispiele
Die folgenden Beispiele zeigen die Verwendung des pac admin list
Befehls.
Liste aller Umgebungen im Mandanten
In diesem Beispiel werden alle Umgebungen im Mandanten aufgelistet.
pac admin list
Ein Beispiel für die Ausgabe ist unten aufgeführt.
Environment Environment Id Environment Url Type Organization Id
Contoso 00000000-0000-0000-0000-000000000000 https://contoso.crm.dynamics.com/ Production 00000000-0000-0000-0000-000000000000
Contoso Dev 00000000-0000-0000-0000-000000000000 https://contoso-dev.crm.dynamics.com/ Sandbox 00000000-0000-0000-0000-000000000000
Contoso Test 00000000-0000-0000-0000-000000000000 https://commdemos.crm.dynamics.com/ Sandbox 00000000-0000-0000-0000-000000000000
Liste aller Sandbox-Umgebungen im Mandanten
In diesem Beispiel werden alle Umgebungen im Mandanten des Typs Sandbox
aufgelistet.
pac admin list --type Sandbox
Ein Beispiel für die Ausgabe ist unten aufgeführt.
Environment Environment Id Environment Url Type Organization Id
Contoso Dev 00000000-0000-0000-0000-000000000000 https://contoso-dev.crm.dynamics.com/ Sandbox 00000000-0000-0000-0000-000000000000
Contoso Test 00000000-0000-0000-0000-000000000000 https://commdemos.crm.dynamics.com/ Sandbox 00000000-0000-0000-0000-000000000000
Optionale Parameter für die Administratorliste
--application
-a
Alle Umgebungen mit installierter angegebener Anwendung auflisten. Um die Anwendung anzugeben, verwenden Sie einen eindeutigen Namen oder eine eindeutige ID.
--environment
-env
Listet alle Umgebungen auf, die die angegebene Zeichenfolge in ihrem Namen oder in ihrer ID enthalten
--name
-n
Listet alle Umgebungen auf, die die angegebene Zeichenfolge in ihrem Namen enthalten.
--type
-t
Listet alle Umgebungen mit dem angegebenen Typ auf.
Verwenden Sie einen dieser Werte:
Trial
Sandbox
Production
Developer
Teams
SubscriptionBasedTrial
--json
Gibt die Ausgabe des Befehls als JSON-formatierte Zeichenfolge zurück.
pac admin list-app-templates
Listet alle unterstützten Dataverse-Vorlagen von modellgesteuerten Apps in Dynamics 365 auf.
Beispiele
In den folgenden Beispielen wird der pac admin list-app-templates
Befehl verwendet:
- Liste aller unterstützten Dataverse Datenbankvorlagen
- Liste aller unterstützten Dataverse Datenbankvorlagen modellbasierter Apps in Dynamics 365 für die Region Europa
Alle unterstützten Dataverse Datenbankvorlagen auflisten
Dieses Beispiel führtalle unterstützten Dataverse-Datenbankvorlagen von modellgesteuerten Apps in Dynamics 365 auf.
pac admin list-app-templates
Ein Beispiel für die Ausgabe ist unten aufgeführt.
Template Name Template Location Template Display Name Is Disabled
D365_CDSSampleApp unitedstates Sample App False
D365_CustomerService unitedstates Customer Service True
D365_CustomerServicePro unitedstates Customer Service Pro True
D365_DeveloperEdition unitedstates Developer Edition False
D365_FieldService unitedstates Field Service True
D365_Guides unitedstates Guides True
D365_PowerFrameworkTemplate unitedstates Power Framework False
D365_ProjectOperations unitedstates Project Operations True
D365_RemoteAssist unitedstates Remote Assist True
D365_Sales unitedstates Sales Enterprise True
D365_SalesPro unitedstates Sales Pro True
D365_SmbMarketing unitedstates SMB Marketing True
Führt alle unterstützten Dataverse Datenbankvorlagen von modellgesteuerten Apps in Dynamics 365 für die Region Europa auf
Dieses Beispiel führt alle unterstützten Dataverse Datenbankvorlagen von modellgesteuerten Apps in Dynamics 365 für die Region Europa auf
pac admin list-app-templates --region Europe
Ein Beispiel für die Ausgabe ist unten aufgeführt.
Template Name Template Location Template Display Name Is Disabled
D365_CDSSampleApp Europe Sample App False
D365_CustomerService Europe Customer Service True
D365_CustomerServicePro Europe Customer Service Pro True
D365_DeveloperEdition Europe Developer Edition True
D365_FieldService Europe Field Service True
D365_Guides Europe Guides True
D365_PowerFrameworkTemplate Europe Power Framework True
D365_ProjectOperations Europe Project Operations True
D365_RemoteAssist Europe Remote Assist True
D365_Sales Europe Sales Enterprise True
D365_SalesPro Europe Sales Pro True
D365_SmbMarketing Europe SMB Marketing True
Optionale Parameter für die App-Vorlage für die Administratorliste
--region
-r
Legt den Regionsnamen der Umgebung fest. [standardmäßig unitedstates]
pac admin list-backups
Listet alle Sicherungen Ihrer Umgebung auf.
Beispiele
Die folgenden Beispiele zeigen die Verwendung des pac admin list-backups
Befehls.
Führt Sicherungen aus einer Umgebung nach ID auf
In diesem Beispiel werden die Sicherungen einer Umgebung basierend auf der Umgebungs-ID aufgelistet.
pac admin list-backups --environment 00000000-0000-0000-0000-000000000000
Ein Beispiel für die Ausgabe ist unten aufgeführt.
Index Id Label Expiry Point Date
1 00000000-0000-0000-0000-000000000000 Backup 14/12/2022 12:50:38 07/12/2022 12:50:38
Führt Sicherungen aus einer Umgebung nach URL auf
In diesem Beispiel werden die Sicherungen einer Umgebung basierend auf der Umgebungs-URL aufgelistet.
pac admin list-backups --environment https://contoso.crm.dynamics.com
Optionale Parameter für die Sicherung der Administratorliste
--environment
-env
Listet alle Umgebungen auf, die die angegebene Zeichenfolge in ihrer Umgebungs-ID oder -URL enthalten.
pac admin list-service-principal
Listen Sie Microsoft Entra-ID-Anwendungen mit Zugriff auf Dataverse auf.
Optionale Parameter für admin list-service-principal
--filter
-f
Filter „beginnt mit“ für Anwendungsnamen.
--max
-m
Maximale Anzahl der anzuzeigenden Anwendungen. Standard: 20
pac admin list-tenant-settings
Mandanteneinstellungen auflisten.
Optionale Parameter für die Einstellungen für das Auflisten von Mandantenadministrierenden
--settings-file
-s
Die JSON-Datei für die Ausgabe von Mandanteneinstellungen.
pac admin reset
Setzt die Umgebung aus Ihrem Mandanten zurück.
Beispiele
Die folgenden Beispiele zeigen die Verwendung des pac admin reset
Befehls:
- Setzen Sie ein Umgebung in Ihrem Mandanten zurück.
- Setzen Sie ein Umgebung in Ihrem Mandanten zurück und legen Sie die Währung auf EUR fest.
Setzt eine Umgebung in Ihrem Mandanten zurück
pac admin reset --environment 00000000-0000-0000-0000-000000000000
Setzen Sie eine Umgebung in Ihrem Mandanten zurück und legen Sie die Währung auf EUR fest
pac admin reset --environment 00000000-0000-0000-0000-000000000000 --currency EUR
Optionale Parameter für das Zurücksetzen des Administrators
--async
-a
Optionales boolesches Argument zum asynchronen Ausführen von pac-Verben, standardmäßig „false“.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--currency
-c
Legt die für Ihre Umgebung verwendete Währung fest. [standardmäßig USD]
--domain
-d
Der Domänenname ist Teil der Umgebungs-URL. Wenn der Domänenname bereits in Gebrauch ist, wird ein numerischer Wert an den Domänennamen angehängt. Beispiel: Wenn „contoso“ bereits verwendet wird, wird die Umgebungs-URL auf https://{contoso}0.crm.dynamics.com aktualisiert.
--environment
-env
URL oder ID der Umgebung, die zurückgesetzt werden muss.
--input-file
-if
Die Verbargumente, die an eine .json-Eingabedatei zu übergeben sind. Zum Beispiel: {„name“ : „contoso“}. Die über die Befehlszeile übergebenen Argumente haben Vorrang vor Argumenten aus der .json-Eingabedatei.
--language
-l
Legt die für Ihre Umgebung verwendete Sprache fest. [standardmäßig Englisch]
--max-async-wait-time
-wt
Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten
--name
-n
Legt den Namen der Umgebung fest.
--purpose
-p
Legt die Beschreibung fest, die zum Zuordnen der Umgebung zu einer bestimmten Absicht verwendet wird.
--templates
-tm
Legt die Dynamics 365-App fest, die bereitgestellt werden muss, übergeben als kommagetrennte Werte. Beispielsweise: -tm „D365_Sample, D365_Sales“
--json
Gibt die Ausgabe des Befehls als JSON-formatierte Zeichenfolge zurück.
pac admin restore
Stellt eine Umgebung für eine bestimmte Sicherung wieder her.
Beispiele
Die folgenden Beispiele zeigen die Verwendung des pac admin restore
Befehls:
- Stellen Sie das letzte Backup wieder her
- Wiederherstellen einer Sicherung basierend auf einem Zeitstempel
Stellen Sie die letzte Sicherung wieder her
In diesem Beispiel wird die neueste Sicherung aus der Quellumgebung mit der ID 00000000-0000-0000-0000-000000000000
in der Umgebung wiederhergestellt, die derzeit im aktuellen aktiven Authentifizierungsprofil ausgewählt ist.
pac admin restore --selected-backup latest --source-env 00000000-0000-0000-0000-000000000000
Stellen Sie eine Sicherung basierend auf einem Zeitstempel wieder her
In diesem Beispiel wird die neueste Sicherung, die im 12/01/2022 09:00
aus der Quellumgebung mit der ID 00000000-0000-0000-0000-000000000000
in der Umgebung wiederhergestellt wurde, die derzeit im aktuellen aktiven Authentifizierungsprofil ausgewählt ist.
pac admin restore --selected-backup '12/01/2022 09:00' --source-env 00000000-0000-0000-0000-000000000000
Erforderliche Parameter für das Wiederherstellen des Administrators
--selected-backup
-sb
DateTime der Sicherung im „mm/dd/jjjj hh:mm“-Format ODER als „latest“-Zeichenfolge.
Optionale Parameter für das Wiederherstellen des Administrators
--async
-a
Optionales boolesches Argument zum asynchronen Ausführen von pac-Verben, standardmäßig „false“.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--max-async-wait-time
-wt
Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten
--name
-n
Optionaler Name der wiederhergestellten Umgebung.
--skip-audit-data
-sa
Schalter, der angibt, ob Überwachungsdaten übersprungen werden sollen
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--source-env
-se
Umgebungs-URL oder -ID der Quellumgebung, die für die Wiederherstellung erforderlich ist.
--target-env
-te
Umgebungs-URL oder -ID der Zielumgebung, die für die Wiederherstellung erforderlich ist. Standardmäßig wäre es die Quell-URL/-ID, sofern nichts angegeben wird.
--json
Gibt die Ausgabe des Befehls als JSON-formatierte Zeichenfolge zurück.
PAC-Administrator Aufbewahrungszeitraum zur Sicherung einrichten
Legt den Aufbewahrungszeitraum zur Sicherung in Tagen wie angegeben fest. Gültige Werte sind: 7, 14, 21 und 28.
Erforderliche Parameter für das Festlegen des Aufbewahrungszeitraums der Administratorsicherung
--backup-retention-period
-br
Legt den Aufbewahrungszeitraum zur Sicherung in Tagen wie angegeben fest. Gültige Werte sind: 7, 14, 21 und 28.
Optionale Parameter für das Festlegen des Aufbewahrungszeitraums der Administratorsicherung
--async
-a
Optionales boolesches Argument zum asynchronen Ausführen von pac-Verben, standardmäßig „false“.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--environment
-env
Umgebungs-URL oder ID der Umgebung, die eine Sicherung erfordert.
--max-async-wait-time
-wt
Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten
pac admin set-governance-config
Verwaltete Umgebungen aktivieren, deaktivieren und bearbeiten
Erforderliche Parameter für admin set-governance-config
--environment
-env
URL oder ID der Umgebung, in der verwaltete Umgebungen aktiviert, deaktiviert oder bearbeitet werden müssen
--protection-level
-pl
Legen Sie die Schutzebene fest: „Standard“, um verwaltete Umgebungen zu aktivieren, „Basic“, um verwaltete Umgebungen zu deaktivieren
Verwenden Sie einen dieser Werte:
Basic
Standard
Optionale Parameter für admin set-governance-config
--checker-rule-overrides
-cro
Überschreibungen der Lösungsüberprüfungsregel
--cloud-flows-limit
-cfl
Anzahl der Personen, für die Entwickler Lösungs-Cloud-Flows freigeben können
--cloud-flows-mode
-cfm
Lösungs-Cloud-Flows schränken den Freigabemodus ein
--disable-group-sharing
-dgs
Deaktivieren Sie die Gruppenfreigabe.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--exclude-analysis
-ea
Schließen Sie Nutzungseinblicke für die Umgebung aus der wöchentlichen Digest-E-Mail aus.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--include-insights
-ii
Fügen Sie Einblicke in die Power Platform Admin Center-Startseitenkarten ein.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--limit-sharing-mode
-lsm
Beschränken Sie den Freigabemodus.
--maker-onboarding-markdown
-mom
Markdown für Entwickler-Onboarding
--maker-onboarding-url
-mou
URL für Entwickler-Onboarding
--max-limit-user-sharing
-ml
Wenn die Gruppenfreigabe deaktiviert ist, geben Sie die Anzahl der Personen an, mit denen Maker Canvas-Apps teilen können.
--solution-checker-mode
-scm
Überprüfungsmodus für die Lösungsüberprüfung
Verwenden Sie einen dieser Werte:
none
warn
block
--suppress-validation-emails
-sve
Bestätigungs-E-Mails unterdrücken
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
pac admin set-runtime-state
Modus der Umgebungsverwaltung aktualisieren.
Erforderliche Parameter für admin set-runtime-state
--environment
-env
URL oder ID der Umgebung, für die der Verwaltungsmodus aktualisiert werden muss.
--runtime-state
-rs
Der Laufzeitstatus der Umgebung
Verwenden Sie einen dieser Werte:
AdminMode
Enabled
Optionale Parameter für admin set-runtime-state
--async
-a
Optionales boolesches Argument zum asynchronen Ausführen von pac-Verben, standardmäßig „false“.
Dieser Parameter benötigt keinen Wert. Es ist ein Umschalter.
--background-operations
-bo
Der Status der Hintergrundvorgänge der Umgebung
Verwenden Sie einen dieser Werte:
Enabled
Disabled
--max-async-wait-time
-wt
Maximale asynchrone Wartezeit in Minuten. Der Standardwert ist 60 Minuten
pac admin status
Mit diesem Befehl wird der Status aller in Bearbeitung befindlichen Vorgänge aufgeführt.
pac admin update-tenant-settings
Mandanteneinstellungen aktualisieren.
Erforderliche Parameter für die Aktualisierungseinstellungen von Mandantenadministrierenden
--settings-file
-s
Die JSON-Datei mit Mandanteneinstellungen.
Anmerkungen
Ein Beispiel für die Verwendung dieses Befehls finden Sie unter Umgebungsroutingeinstellung aktivieren.
Siehe auch
Microsoft Power Platform CLI-Befehlsgruppen
Microsoft Power Platform CLI-Übersicht