Condividi tramite

New-CMApplicationGroup

  • Riferimento
Modulo:
ConfigurationManager

Creare un nuovo gruppo di applicazioni.

Sintassi

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>]

Descrizione

Usare questo cmdlet per creare un gruppo di applicazioni. Usare un gruppo di applicazioni per distribuire più applicazioni in una raccolta come singola distribuzione. I metadati specificati per il gruppo di app vengono visualizzati in Software Center come una singola entità. È possibile ordinare le app nel gruppo in modo che il client le installi in un ordine specifico. Per altre informazioni, vedere Creare gruppi di applicazioni.

Esistono alcune impostazioni di un gruppo di app che non è possibile configurare durante la creazione. Per configurare altre impostazioni, usare il cmdlet Set-CMApplicationGroup .

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Creare un gruppo con due app

Questo esempio crea un nuovo gruppo di app denominato App centrale che include due app.

$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'

Parametri

-AddApplication

Specificare una matrice di stringhe di nomi di app da aggiungere al gruppo. Se si dispone già di un oggetto app da un altro cmdlet come Get-CMApplication, questo valore è la proprietà LocalizedDisplayName . Ad esempio: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)

Tipo:String[]
Alias:AddApplications
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddOwner

Specificare uno o più utenti amministratori responsabili di questo gruppo di app.

Tipo:String[]
Alias:AddOwners
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddSupportContact

Specificare uno o più utenti amministratori che gli utenti finali possono contattare per ottenere assistenza con questa applicazione.

Tipo:String[]
Alias:AddSupportContacts
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AppGroupCatalog

Usare questo parametro per specificare una voce di Software Center per una lingua specifica. Questa voce può includere tutte le informazioni localizzate sul gruppo di app:

  • Descrizione
  • IconLocationFile
  • Parola chiave
  • LinkText
  • PrivacyUrl
  • Titolo
  • UserDocumentation

Per ottenere questo oggetto, usare il cmdlet New-CMApplicationDisplayInfo .

Tipo:AppDisplayInfo[]
Alias:AppCatalogs
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultLanguageId

Specificare l'ID lingua per la lingua predefinita di Software Center.

Questo ID è l'equivalente decimale dell'ID lingua windows. Ad esempio, 1033 è 0x0409 per l'inglese (Stati Uniti) e 2108 per 0x083Cl'irlandese (Irlanda). Per altre informazioni, vedere [MS-LCID]: Informazioni di riferimento sull'identificatore LCID (Windows Language Code Identifier).

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specificare un commento di amministratore facoltativo per il gruppo di app. La lunghezza massima è di 2048 caratteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IconLocationFile

Specificare il percorso del file che contiene l'icona per questo gruppo di app. Le icone possono avere dimensioni in pixel fino a 512x512. Il file può essere dei tipi di file di immagine e icona seguenti:

  • DLL
  • EXE
  • JPG
  • ICO
  • PNG
Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Keyword

Specificare un elenco di parole chiave nella lingua selezionata. Queste parole chiave consentono agli utenti di Software Center di cercare il gruppo di app.

Consiglio

Per aggiungere più parole chiave, usare CultureInfo.CurrentCulture.TextInfo.ListSeparator come delimitatore.

Tipo:String[]
Alias:Keywords
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LinkText

Quando si usa il parametro UserDocumentation , usare questo parametro per visualizzare una stringa al posto di "Informazioni aggiuntive" in Software Center. La lunghezza massima è 128 caratteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LocalizedDescription

Specificare una descrizione per questo gruppo di app nella lingua selezionata. La lunghezza massima è di 2048 caratteri.

Tipo:String
Alias:LocalizedAppGroupDescription
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LocalizedName

Specificare il nome del gruppo di app nella lingua selezionata. Questo nome viene visualizzato in Software Center.

È necessario un nome per ogni lingua aggiunta.

La lunghezza massima è 256 caratteri.

Tipo:String
Alias:LocalizedAppGroupName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare un nome per il gruppo di app. La lunghezza massima è 256 caratteri.

Tipo:String
Alias:LocalizedDisplayName, ApplicationGroupName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OptionalReference

Specificare una stringa facoltativa che consente di trovare il gruppo di app nella console. La lunghezza massima è 256 caratteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PrivacyUrl

Specificare un indirizzo del sito Web per l'informativa sulla privacy per il gruppo di app. Il formato deve essere un URL valido, ad esempio https://contoso.com/privacy. La lunghezza massima dell'intera stringa è di 128 caratteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Publisher

Specificare le informazioni facoltative sul fornitore per questo gruppo di app. La lunghezza massima è 256 caratteri.

Tipo:String
Alias:Manufacturer
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ReleaseDate

Specificare un oggetto data per quando questo gruppo di app è stato rilasciato. Per ottenere questo oggetto, usare il cmdlet predefinito Get-Date .

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SoftwareVersion

Specificare una stringa di versione facoltativa per il gruppo di app. La lunghezza massima è 64 caratteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserDocumentation

Specificare il percorso di un file da cui gli utenti di Software Center possono ottenere altre informazioni su questo gruppo di app. Questo percorso è un indirizzo del sito Web o un percorso di rete e un nome file. Assicurarsi che gli utenti abbiano accesso a questa posizione.

La lunghezza massima dell'intera stringa è di 256 caratteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject

Note

Questo cmdlet restituisce l'oggetto classe WMI SMS_ApplicationGroup .