Project

PSPublishModule

Build, test, version, sign, and publish PowerShell modules with reusable PowerForge pipelines.

Stars 48
Forks 16
PowerShell Gallery downloads 17,213
Release v3.0.169
Language: C# Updated: 2026-10-13

API Reference

Command

Publish-AppleAppToDevice

Namespace PSPublishModule
Inputs
None
Outputs
PowerForge.AppleAppDeviceDeploymentResult

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

Remarks

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

Examples

Authored help example

EXAMPLE 1


Publish-AppleAppToDevice -Scheme 'Value'
        

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.

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 <iOS>] [-ProductName <String>] -ProjectPath <String> [-Rsync <String>] -Scheme <String> [-TimeoutMinutes <Int32>] [-UseBuildMirror] [-Workspace] [-XcodeBuild <String>] [-Xcrun <String>] [<CommonParameters>]
#
Parameter set: All Parameter Sets

Parameters

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

Outputs

PowerForge.AppleAppDeviceDeploymentResult