Repository navigation
v1.2.0-alpha2
Pre-release
Pre-release
·
4 commits
to main
since this release
Breaking Changes
This is a major refactor. All cmdlets now wrap the ppds CLI tool instead of using native PowerShell implementation.
- Removed
DataverseConnectionclass - Authentication now uses CLI profiles - Removed
-Connectionparameter - Use-Profileand-Environmentinstead - Requires
ppdsCLI tool - Install withdotnet tool install --global PPDS.Cli
Migration Guide
| v1.x Pattern | v1.2.x Pattern |
|---|---|
$conn = Connect-DataverseEnvironment -Interactive |
Connect-DataverseEnvironment -DeviceCode -Name "dev" |
Deploy-DataversePlugins -Connection $conn ... |
Deploy-DataversePlugins -Profile "dev" ... or just Deploy-DataversePlugins ... (uses active profile) |
-RegistrationFile parameter |
-ConfigPath parameter (alias preserved) |
Invoke-DataverseMigration |
Copy-DataverseData (alias preserved) |
Added
-
New cmdlets:
Get-DataverseProfile- Get current active authentication profileGet-DataverseProfiles- List all authentication profilesGet-DataversePlugins- List registered plugins in environmentCopy-DataverseData- Copy data between environments
-
New authentication methods via
Connect-DataverseEnvironment:- Interactive browser (default)
- Device code flow (
-DeviceCode) - Client secret (
-ApplicationId,-ClientSecret,-TenantId) - Certificate file (
-CertificatePath) - Certificate store (
-CertificateThumbprint) - Managed identity (
-ManagedIdentity) - Username/password (
-Username,-Password) - GitHub federated (
-GitHubFederated) - Azure DevOps federated (
-AzureDevOpsFederated) - Cloud selection (
-Cloud: Public, USGov, USGovHigh, USGovDoD, China)
-
New parameters for migration cmdlets:
Import-DataverseData:-BypassPlugins,-BypassFlows,-ContinueOnError,-Mode,-UserMappingPath,-StripOwnerFields,-SkipMissingColumnsExport-DataverseData:-Parallel,-BatchSizeCopy-DataverseData: All source/target options
Changed
- All cmdlets now wrap the unified
ppdsCLI tool - CLI helper renamed from
Get-PpdsMigrateClitoGet-PpdsCli Invoke-DataverseMigrationrenamed toCopy-DataverseData(alias preserved)- Plugin cmdlets now use
-ConfigPathparameter (with-RegistrationFilealias)
Removed
DataverseConnectionclass- Native OAuth2 implementation (~300 lines)
- Native Dataverse Web API implementation (~700 lines)
- Native assembly reflection (~275 lines)
Dependencies
- Requires:
ppdsCLI tool (PPDS.Cli dotnet tool) - Requires: PowerShell 7.0+
Installation
# Install the PowerShell module
Install-Module PPDS.Tools -Scope CurrentUser -AllowPrerelease
# Install the CLI tool (required)
dotnet tool install --global PPDS.Cli