Uninstall-PSResource

  • Ссылка
Модуль:
Microsoft.PowerShell.PSResourceGet

Удаляет ресурс, установленный с помощью PowerShellGet.

Синтаксис

Uninstall-PSResource
         [-Name] <String[]>
         [-Version <String>]
         [-Prerelease]
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-PSResource
         [-Prerelease]
         [-InputObject] <PSResourceInfo[]>
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Описание

Этот командлет объединяет функциональные возможности командлетов Uninstall-Module и Uninstall-Script из PowerShellGet версии 2. Командлет выполняет поиск ресурсов с XML-файлом метаданных PowerShellGet по путям установки пакета. Соответствующие ресурсы удаляются из системы.

По умолчанию командлет проверяет, является ли удаляемый ресурс зависимостью для другого ресурса.

Примеры

Пример 1

Удалите последнюю версию модуля Az .

Uninstall-PSResource Az

Пример 2

Удалите определенную версию модуля Az .

Uninstall-PSResource -name Az -version "5.0.0"

Пример 3

Удаляет все версии модуля Az в указанном диапазоне версий.

Uninstall-PSResource -name Az -version "(5.0.0, 7.5.0)"

Пример 4

В этом примере предполагается, что следующие версии модуля Az уже установлены:

  • 4.0.1-Preview
  • 4.1.0
  • 4.0.2 (предварительная версия)

Командлет Uninstall-PSResource удаляет стабильную и предварительную версию, которая относится к указанному диапазону версий. В соответствии с правилами NuGetVersion предварительная версия меньше стабильной версии, поэтому версия 4.0.1-preview фактически меньше, чем версия 4.0.1 в указанном диапазоне. Поэтому версия 4.0.1-preview не удаляется. Версии 4.1.0 и 4.0.2-preview удаляются, так как они находятся в диапазоне.

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]"

Пример 5

В этом примере предполагается, что следующие версии модуля Az уже установлены:

  • 4.0.1-Preview
  • 4.1.0
  • 4.0.2 (предварительная версия)

Это аналогично предыдущему примеру, за исключением того, что параметр Prerelease означает, что удаляются только предварительные версии. Удаляется только версия 4.0.2-preview, так как версия 4.0.1-preview выходит за пределы диапазона, а версия 4.1.0 не является предварительной версией.

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]" -Prerelease

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Используется для входных данных конвейера.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Имя удаляемого ресурса или ресурсов. Поддерживаются подстановочные знаки, но NuGet принимает * только символ.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Prerelease

Указывает, что следует удалить только ресурсы предварительной версии.

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

-Scope

Указывает область удаляемого ресурса.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

По умолчанию командлет проверяет, является ли удаляемый ресурс зависимостью для другого ресурса. При использовании этого параметра тест зависимостей пропускается.

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

-Version

Указывает версию удаляемого ресурса. Значение может быть точной версией или диапазоном версий с помощью синтаксиса управления версиями NuGet.

Дополнительные сведения о диапазонах версий NuGet см. в разделе Управление версиями пакетов.

PowerShellGet поддерживает все версии, кроме минимальной инклюзивной версии , перечисленные в документации по диапазону версий NuGet. Использование 1.0.0.0 в качестве версии не дает версий 1.0.0.0 и выше (минимальный диапазон включительно). Вместо этого значение считается обязательной версией. Для поиска минимального инклюзивного диапазона используйте [1.0.0.0, ] в качестве диапазона версий.

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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Выходные данные

Object