Remove UnifiedEnvironmentPackage

---

external help file: d365bap.tools-help.xml Module Name: d365bap.tools online version: schema: 2.0.0

Remove-UnifiedEnvironmentPackage

SYNOPSIS

Remove UDE environment packages.

SYNTAX

Remove-UnifiedEnvironmentPackage [-EnvironmentId] <String> [[-PackageId] <String>] [[-Name] <String>] [-Force]
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Removes UDE environment packages (msprov_fnopackage records) for a specified environment.

Packages are matched by package id and name. Nothing is removed unless the -Force switch is supplied. Without -Force the cmdlet lists the packages that would be removed.

EXAMPLES

EXAMPLE 1

Remove-UnifiedEnvironmentPackage -EnvironmentId "env-123" -PackageId "a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6"

This will show the package that would be removed for the specified environment id. It will NOT remove the package yet, allowing you to review it before deciding to remove it.

EXAMPLE 2

Remove-UnifiedEnvironmentPackage -EnvironmentId "env-123" -PackageId "a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6" -Force

This will remove the specified package for the specified environment id without further confirmation.

EXAMPLE 3

Get-UnifiedEnvironmentPackage -EnvironmentId "env-123" | Remove-UnifiedEnvironmentPackage -Force

This will remove all packages returned for the specified environment id without further confirmation.

PARAMETERS

-EnvironmentId

The id of the environment that you want to work against

Type: String
Parameter Sets: (All)
Aliases: PpacEnvId

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

-PackageId

The id of the package that you want to remove.

Supports wildcard characters for flexible matching against the package id.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: *
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Name

The name of the package that you want to remove.

Supports wildcard characters for flexible matching against the package name.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: *
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Force

Instructs the function to proceed with removing the packages.

Nothing happens unless this parameter is supplied.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ProgressAction

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
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

Author: Mötz Jensen (@Splaxi)

RELATED LINKS