Udostępnij za pośrednictwem

New-CMApplicationGroup

  • Artykuł

SYNOPSIS

Utwórz nową grupę aplikacji.

SYNTAX

New-CMApplicationGroup [-Name] <String> -AddApplication <String[]> [-Description <String>]
 [-Publisher <String>] [-SoftwareVersion <String>] [-OptionalReference <String>] [-ReleaseDate <DateTime>]
 [-AddOwner <String[]>] [-AddSupportContact <String[]>] [-AppGroupCatalog <AppDisplayInfo[]>]
 [-DefaultLanguageId <Int32>] [-LocalizedName <String>] [-UserDocumentation <String>] [-LinkText <String>]
 [-PrivacyUrl <String>] [-LocalizedDescription <String>] [-Keyword <String[]>] [-IconLocationFile <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

To polecenie cmdlet umożliwia utworzenie grupy aplikacji. Użyj grupy aplikacji, aby wdrożyć wiele aplikacji w kolekcji jako pojedyncze wdrożenie. Określone metadane dotyczące grupy aplikacji są widoczne w Centrum oprogramowania jako pojedyncza jednostka. Aplikacje w grupie można uporządkować tak, aby klient instalał je w określonej kolejności. Aby uzyskać więcej informacji, zobacz Tworzenie grup aplikacji.

Istnieją pewne ustawienia grupy aplikacji, których nie można skonfigurować podczas jej tworzenia. Aby skonfigurować inne ustawienia, użyj polecenia cmdlet Set-CMApplicationGroup.

Uwaga

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

EXAMPLES

Przykład 1: tworzenie grupy z dwiema aplikacjami

Ten przykład obejmuje tworzenie nowej grupy aplikacji o nazwie Aplikacja centralna, która zawiera dwie aplikacje.

$apps = @('LOB Framework','CA UI')

New-CMApplicationGroup -Name 'Central app' -AddApplication $apps -Description 'Central app group' -Publisher 'Contoso IT' -SoftwareVersion '1.1.2' -ReleaseDate (Get-Date) -AddOwner 'jqpublic' -AddSupportContact 'jdoe' -LocalizedAppGroupName 'Central app'

PARAMETERS

-AddApplication

Określ tablicę ciągów nazw aplikacji do dodania do grupy. Jeśli masz już obiekt aplikacji z innego polecenia cmdlet, takiego jak Get-CMApplication,ta wartość jest właściwością LocalizedDisplayName. Na przykład: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)

Type: String[]
Parameter Sets: (All)
Aliases: AddApplications

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

-AddOwner

Określ co najmniej jednego użytkownika administracyjnego odpowiedzialnego za tę grupę aplikacji.

Type: String[]
Parameter Sets: (All)
Aliases: AddOwners

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

-AddSupportContact

Określ co najmniej jednego użytkownika administracyjnego, z który użytkownicy końcowi mogą kontaktować się w celu pomocy dotyczącej tej aplikacji.

Type: String[]
Parameter Sets: (All)
Aliases: AddSupportContacts

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

-AppGroupCatalog

Użyj tego parametru, aby określić wpis Centrum oprogramowania dla określonego języka. Ten wpis może zawierać wszystkie zlokalizowane informacje o grupie aplikacji:

  • Opis
  • IconLocationFile
  • Słowo kluczowe
  • LinkText
  • PrivacyUrl
  • Tytuł
  • UserDocumentation

Aby uzyskać ten obiekt, użyj polecenia cmdlet New-CMApplicationDisplayInfo.

Type: AppDisplayInfo[]
Parameter Sets: (All)
Aliases: AppCatalogs

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-DefaultLanguageId

Określ identyfikator języka domyślnego języka Centrum oprogramowania.

