pac admin
Power Platform 管理者アカウントを使用する
command | プロパティ |
---|---|
PAC管理者アプリケーション リスト | テナントに登録された Microsoft Entra ID アプリケーションを一覧表示します。 |
pac管理者アプリケーション登録 | Microsoft Entra ID アプリケーションをテナントに登録します。 |
pac管理アプリケーションの登録解除 | テナントから Microsoft Entra ID アプリケーションの登録を解除します。 |
pac管理者割り当てグループ | 指定されたセキュリティ ロールを持つターゲット Dataverse 環境にグループを割り当てます。 |
pac管理者 ユーザー割り当て | 指定されたセキュリティ ロールを持つターゲット Dataverse 環境にユーザーを割り当てます。 |
pac管理者バックアップ | 環境の手動バックアップを行います。 |
pac管理者コピー | ソース環境を宛先環境にコピーします。 |
pac管理者作成 | テナントに Dataverse インスタンスを作成します。 |
pac管理者サービスプリンシパルの作成 | Microsoft Entra ID アプリケーションと、関連するアプリケーション ユーザーを Dataverse 環境に追加します。 |
pac管理者削除 | この環境をテナントから削除します。 |
PAC管理者リスト | テナントのすべての環境を一覧表示します。 |
pac管理者リスト アプリ テンプレート | Dynamics 365 でサポートされるモデル駆動型アプリの Dataverse テンプレートをすべて一覧表示します。 |
pac管理者リストバックアップ | 環境のすべてのバックアップをリストします。 |
pac管理者リスト-サービスプリンシパル | Dataverse へのアクセス許可を持つ Microsoft Entra ID アプリケーションを一覧表示します。 |
pac管理者リスト-テナント設定 | テナントの設定を一覧表示します。 |
pac管理者リセット | テナントの環境をリセットします。 |
pac管理者復元 | 指定されたバックアップに環境を復元します。 |
pac管理者によるバックアップ保存期間の設定 | 指定された日のバックアップ保持期間を設定します。 有効な値は、7、14、21、28 です。 |
pac管理者ガバナンス設定 | マネージド環境の有効化、無効化、編集。 |
pac管理者 ランタイム状態の設定 | 環境の管理モードを更新します。 |
PAC管理者ステータス | このコマンドは、進行中のすべての操作の状態を一覧表示します。 |
pac管理者 テナント設定の更新 | テナント設定を更新します。 |
テナントに登録された Microsoft Entra ID アプリケーションを一覧表示します。
Microsoft Entra ID アプリケーションをテナントに登録します。
アプリケーション ID
テナントから Microsoft Entra ID アプリケーションの登録を解除します。
アプリケーション ID
指定されたセキュリティ ロールを持つターゲット Dataverse 環境にグループを割り当てます。
ターゲット Dataverse 環境に割り当てるグループの Microsoft Entra ID のオブジェクト ID。
Dataverse に作成するグループやチームの名前。
チーム メンバーシップの種類です。
次の値のいずれかを使用します。
MembersAndGuests
Members
Owners
Guests
ユーザーに適用するセキュリティ ロールの名前または ID
チームの種類。
次の値のいずれかを使用します。
Owner
Access
AadSecurityGroup
AadOfficeGroup
アプリケーション ユーザーを関連付ける部署の ID です。
ユーザー割り当てる環境の ID または URL。
指定されたセキュリティ ロールを持つターゲット Dataverse 環境にユーザーを割り当てます。
次の例は、pac admin assign-user
コマンドの使用を示します。
- 基本ユーザーロールを持つ環境に電子メールでユーザーを割り当てる
- システム 管理者 ロールを持つ 環境 にGUIDでユーザーを割り当て、指定されたビジネス ユニットにユーザーを追加します。
- システム 管理者 ロールを持つ 環境 にアプリケーション ユーザーを割り当てます
pac admin assign-user `
--environment 00000000-0000-0000-0000-000000000000 `
--user "user@company.com" `
--role "Basic User"
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"
pac admin assign-user `
--environment 00000000-0000-0000-0000-000000000000 `
--user 00000000-0000-0000-0000-000000000000 `
--role "System Administrator"
--application-user
ユーザーに適用するセキュリティ ロールの名前または ID
アプリケーション ユーザーを割り当てる場合に環境またはアプリケーション ID に割り当てられる、Microsoft Entra ID ユーザーのオブジェクト ID またはユーザー プリンシパル名 (UPN)。
入力ユーザーがアプリケーション ユーザーかどうかを指定します。 部署が指定されていない場合、アプリケーション ユーザーは認証されたユーザーの部署に追加されます。
このパラメーターには値が必要ありません。 それはスイッチです。
非推奨: このパラメータは無視されます。
アプリケーション ユーザーを関連付ける部署の ID です。
ユーザー割り当てる環境の ID または URL。
環境の手動バックアップを行います。
pac admin backup `
--environment 00000000-0000-0000-0000-000000000000 `
--label "Manual Backup October 2022"
提供されたバックアップ ラベルを設定します。
バックアップが必要な環境の環境 URL または ID。
ソース環境を宛先環境にコピーします。
次の例は、pac admin copy
コマンドの使用を示します。
この例では、カスタマイズとスキーマのみをソース環境からターゲット環境にコピーします。
pac admin copy `
--name "Environment Name" `
--source-env 00000000-0000-0000-0000-000000000000 `
--target-env 00000000-0000-0000-0000-000000000000 `
--type MinimalCopy
この例では、環境全体をソース環境からターゲット環境にコピーします。
pac admin copy `
--name "Environment Name" `
--source-env 00000000-0000-0000-0000-000000000000 `
--target-env 00000000-0000-0000-0000-000000000000 `
--type FullCopy
pac 動詞を非同期で実行するためのオプションのブール値の引数です。既定で誤に設定されます。
このパラメーターには値が必要ありません。 それはスイッチです。
最大非同期待機時間 (分)。 既定値は 60 分です。
ターゲット環境の名前。
監査データをスキップするかどうかを示すスイッチ
このパラメーターには値が必要ありません。 それはスイッチです。
コピーされているソース環境の環境 URL または ID
ターゲット環境の環境 URL または ID。
次の値のいずれかを使用します。
MinimalCopy
FullCopy
コマンドの出力を JSON 形式の文字列として返します。
テナントに Dataverse インスタンスを作成します。
次の例は、pac admin create
コマンドの使用を示します。
この例では、デフォルト設定でサンドボックス環境を作成します。
- 通貨: USD
- 言語: 英語
- リージョン: unitedstates
これらの値はデフォルト値であるため、これらのプロパティを追加する必要はありません。
pac admin create `
--name "Contoso Test" `
--type Sandbox `
--domain ContosoTest
この例では、通貨をユーロに設定し、言語を英語に設定して、リージョン ヨーロッパに運用環境を作成します。
言語プロパティはデフォルト値であるため、追加する必要はありません。
pac admin create `
--name "Contoso Marketing" `
--currency EUR `
--region europe `
--type Production `
--domain ContosoMarketing
この例では、環境の高度な作成 で説明されているのと同じ環境を作成します。ただし、config.json にこのデータが存在する config.json
という名前の JSON ファイル内のデータを参照します。
{
"name": "Contoso Marketing",
"currency": "EUR",
"region": "europe",
"type": "Production",
"domain": "ContosoMarketing"
}
次に、pac admin create
コマンドを使用するときにファイルを参照します。
pac admin create --input-file C:\config.json
環境の種類を設定します。
次の値のいずれかを使用します。
Trial
Sandbox
Production
Developer
Teams
SubscriptionBasedTrial
pac 動詞を非同期で実行するためのオプションのブール値の引数です。既定で誤に設定されます。
このパラメーターには値が必要ありません。 それはスイッチです。
環境で使用する通貨を設定します。 [既定値は USD]
ドメイン名は環境 URL の一部です。 ドメイン名がすでに使用されている場合は、ドメイン名に数値が追加されます。 例: "Contoso" がすでに使用されている場合、環境 URL は https://{contoso} 0.crm.dynamics.com に更新されます
注: [A - Z]、[a - z]、[0 - 9]、または「-」の範囲内の文字のみが許可されます。 最初と最後の文字を "-" 文字にすることはできません。 "-" は連続して使用できません。
.json 入力ファイルで渡す動詞の引数。 例: {"名前" : "Contoso"}。 コマンドラインを介して渡される引数は、.json 入力ファイルからの引数よりも優先されます。
環境で使用する言語を設定します。 [既定値は英語]
最大非同期待機時間 (分)。 既定値は 60 分です。
環境の名前を設定します。
環境のリージョン名を設定します。 [既定値は米国]
Microsoft Entra ID セキュリティグループ ID または Microsoft 365 グループ ID (Teams 環境で必須)。
注: セキュリティ グループIDは有効なGUIDである必要があります。
展開しコンマ区切り値として渡す必要がある Dynamics 365 アプリを設定します。 例: -tm "D365_Sample、D365_Sales"
環境に割り当てられる Microsoft Entra ID ユーザーのオブジェクト ID またはユーザー プリンシパル名 (UPN)。
コマンドの出力を JSON 形式の文字列として返します。
Microsoft Entra ID アプリケーションと、関連するアプリケーション ユーザーを Dataverse 環境に追加します。
pac admin create-service-principal --environment <environment id>
詳細: サービス プリンシパルを使用してサービス接続を構成する
環境 (ID、組織 ID、URL、一意の名前、または名前の一部)。
Entra ID で作成するアプリケーション名。
アプリケーション ユーザーに適用するセキュリティ ロールの名前または ID。 既定値は "システム管理者" です。
成功すると、次の 4 つの列が表示されます。
- Power Platform TenantId
- Application ID
- クライアント シークレット (クリアテキスト)
- Expiration
例:
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
コマンドの使用を示します。
pac admin delete --environment 00000000-0000-0000-0000-000000000000
pac admin delete --environment https://contosomarketing.crm4.dynamics.com
pac 動詞を非同期で実行するためのオプションのブール値の引数です。既定で誤に設定されます。
このパラメーターには値が必要ありません。 それはスイッチです。
テナントから削除する必要がある環境の URL または ID。
最大非同期待機時間 (分)。 既定値は 60 分です。
テナントのすべての環境を一覧表示します。
次の例は、pac admin list
コマンドの使用を示します。
この例では、テナント内のすべての環境を一覧表示します。
pac admin list
出力の例を以下に示します。
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
この例では、タイプ Sandbox
のテナント内のすべての環境を一覧表示します。
pac admin list --type Sandbox
出力の例を以下に示します。
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
指定したアプリケーションがインストールされているすべての環境の一覧です。 アプリケーションを指定するには、一意の名前または ID を使用します。
名前または ID に指定された文字列を含むすべての環境を一覧表示します。
名前に指定された文字列を含むすべての環境を一覧表示します。
指定された種類のすべての環境を一覧表示します。
次の値のいずれかを使用します。
Trial
Sandbox
Production
Developer
Teams
SubscriptionBasedTrial
コマンドの出力を JSON 形式の文字列として返します。
Dynamics 365 でサポートされるモデル駆動型アプリの Dataverse テンプレートをすべて一覧表示します。
次の例では、pac admin list-app-templates
コマンドを使用しています。
- サポートされているすべてのデータベーステンプレートを一覧表示します Dataverse
- ヨーロッパ地域のDynamics 365でサポートされているモデル駆動型アプリのデータベース テンプレートをすべて一覧表示します。 Dataverse
この例は、Dynamics 365 のモデル駆動アプリのサポートされるすべての Dataverse データベース テンプレートの一覧を表示します。
pac admin list-app-templates
出力の例を以下に示します。
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
この例は、ヨーロッパの Dynamics 365 のモデル駆動アプリのサポートされるすべての Dataverse データベース テンプレートの一覧を表示します。
pac admin list-app-templates --region Europe
出力の例を以下に示します。
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
環境のリージョン名を設定します。 [既定値は米国]
環境のすべてのバックアップをリストします。
次の例は、pac admin list-backups
コマンドの使用を示します。
この例では、環境 ID に基づいて環境のバックアップを一覧表示します。
pac admin list-backups --environment 00000000-0000-0000-0000-000000000000
出力の例を以下に示します。
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
この例では、環境 URL に基づいて環境のバックアップを一覧表示します。
pac admin list-backups --environment https://contoso.crm.dynamics.com
環境 ID または URL に指定された文字列を含む、すべての環境を一覧表示します。
Dataverse へのアクセス許可を持つ Microsoft Entra ID アプリケーションを一覧表示します。
アプリケーション名の '先頭文字' フィルター。
表示するアプリケーションの最大数。 既定値: 20
テナントの設定を一覧表示します。
テナント設定を出力するための .json ファイル。
テナントの環境をリセットします。
次の例は、pac admin reset
コマンドの使用を示します。
pac admin reset --environment 00000000-0000-0000-0000-000000000000
pac admin reset --environment 00000000-0000-0000-0000-000000000000 --currency EUR
pac 動詞を非同期で実行するためのオプションのブール値の引数です。既定で誤に設定されます。
このパラメーターには値が必要ありません。 それはスイッチです。
環境で使用する通貨を設定します。 [既定値は USD]
ドメイン名は環境 URL の一部です。 ドメイン名がすでに使用されている場合は、ドメイン名に数値が追加されます。 例: "Contoso" がすでに使用されている場合、環境 URL は https://{contoso} 0.crm.dynamics.com に更新されます
リセットが必要な環境の URL または ID。
.json 入力ファイルで渡す動詞の引数。 例: {"名前" : "Contoso"}。 コマンドラインを介して渡される引数は、.json 入力ファイルからの引数よりも優先されます。
環境で使用する言語を設定します。 [既定値は英語]
最大非同期待機時間 (分)。 既定値は 60 分です。
環境の名前を設定します。
特定のインテントに環境を関連付けるために使用する説明を設定します。
展開しコンマ区切り値として渡す必要がある Dynamics 365 アプリを設定します。 例: -tm "D365_Sample、D365_Sales"
コマンドの出力を JSON 形式の文字列として返します。
指定されたバックアップに環境を復元します。
次の例は、pac admin restore
コマンドの使用を示します。
この例では、ID 00000000-0000-0000-0000-000000000000
のソース環境から、現在アクティブな認証プロファイルで現在選択されている環境に最新のバックアップを復元します。
pac admin restore --selected-backup latest --source-env 00000000-0000-0000-0000-000000000000
この例では、ID 00000000-0000-0000-0000-000000000000
のソース環境から、現在アクティブな認証プロファイルで現在選択されている環境に、12/01/2022 09:00
で作成されたバックアップを復元します。
pac admin restore --selected-backup '12/01/2022 09:00' --source-env 00000000-0000-0000-0000-000000000000
バックアップの日時を 'mm/dd/yyyy hh:mm' または文字列 'latest' で指定します。
pac 動詞を非同期で実行するためのオプションのブール値の引数です。既定で誤に設定されます。
このパラメーターには値が必要ありません。 それはスイッチです。
最大非同期待機時間 (分)。 既定値は 60 分です。
復元された環境の名前 (省略可能) です。
監査データをスキップするかどうかを示すスイッチ
このパラメーターには値が必要ありません。 それはスイッチです。
復元に必要なソース環境の環境 URL または ID。
復元に必要なターゲット環境の環境 URL または ID。 指定しない場合、これは既定でソース URL/ID になります。
コマンドの出力を JSON 形式の文字列として返します。
指定された日のバックアップ保持期間を設定します。 有効な値は、7、14、21、28 です。
指定された日のバックアップ保持期間を設定します。 有効な値は、7、14、21、28 です。
pac 動詞を非同期で実行するためのオプションのブール値の引数です。既定で誤に設定されます。
このパラメーターには値が必要ありません。 それはスイッチです。
バックアップが必要な環境の環境 URL または ID。
最大非同期待機時間 (分)。 既定値は 60 分です。
マネージド環境の有効化、無効化、編集。
マネージド環境の有効化、無効化、または編集を行うべき環境の URL または ID。
保護レベルの設定: マネージド環境を有効化する場合は '標準'、マネージド環境を無効化する場合は '基本'。
次の値のいずれかを使用します。
Basic
Standard
ソリューション チェッカー ルールの上書き
作成者がソリューション クラウド フローを共有できるユーザーの数
ソリューション クラウド フローの制限共有モード
グループ共有を無効化します。
このパラメーターには値が必要ありません。 それはスイッチです。
週次ダイジェスト メールから、環境の使用状況に関するインサイトを除外します。
このパラメーターには値が必要ありません。 それはスイッチです。
Power Platform 管理センターのホームページ カードにインサイトを含めます。
このパラメーターには値が必要ありません。 それはスイッチです。
共有モードを制限します。
作成者のオンボード マークダウン
作成者のオンボード URL
グループ共有が無効である場合は、作成者がキャンバス アプリを共有できる人数を指定します。
ソリューション チェッカーの検証モード。
次の値のいずれかを使用します。
none
warn
block
検証メールの抑制
このパラメーターには値が必要ありません。 それはスイッチです。
環境の管理モードを更新します。
管理モードを更新するべき環境の URL または ID。
環境ランタイムの状態
次の値のいずれかを使用します。
AdminMode
Enabled
pac 動詞を非同期で実行するためのオプションのブール値の引数です。既定で誤に設定されます。
このパラメーターには値が必要ありません。 それはスイッチです。
環境のバックグラウンド操作の状態
次の値のいずれかを使用します。
Enabled
Disabled
最大非同期待機時間 (分)。 既定値は 60 分です。
このコマンドは、進行中のすべての操作の状態を一覧表示します。
テナント設定を更新します。
テナントの設定を含む .json ファイル。
このコマンドの使用例は、環境ルーティング設定を有効にする で確認できます。
Microsoft Power Platform CLIコマンド グループ
Microsoft Power Platform CLIの概要