Command
New-AppleAppArchive
Creates an Apple app .xcarchive using xcodebuild.
Syntax
New-AppleAppArchive
[-AdditionalArgument <String[]>]
[-AllowProvisioningUpdates]
[-ArchivePath <String>]
[-ArchiveRoot <String>]
[-ArchiveVariant <Default| MacCatalyst>]
[-Configuration <String>]
[-Destination <String>]
[-Platform <ApplePlatform>]
[-ProjectPath] <String>
-Scheme <String>
[-TimeoutMinutes <Int32>]
[-Workspace]
[-XcodeBuild <String>]
[<CommonParameters>]#Parameter set:
All Parameter SetsExamples
Example 1
New-AppleAppArchive -Scheme 'Value'Parameters
- -AdditionalArgument String[]
- Additional structured arguments appended to the archive command.
- -AllowProvisioningUpdates SwitchParameter
- Allows Xcode to create or update signing assets during archive.
- -ArchivePath String
- Output .xcarchive path.
- -ArchiveRoot String
- Directory used for generated archive paths.
- -ArchiveVariant AppleArchiveVariant
- Optional archive destination variant, such as Mac Catalyst.
- Possible values:
Default,MacCatalyst - -Configuration String
- Build configuration.
- -Destination String
- Explicit xcodebuild destination.
- -Platform ApplePlatform
- Apple platform used to resolve the generic destination.
- Possible values:
iOS,iPadOS,macOS,tvOS,watchOS,visionOS - -ProjectPath String
- Path to the Xcode project or workspace.
- -Scheme String
- Xcode scheme to archive.
- -TimeoutMinutes Int32
- Maximum archive runtime in minutes.
- -Workspace SwitchParameter
- ProjectPath points to a workspace instead of a project.
- -XcodeBuild String
- xcodebuild 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.