Unpublish-NAVApp
Unpublish-NAVApp
Unpublishes a Microsoft Dynamics NAV extension from the app catalog of the specified Microsoft Dynamics NAV Server instance.
Syntax
Parameter Set: Path
Unpublish-NAVApp [-ServerInstance] <String> [-Path] <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Properties
Unpublish-NAVApp [-ServerInstance] <String> [-Name] <String> [[-Publisher] <String> ] [[-Version] <Version> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
Use the Unpublish-NAVApp cmdlet to remove an extension from the app catalog of the specified Microsoft Dynamics NAV Server instance.
The extension cannot be unpublished if it is currently installed for a tenant of the specified Microsoft Dynamics NAV Server instance.
Parameters
-Name<String>
Specifies the name of the extension that you want to unpublish. The results must return only a single extension; otherwise the cmdlet fails.
Aliases |
none |
Required? |
true |
Position? |
21 |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-Path<String>
Specifies the path to an extension package file that you want to unpublish.
Aliases |
none |
Required? |
true |
Position? |
21 |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-Publisher<String>
Specifies the publisher of the extension that you want to unpublish. The results must return only a single extension; otherwise the cmdlet fails.
Aliases |
none |
Required? |
false |
Position? |
22 |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-ServerInstance<String>
Specifies the Microsoft Dynamics NAV Server instance that you want to unpublish the extension from, such as DynamicsNAV90.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue, ByPropertyName) |
Accept Wildcard Characters? |
false |
-Version<Version>
Specifies the version of the extension that you want to unpublish. The results must return only a single extension; otherwise the cmdlet fails.
Aliases |
none |
Required? |
false |
Position? |
23 |
Default Value |
none |
Accept Pipeline Input? |
true(ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
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.
Examples
-------------------------- EXAMPLE 1 --------------------------
Description
-----------
This example removes the specified extension from the app catalog of the specified Microsoft Dynamics NAV Server instance.
PS C:\> Unpublish-NAVApp -ServerInstance DynamicsNAV90 -Name 'Proseware SmartStuff'
-------------------------- EXAMPLE 2 --------------------------
Description
-----------
This example removes the extension that is returned by the Get-NAVAppInfo cmdlet from the app catalog of the specified Microsoft Dynamics NAV Server instance.
PS C:\> Get-NAVAppInfo -ServerInstance DynamicsNAV90 -Name 'Proseware SmartStuff' -Version 2.3.4.500 | Unpublish-NAVApp
-------------------------- EXAMPLE 3 --------------------------
Description
-----------
This example removes the extension that is in the package file at the specified path from the app catalog of the specified Microsoft Dynamics NAV Server instance.
PS C:\> Unpublish-NAVApp -ServerInstance DynamicsNAV90 -Path '.\Proseware SmartApp.navx'