Set-CMPackage

  • Artykuł

SYNOPSIS

Modyfikowanie pakietu.

SYNTAX

SetByValue (wartość domyślna)

Set-CMPackage [-CopyToPackageShareOnDistributionPoint <Boolean>] [-CustomPackageShareName <String>]
 [-Description <String>] [-DisconnectUserFromDistributionPoint <Boolean>]
 [-DisconnectUserFromDistributionPointMins <UInt32>] [-DisconnectUserFromDistributionPointRetry <UInt32>]
 [-DistributionPointUpdateSchedule <IResultObject>] [-EnableBinaryDeltaReplication <Boolean>]
 [-InputObject] <IResultObject> [-Language <String>] [-Manufacturer <String>] [-MifFileName <String>]
 [-MifName <String>] [-MifPublisher <String>] [-MifVersion <String>] [-MulticastAllow <Boolean>]
 [-MulticastEncrypt <Boolean>] [-MulticastTransferOnly <Boolean>] [-NewName <String>] [-PassThru]
 [-Path <String>] [-PersistContentInCache <Boolean>] [-PrestageBehavior <PrestageBehavior>]
 [-Priority <Priorities>] [-SendToPreferredDistributionPoint <Boolean>] [-Version <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetById

Set-CMPackage [-CopyToPackageShareOnDistributionPoint <Boolean>] [-CustomPackageShareName <String>]
 [-Description <String>] [-DisconnectUserFromDistributionPoint <Boolean>]
 [-DisconnectUserFromDistributionPointMins <UInt32>] [-DisconnectUserFromDistributionPointRetry <UInt32>]
 [-DistributionPointUpdateSchedule <IResultObject>] [-EnableBinaryDeltaReplication <Boolean>] -Id <String>
 [-Language <String>] [-Manufacturer <String>] [-MifFileName <String>] [-MifName <String>]
 [-MifPublisher <String>] [-MifVersion <String>] [-MulticastAllow <Boolean>] [-MulticastEncrypt <Boolean>]
 [-MulticastTransferOnly <Boolean>] [-NewName <String>] [-PassThru] [-Path <String>]
 [-PersistContentInCache <Boolean>] [-PrestageBehavior <PrestageBehavior>] [-Priority <Priorities>]
 [-SendToPreferredDistributionPoint <Boolean>] [-Version <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetByName

Set-CMPackage [-CopyToPackageShareOnDistributionPoint <Boolean>] [-CustomPackageShareName <String>]
 [-Description <String>] [-DisconnectUserFromDistributionPoint <Boolean>]
 [-DisconnectUserFromDistributionPointMins <UInt32>] [-DisconnectUserFromDistributionPointRetry <UInt32>]
 [-DistributionPointUpdateSchedule <IResultObject>] [-EnableBinaryDeltaReplication <Boolean>]
 [-Language <String>] [-Manufacturer <String>] [-MifFileName <String>] [-MifName <String>]
 [-MifPublisher <String>] [-MifVersion <String>] [-MulticastAllow <Boolean>] [-MulticastEncrypt <Boolean>]
 [-MulticastTransferOnly <Boolean>] -Name <String> [-NewName <String>] [-PassThru] [-Path <String>]
 [-PersistContentInCache <Boolean>] [-PrestageBehavior <PrestageBehavior>] [-Priority <Priorities>]
 [-SendToPreferredDistributionPoint <Boolean>] [-Version <String>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

To polecenie cmdlet pozwala zmienić ustawienia pakietu. Aby uzyskać więcej informacji, zobacz Pakiety i programy w Menedżer konfiguracji.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: zmiana nazwy pakietu i dodanie opisu

To polecenie zmienia nazwę pakietu o identyfikatorze ST120001 na ScriptsPackage02 i dodaje opis.

Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."

Przykład 2: Zmiana ścieżki źródłowej pakietu

Pierwsze polecenie pobiera pakiet o identyfikatorze ST120001 i zapisuje wyniki w $Pkg zmiennej . Drugie polecenie zmienia ścieżkę źródłową pakietu.

$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"

PARAMETERS

-Confirm

Dodaj ten parametr, aby monitować o potwierdzenie przed rozpoczęciem pracy polecenia cmdlet.

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

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

-CopyToPackageShareOnDistributionPoint

Klienci mogą zawsze pobierać pakiet z punktu dystrybucji. Jeśli ten parametr zostanie ustawiony na wartość $true, lokacja udostępni go za pośrednictwem nazwanego udziału sieciowego w punktach dystrybucji. Użyj właściwości CustomPackageShareName, aby określić niestandardową nazwę udziału.

Po włączeniu tej opcji punkty dystrybucji będą wymagać więcej miejsca. Dotyczy to wszystkich punktów dystrybucji, do których jest dystrybuowany ten pakiet.

Type: Boolean
Parameter Sets: (All)
Aliases: ShareContent, CopyToPackageShareOnDistributionPoints

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

-CustomPackageShareName

Jeśli włączysz program CopyToPackageShareOnDistributionPoint, możesz użyć tego parametru, aby dostosować nazwę udziału. Maksymalna długość wynosi 127 znaków i nie może zawierać żadnego z następujących znaków: " / [ ] : | < > + = ; , ? * . Można określić nazwę udziału i nazwę folderu, ale maksymalna wartość dla każdego z nich to 80 znaków. Na przykład ShareName\FolderName.

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

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

-Description (Opis)

Podaj opcjonalny opis pakietu, aby ułatwić jego identyfikację. Można użyć maksymalnie 128 znaków.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DisconnectUserFromDistributionPoint

Ta opcja jest przestarzały. Ustawia właściwość ForcedDisconnectEnabled pakietu sterowników.

Type: Boolean
Parameter Sets: (All)
Aliases: ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints

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

-DisconnectUserFromDistributionPointMins

Ta opcja jest przestarzały. Ustawia właściwość ForcedDisconnectDelay pakietu sterowników.

Type: UInt32
Parameter Sets: (All)
Aliases: ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes

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

-DisconnectUserFromDistributionPointRetry

Ta opcja jest przestarzały. Ustawia właściwość ForcedDisconnectNumRetries pakietu sterowników.

Type: UInt32
Parameter Sets: (All)
Aliases: ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries

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

-DistributionPointUpdateSchedule

Użyj tego parametru, aby zaktualizować punkty dystrybucji zgodnie z harmonogramem. Aby uzyskać obiekt harmonogramu, użyj polecenia cmdlet New-CMSchedule.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-EnableBinaryDeltaReplication

Ustaw ten parametr na wartość $true, aby włączyć binarną replikację różnicową (BDR). Aby uzyskać więcej informacji, zobacz Podstawowe pojęcia związane z zarządzaniem zawartością w programie Menedżer konfiguracji.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Określ identyfikator pakietu do skonfigurowania. Ta wartość to standardowy identyfikator pakietu, na przykład: XYZ00020 .

Type: String
Parameter Sets: SetById
Aliases: PackageId

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

-InputObject

Określ obiekt pakietu do skonfigurowania. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMPackage.

Type: IResultObject
Parameter Sets: SetByValue
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Język

Określ ciąg języka dla pakietu. Można użyć maksymalnie 32 znaków w formacie używanym do identyfikowania wersji języka. Aby zidentyfikować pakiet, Menedżer konfiguracji języka, producenta, nazwy i wersji parametrów. Na przykład możesz mieć wersję w języku angielskim i niemieckiej wersji tego samego pakietu.

Type: String
Parameter Sets: (All)
Aliases:

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

-Producent

Określ nazwę producenta oprogramowania. Możesz użyć maksymalnie 32 znaków. Aby zidentyfikować pakiet, Menedżer konfiguracji języka, producenta, nazwy i wersji parametrów.

Type: String
Parameter Sets: (All)
Aliases:

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

-MifFileName

Określ nazwę pliku MIF (Management Information Format), który zawiera stan pakietu. Rozszerzenie nazwy pliku musi mieć nazwę .mif . Użyj pliku MIF stanu, aby wygenerować szczegółowe raportowanie stanu. Aby wygenerować plik MIF stanu, aplikacja musi wywołać funkcję InstallStatusMIF. Aby uzyskać więcej informacji, zobacz Status MIF Functions (Funkcje MIF stanu).

Jeśli ustawisz ten parametr, gdy klient uruchomi wdrożenie, klient usługi Menedżer konfiguracji będzie wyglądał w katalogu lub katalogu dla pliku MIF stanu instalacji, %TEMP% %windir% który określisz. Stan instalacji wskazuje, czy program został pomyślnie zainstalowany.

Jeśli klient nie znajdzie pliku, wyszuka wszystkie pliki MIF w tych katalogach. W ten sposób bez uwzględniania liter jest porównywane wartości określone dla wartości MifName, MifPublisher i MifVersion z wartościami, które określa plik MIF. Jeśli klient znajdzie dopasowanie, użyje stanu, który plik MIF określa jako stan instalacji programu. Jeśli nie można znaleźć dopasowania lub jeśli nie określisz wartości MifFileName, klient ustawi stan instalacji programu za pomocą kodu zakończenia programu. Kod zakończenia zero oznacza, że program został pomyślnie uruchomiono. Wszelkie inne wartości wskazują kody błędów specyficzne dla aplikacji.

Type: String
Parameter Sets: (All)
Aliases:

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

-MifName

Określ nazwę pakietu do dopasowania mifów (maksymalnie 50 znaków). Aby uzyskać więcej informacji, zobacz MifFileName parametru.

Type: String
Parameter Sets: (All)
Aliases:

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

-MifPublisher

Określ wydawcę oprogramowania pakietu do dopasowania mifów (maksymalnie 32 znaki). Aby uzyskać więcej informacji, zobacz MifFileName parametru.

Type: String
Parameter Sets: (All)
Aliases:

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

-MifVersion

Określ numer wersji pakietu do dopasowania mifów (maksymalnie 32 znaki). Aby uzyskać więcej informacji, zobacz MifFileName parametru.

Type: String
Parameter Sets: (All)
Aliases:

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

-MulticastAllow

Ustaw ten parametr na $true, aby umożliwić transfer tego pakietu za pośrednictwem multiemisji. Aby uzyskać więcej informacji, zobacz Use multicast to deploy Windows over the network with Menedżer konfiguracji.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-MulticastEncrypt

Jeśli włączysz opcję MulticastAllow, ustaw ten parametr na wartość $true szyfrowania pakietów multiemisji.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-MulticastTransferOnly

Jeśli włączysz multiemisjęAllow, ustaw ten parametr na wartość $true tylko do transferu tego pakietu sterowników za pośrednictwem multiemisji.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Określ nazwę pakietu. Można użyć maksymalnie 250 znaków. Aby zidentyfikować pakiet, Menedżer konfiguracji języka, producenta, nazwy i wersji parametrów.

Type: String
Parameter Sets: SetByName
Aliases:

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

-NewName

Użyj tego parametru, aby zmienić nazwę pakietu.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Dodaj ten parametr, aby zwrócić obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet może nie generować żadnych danych wyjściowych.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Path

Jeśli pakiet zawiera pliki źródłowe, określ lokalizację plików. Można określić pełną ścieżkę lokalną na serwerze lokacji lub ścieżkę sieciową. Upewnij się, że ta lokalizacja zawiera wszystkie pliki i podkatalogi, które program musi uruchomić, w tym wszystkie skrypty.

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

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

-PersistContentInCache

Jeśli nie chcesz, aby zawartość tego pakietu starzeła się z pamięci podręcznej klienta, aby zrobić miejsce na inną zawartość, ustaw ten parametr na wartość $true, aby utrwalić ją w pamięci podręcznej klienta.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-PrestageBehavior

Określ zachowanie podczas włączania punktu dystrybucji dla wstępnie przygotowanej zawartości:

  • ManualCopy: ręcznie skopiuj zawartość tego pakietu do punktu dystrybucji
  • DownloadDelta: pobieranie tylko zmian zawartości do punktu dystrybucji
  • OnDemand: automatycznie pobiera zawartość po przypisaniu pakietów do punktów dystrybucji

Aby uzyskać więcej informacji, zobacz Używanie wstępnie przygotowanej zawartości.

Type: PrestageBehavior
Parameter Sets: (All)
Aliases:
Accepted values: ManualCopy, DownloadDelta, OnDemand

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

-Priorytet

Określ kolejność, w jakiej lokacja wysyła zawartość do innych lokacji i punktów dystrybucji w tej lokacji.

Witryna wysyła zawartość o wysokim priorytecie przed pakietami o normalnym lub niskim priorytecie. Pakiety o równym priorytecie są wysyłane w kolejności, w której zostały utworzone.

Type: Priorities
Parameter Sets: (All)
Aliases: DistributionPriority
Accepted values: High, Normal, Low

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

-SendToPreferredDistributionPoint

Jeśli chcesz włączyć dystrybucję zawartości na żądanie do preferowanych punktów dystrybucji, ustaw ten parametr na wartość $true. Jeśli po włączeniu tego ustawienia klient zażąda zawartości pakietu, a zawartość nie jest dostępna w żadnym punkcie dystrybucji, punkt zarządzania dystrybuuje zawartość. Aby uzyskać więcej informacji, zobacz Dystrybucja zawartości na żądanie.

Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints

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

-Wersja

Określ numer wersji oprogramowania. Maksymalna długość tego ciągu to 32 znaki. Aby zidentyfikować pakiet, Menedżer konfiguracji języka, producenta, nazwy i wersji parametrów.

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

UWAGI

Export-CMPackage

Get-CMPackage

Import-CMPackage

New-CMPackage

Remove-CMPackage

Pakiety i programy w Menedżer konfiguracji