Command

Publish-AppleAppToDevice

Module: PSPublishModule
Inputs: None
Outputs: PowerForge.AppleAppDeviceDeploymentResult

Builds, installs, and optionally launches an Apple app on a physical device.

Syntax

Publish-AppleAppToDevice
[-AdditionalArgument <String[]>]
[-AllowProvisioningUpdates]
[-AppPath <String>]
[-BuildMirrorPath <String>]
[-BuildRoot <String>]
[-BundleIdentifier <String>]
[-Configuration <String>]
[-DerivedDataPath <String>]
[-Destination <String>]
[-Device <String>]
[-DeviceIdentifier <String>]
[-Launch]
[-Platform <ApplePlatform>]
[-ProductName <String>]
[-ProjectPath] <String>
[-Rsync <String>]
-Scheme <String>
[-TimeoutMinutes <Int32>]
[-UseBuildMirror]
[-Workspace]
[-XcodeBuild <String>]
[-Xcrun <String>]
[<CommonParameters>]

Parameter set: All Parameter Sets

Examples

Example 1

Publish-AppleAppToDevice -Scheme 'Value'

Parameters

-AdditionalArgument String[] optional: Additional structured arguments appended to the xcodebuild build command.
-AllowProvisioningUpdates SwitchParameter optional: Allows Xcode to create or update signing assets during build.
-AppPath String optional: Expected app path.
-BuildMirrorPath String optional: Mirror directory used when UseBuildMirror is enabled.
-BuildRoot String optional: Root directory to mirror. Defaults to the project/workspace parent.
-BundleIdentifier String optional: Bundle identifier used when launching after install.
-Configuration String optional: Build configuration.
-DerivedDataPath String optional: DerivedData path.
-Destination String optional: Explicit xcodebuild destination.
-Device String optional: Device name, identifier, or model used when DeviceIdentifier is not supplied.
-DeviceIdentifier String optional: Physical device identifier used for deployment.
-Launch SwitchParameter optional: Launch the app after a successful install.
-Platform ApplePlatform optional: Apple platform used to resolve the product directory.; Possible values: iOS, iPadOS, macOS, tvOS, watchOS, visionOS
-ProductName String optional: Built product name. Defaults to Scheme.
-ProjectPath String requiredposition: 0aliases: FullName, Path: Path to the Xcode project or workspace.
-Rsync String optional: rsync executable name or path used for build mirroring.
-Scheme String required: Xcode scheme to build.
-TimeoutMinutes Int32 optional: Maximum runtime per stage in minutes.
-UseBuildMirror SwitchParameter optional: Mirror the project root to a local folder before running xcodebuild.
-Workspace SwitchParameter optional: ProjectPath points to a workspace instead of a project.
-XcodeBuild String optional: xcodebuild executable name or path.
-Xcrun String optional: xcrun executable name or path.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.