Import-PASPlatform

Import-PASPlatform

SYNOPSIS

Import a new platform

SYNTAX

Import

Import-PASPlatform [-ImportFile] <String> [-WhatIf] [-Confirm] [<CommonParameters>]

SideBySide

Import-PASPlatform -PlatformId <String> -PlatformName <String> [-Description <String>] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Update

Import-PASPlatform -PlatformId <String> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Import a new CPM platform.

EXAMPLES

EXAMPLE 1

Import-PASPlatform -ImportFile CustomApp.zip

Imports CustomApp.zip Platform package

EXAMPLE 2

Import-PASPlatform -PlatformId CustomAppV2 -PlatformName CustomApp-V2 -Description "Platform for Custom App Version 2"

Imports Platform side by side with existing Platform

EXAMPLE 3

Import-PASPlatform -PlatformId CustomApp -Force

Updates existing Platform with new package

PARAMETERS

-ImportFile

The zip file that contains the platform.

Type: String
Parameter Sets: Import
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Description

A description value for the platform

Type: String
Parameter Sets: SideBySide
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Force

Specify to force update of an existing platform, replacing it with the imported platform

Type: SwitchParameter
Parameter Sets: Update
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-PlatformId

Set a PlatformId for the imported platform

Type: String
Parameter Sets: SideBySide, Update
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-PlatformName

Set a name for the imported platform

Type: String
Parameter Sets: SideBySide
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

Minimum CyberArk version 10.2

https://pspas.pspete.dev/commands/Import-PASPlatform

https://docs.cyberark.com/Product-Doc/OnlineHelp/PAS/Latest/en/Content/WebServices/ImportPlatform.htm

https://docs.cyberark.com/pam-self-hosted/latest/en/content/webservices/updateplatformwithstoredplatform.htm

https://docs.cyberark.com/pam-self-hosted/latest/en/content/webservices/importstoredplatformpatch.htm