Ten identyfikator jest dziesiętnym odpowiednikiem Windows identyfikatora języka. Na przykład jest 1033 w przypadku języka angielskiego 0x0409 (Stany Zjednoczone) i dla 2108 Języka Angielskiego 0x083C (Holandia). Aby uzyskać więcej informacji, zobacz [MS-LCID]: Windows Language Code Identifier (LCID) Reference ( [MS-LCID]: Windows Identyfikator kodu języka (LCID) — odwołanie.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Description (Opis)

Określ opcjonalny komentarz administratora dla grupy aplikacji. Maksymalna długość to 2048 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 znaków literału. 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

-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

-IconLocationFile

Określ ścieżkę do pliku, który zawiera ikonę dla tej grupy aplikacji. Ikony mogą mieć wymiary pikseli o wymiarach do 512 x 512. Plik może mieć następujące typy plików obrazów i ikon:

  • DLL
  • Exe
  • JPG
  • Ico
  • PNG
Type: String
Parameter Sets: (All)
Aliases:

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

-— Słowo kluczowe

Określ listę słów kluczowych w wybranym języku. Te słowa kluczowe ułatwiają użytkownikom Centrum oprogramowania wyszukiwanie grupy aplikacji.

Porada

Aby dodać wiele słów kluczowych, użyj ogranicznika CultureInfo.CurrentCulture.TextInfo.ListSeparator.

Type: String[]
Parameter Sets: (All)
Aliases: Keywords

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

-LinkText

Jeśli używasz parametru UserDocumentation, użyj tego parametru, aby wyświetlić ciąg w miejscu "Dodatkowe informacje" w Centrum oprogramowania. Maksymalna długość wynosi 128 znaków.

Type: String
Parameter Sets: (All)
Aliases:

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

-LocalizedDescription

Określ opis tej grupy aplikacji w wybranym języku. Maksymalna długość to 2048 znaków.

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

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

-LocalizedName

Określ nazwę grupy aplikacji w wybranym języku. Ta nazwa jest wyświetlana w Centrum oprogramowania.

Nazwa jest wymagana dla każdego języka, który dodajesz.

Maksymalna długość wynosi 256 znaków.

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

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

-Name

Określ nazwę grupy aplikacji. Maksymalna długość wynosi 256 znaków.

Type: String
Parameter Sets: (All)
Aliases: LocalizedDisplayName, ApplicationGroupName

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

-OptionalReference

Określ opcjonalny ciąg, aby ułatwić znalezienie grupy aplikacji w konsoli. Maksymalna długość wynosi 256 znaków.

Type: String
Parameter Sets: (All)
Aliases:

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

-PrivacyUrl

Określ adres witryny internetowej w zasadach zachowania poufności informacji dla grupy aplikacji. Format musi być prawidłowym adresem URL, na przykład https://contoso.com/privacy . Maksymalna długość całego ciągu to 128 znaków.

Type: String
Parameter Sets: (All)
Aliases:

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

-Publisher

Określ opcjonalne informacje o dostawcy dla tej grupy aplikacji. Maksymalna długość wynosi 256 znaków.

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

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

-ReleaseDate

Określ obiekt daty wydania tej grupy aplikacji. Aby uzyskać ten obiekt, użyj wbudowanego polecenia cmdlet Get-Date.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-SoftwareVersion

Określ opcjonalny ciąg wersji dla grupy aplikacji. Maksymalna długość wynosi 64 znaki.

Type: String
Parameter Sets: (All)
Aliases:

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

-UserDocumentation

Określ lokalizację pliku, z którego użytkownicy Centrum oprogramowania mogą uzyskać więcej informacji na temat tej grupy aplikacji. Ta lokalizacja to adres witryny internetowej lub ścieżka sieciowa i nazwa pliku. Upewnij się, że użytkownicy mają dostęp do tej lokalizacji.

Maksymalna długość całego ciągu to 256 znakó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: None
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

Brak

OUTPUTS

IResultObject#SMS_ApplicationGroup

UWAGI

To polecenie cmdlet zwraca SMS_ApplicationGroup klasy WMI.

Get-CMApplicationGroup Remove-CMApplicationGroup Set-CMApplicationGroup

New-CMApplicationDisplayInfo

Get-CMApplicationGroupDeployment New-CMApplicationGroupDeployment Remove-CMApplicationGroupDeployment Set-CMApplicationGroupDeployment

Tworzenie grup aplikacji