Set-CMThirdPartyUpdateCatalog

修改第三方更新目录。

语法

Set-CMThirdPartyUpdateCatalog
   [-Description <String>]
   [-Force]
   [[-Name] <String>]
   [-NewName <String>]
   [-PassThru]
   [-PublisherName <String>]
   [-Schedule <IResultObject>]
   [-Subscribe]
   [-SupportContact <String>]
   [-SupportUrl <Uri>]
   [-SyncNow]
   [-Unsubscribe]
   [-CategoryNamePublishOption <Hashtable>]
   [-CategoryIdPublishOption <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMThirdPartyUpdateCatalog
   [-Description <String>]
   [-Force]
   [-Id] <String>
   [-NewName <String>]
   [-PassThru]
   [-PublisherName <String>]
   [-Schedule <IResultObject>]
   [-Subscribe]
   [-SupportContact <String>]
   [-SupportUrl <Uri>]
   [-SyncNow]
   [-Unsubscribe]
   [-CategoryNamePublishOption <Hashtable>]
   [-CategoryIdPublishOption <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMThirdPartyUpdateCatalog
   [-Description <String>]
   [-Force]
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-PublisherName <String>]
   [-Schedule <IResultObject>]
   [-Subscribe]
   [-SupportContact <String>]
   [-SupportUrl <Uri>]
   [-SyncNow]
   [-Unsubscribe]
   [-CategoryNamePublishOption <Hashtable>]
   [-CategoryIdPublishOption <Hashtable>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 修改第三方更新目录。 有关详细信息,请参阅 启用第三方更新

注意

从Configuration Manager站点驱动器运行Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:重命名第三方更新目录

此示例按名称获取第三方更新目录,然后更改名称。

Set-CMThirdPartyUpdateCatalog -Name "Contoso updates" -NewName "Contoso update catalog"

示例 2:更改说明

此示例按 对象获取第三方更新目录,然后更改说明。

Set-CMThirdPartyUpdateCatalog -ThirdPartyUpdateCatalog $catalog -Description "All of the current Contoso hardware updates"

示例 3:更改支持信息

此示例获取命令行上通过管道传递的第三方更新目录,然后更改支持联系人和 URL。

$catalog | Set-CMThirdPartyUpdateCatalog -SupportContact "Contoso hardware support" -SupportUrl "https://hardware.contoso.com"

示例 4:设置 v3 目录的类别发布选项

此示例演示了在订阅 v3 目录时创建用于设置类别的哈希表的语法。

$id = "5768207d-6c40-465b-ad65-50501661368f"
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$idOptionPair = @{$id = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName 'pmp' -CategoryIdPublishOption $idOptionPair -Subscribe -Force

$name = "2BrightSparks"
$name1 = "8x8, Inc."
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$nameOptionPair = @{$name = $option; $name1 = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName 'pmp' -CategoryNamePublishOption $nameOptionPair -Subscribe -Force

参数

-CategoryIdPublishOption

在订阅 v3 目录时设置类别 ID 发布选项。

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

-CategoryNamePublishOption

在订阅 v3 目录时设置类别名称发布选项。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Description

指定第三方更新目录的说明。

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

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

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

-Force

运行命令而不要求确认。

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

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为。 不建议这样做。 不能将其与 DisableWildcardHandling 结合使用。

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

-Id

指定要更改的第三方更新目录的 ID。

Type:String
Aliases:CatalogId
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

指定要更改的第三方更新目录的对象。 若要获取此对象,请使用 Get-CMThirdPartyUpdateCatalog cmdlet。

Type:IResultObject
Aliases:ThirdPartyUpdateCatalog
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定要更改的第三方更新目录的名称。

Type:String
Aliases:CatalogName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-NewName

重命名选定的第三方更新目录。

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

-PassThru

添加此参数可返回一个对象,该对象表示正在使用的项。 默认情况下,此 cmdlet 可能不会生成任何输出。

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

-PublisherName

更改指定的第三方更新目录的发布者名称。

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

-Schedule

指定要应用于指定的第三方更新目录的计划对象。 自定义计划将替代默认同步计划,并且仅适用于订阅的目录。

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

-Subscribe

将站点配置为订阅第三方更新目录。 此参数与 订阅目录的控制台操作相同。

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

-SupportContact

更改指定第三方更新目录的支持联系人。

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

-SupportUrl

更改指定的第三方更新目录的支持 URL。

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

-SyncNow

触发站点以同步指定的第三方更新目录。 此参数与 立即同步的控制台操作相同。

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

-Unsubscribe

将站点配置为取消订阅第三方更新目录。 此参数与取消 订阅目录的控制台操作相同。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

此 cmdlet 返回 SMS_ISVCatalogs WMI 类的对象。