Set-CMApplicationGroup
Configurare un gruppo di applicazioni esistente.
Sintassi
Set-CMApplicationGroup
[-InputObject] <IResultObject>
[-NewName <String>]
[-Description <String>]
[-Publisher <String>]
[-SoftwareVersion <String>]
[-OptionalReference <String>]
[-AddAppCategory <IResultObject[]>]
[-RemoveAppCategoryName <String[]>]
[-CleanAppCategory]
[-ReleaseDate <DateTime>]
[-AddOwner <String[]>]
[-RemoveOwner <String[]>]
[-ClearOwner]
[-AddSupportContact <String[]>]
[-RemoveSupportContact <String[]>]
[-ClearSupportContact]
[-AddAppCatalog <AppDisplayInfo[]>]
[-RemoveAppCatalog <Int32[]>]
[-ClearAppCatalog]
[-DefaultLanguageId <Int32>]
[-ApplyToLanguageById <Int32>]
[-LocalizedName <String>]
[-AddUserCategory <IResultObject[]>]
[-RemoveUserCategoryName <String[]>]
[-CleanUserCategory]
[-UserDocumentation <String>]
[-LinkText <String>]
[-PrivacyUrl <String>]
[-LocalizedDescription <String>]
[-Keyword <String[]>]
[-IconLocationFile <String>]
[-AddApplication <String[]>]
[-RemoveApplication <String[]>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMApplicationGroup
[-Id] <Int32>
[-NewName <String>]
[-Description <String>]
[-Publisher <String>]
[-SoftwareVersion <String>]
[-OptionalReference <String>]
[-AddAppCategory <IResultObject[]>]
[-RemoveAppCategoryName <String[]>]
[-CleanAppCategory]
[-ReleaseDate <DateTime>]
[-AddOwner <String[]>]
[-RemoveOwner <String[]>]
[-ClearOwner]
[-AddSupportContact <String[]>]
[-RemoveSupportContact <String[]>]
[-ClearSupportContact]
[-AddAppCatalog <AppDisplayInfo[]>]
[-RemoveAppCatalog <Int32[]>]
[-ClearAppCatalog]
[-DefaultLanguageId <Int32>]
[-ApplyToLanguageById <Int32>]
[-LocalizedName <String>]
[-AddUserCategory <IResultObject[]>]
[-RemoveUserCategoryName <String[]>]
[-CleanUserCategory]
[-UserDocumentation <String>]
[-LinkText <String>]
[-PrivacyUrl <String>]
[-LocalizedDescription <String>]
[-Keyword <String[]>]
[-IconLocationFile <String>]
[-AddApplication <String[]>]
[-RemoveApplication <String[]>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMApplicationGroup
-ModelName <String>
[-NewName <String>]
[-Description <String>]
[-Publisher <String>]
[-SoftwareVersion <String>]
[-OptionalReference <String>]
[-AddAppCategory <IResultObject[]>]
[-RemoveAppCategoryName <String[]>]
[-CleanAppCategory]
[-ReleaseDate <DateTime>]
[-AddOwner <String[]>]
[-RemoveOwner <String[]>]
[-ClearOwner]
[-AddSupportContact <String[]>]
[-RemoveSupportContact <String[]>]
[-ClearSupportContact]
[-AddAppCatalog <AppDisplayInfo[]>]
[-RemoveAppCatalog <Int32[]>]
[-ClearAppCatalog]
[-DefaultLanguageId <Int32>]
[-ApplyToLanguageById <Int32>]
[-LocalizedName <String>]
[-AddUserCategory <IResultObject[]>]
[-RemoveUserCategoryName <String[]>]
[-CleanUserCategory]
[-UserDocumentation <String>]
[-LinkText <String>]
[-PrivacyUrl <String>]
[-LocalizedDescription <String>]
[-Keyword <String[]>]
[-IconLocationFile <String>]
[-AddApplication <String[]>]
[-RemoveApplication <String[]>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMApplicationGroup
[-Name] <String>
[-NewName <String>]
[-Description <String>]
[-Publisher <String>]
[-SoftwareVersion <String>]
[-OptionalReference <String>]
[-AddAppCategory <IResultObject[]>]
[-RemoveAppCategoryName <String[]>]
[-CleanAppCategory]
[-ReleaseDate <DateTime>]
[-AddOwner <String[]>]
[-RemoveOwner <String[]>]
[-ClearOwner]
[-AddSupportContact <String[]>]
[-RemoveSupportContact <String[]>]
[-ClearSupportContact]
[-AddAppCatalog <AppDisplayInfo[]>]
[-RemoveAppCatalog <Int32[]>]
[-ClearAppCatalog]
[-DefaultLanguageId <Int32>]
[-ApplyToLanguageById <Int32>]
[-LocalizedName <String>]
[-AddUserCategory <IResultObject[]>]
[-RemoveUserCategoryName <String[]>]
[-CleanUserCategory]
[-UserDocumentation <String>]
[-LinkText <String>]
[-PrivacyUrl <String>]
[-LocalizedDescription <String>]
[-Keyword <String[]>]
[-IconLocationFile <String>]
[-AddApplication <String[]>]
[-RemoveApplication <String[]>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Utilizzare questo cmdlet per configurare le impostazioni di un gruppo di applicazioni esistente. Usa un gruppo di app per distribuire più applicazioni in una raccolta come singola distribuzione. I metadati specificati per il gruppo di app vengono visti in Software Center come una singola entità. Puoi ordinare le app nel gruppo in modo che il client le installi in un ordine specifico. Per ulteriori informazioni, vedere Create application groups.
Nota
Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>
. Per ulteriori informazioni, vedere Introduzione.
Esempio
Esempio 1: Rinominare un gruppo di app
Questo esempio ottiene un oggetto per il gruppo di app e lo passa a questo cmdlet per rinominarlo.
$appgroup = Get-CMApplicationGroup -Name "Central app"
Set-CMApplicationGroup -InputObject $appgroup -NewName "Contoso Central App"
Esempio 2: Aggiungere un nome localizzato
Questo esempio configura il gruppo di app con un nome di app localizzato per la lingua irlandese.
Set-CMApplicationGroup -Name "Contoso Welcome app" -ApplyToLanguageById 60 -LocalizedName "Fáilte romhat"
Parametri
-AddAppCatalog
Utilizzare 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, utilizzare il cmdlet New-CMApplicationDisplayInfo.
Type: | AppDisplayInfo[] |
Aliases: | AppCatalogs |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddAppCategory
Specifica uno o più oggetti categoria amministrativa per filtrare e trovare il gruppo di app nella console. Per ottenere questi oggetti, utilizzare il cmdlet Get-CMCategory. Queste categorie sono di tipo AppCategories.
Per aggiungere categorie che consentono agli utenti di filtrare e trovare le applicazioni in Software Center, utilizzare il parametro AddUserCategory.
Type: | IResultObject[] |
Aliases: | AddAppCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddApplication
Specifica una matrice di stringhe di nomi di app da aggiungere al gruppo. Se si dispone già di un oggetto app di un altro cmdlet come Get-CMApplication,questo valore è la proprietà LocalizedDisplayName. Ad esempio: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)
Type: | String[] |
Aliases: | AddApplications |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddOwner
Specifica uno o più utenti amministrativi responsabili di questo gruppo di app.
Type: | String[] |
Aliases: | AddOwners |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddSupportContact
Specificare uno o più utenti amministrativi che gli utenti finali possono contattare per ottenere assistenza con questa applicazione.
Type: | String[] |
Aliases: | AddSupportContacts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddUserCategory
Specifica uno o più oggetti categoria utente per filtrare e trovare il gruppo di app nella console. Per ottenere questi oggetti, utilizzare il cmdlet Get-CMCategory. Queste categorie sono di tipo CatalogCategories.
Per aggiungere categorie che consentono agli utenti di filtrare e trovare le applicazioni in Software Center, utilizzare il parametro AddAppCategory.
Type: | IResultObject[] |
Aliases: | AddUserCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplyToLanguageById
Per le impostazioni visualizzate in Software Center, utilizzare questo parametro per specificare l'ID lingua per le impostazioni.
Questo ID è l'equivalente decimale dell'ID Windows lingua. Ad esempio, 1033
è 0x0409
per inglese (Stati Uniti) e per irlandese 2108
0x083C
(Irlanda). Per ulteriori informazioni, vedere [MS-LCID]: Windows riferimento LCID (Language Code Identifier).
Ad esempio, per aggiungere un nome di app localizzato per l'irlandese (Irlanda):
-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"
Type: | Int32 |
Aliases: | ApplySettingToSpecificLanguage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CleanAppCategory
Aggiungere questo parametro per rimuovere tutte le categorie amministrative. Per rimuovere una singola categoria, utilizzare il parametro RemoveAppCategory.
Type: | SwitchParameter |
Aliases: | CleanAppCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CleanUserCategory
Aggiungere questo parametro per rimuovere tutte le categorie di utenti. Per rimuovere una singola categoria, utilizzare il parametro RemoveUserCategory.
Type: | SwitchParameter |
Aliases: | CleanUserCategories |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearAppCatalog
Aggiungere questo parametro per rimuovere tutte le voci localizzate di Software Center. Per rimuovere una singola voce, utilizzare il parametro RemoveAppCatalog.
Type: | SwitchParameter |
Aliases: | ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearOwner
Aggiungere questo parametro per rimuovere tutti i proprietari. Per rimuovere un singolo proprietario, utilizzare il parametro RemoveOwner.
Type: | SwitchParameter |
Aliases: | CleanOwners |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearSupportContact
Aggiungere questo parametro per rimuovere tutti i contatti di supporto. Per rimuovere un singolo contatto, utilizzare il parametro RemoveSupportContact.
Type: | SwitchParameter |
Aliases: | CleanSupportContacts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultLanguageId
Specificare l'ID lingua per la lingua predefinita di Software Center.
Questo ID è l'equivalente decimale dell'ID Windows lingua. Ad esempio, 1033
è 0x0409
per inglese (Stati Uniti) e per irlandese 2108
0x083C
(Irlanda). Per ulteriori informazioni, vedere [MS-LCID]: Windows riferimento LCID (Language Code Identifier).
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Specifica un commento amministratore facoltativo per il gruppo di app. La lunghezza massima è 2048 caratteri.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IconLocationFile
Specifica 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 immagine e icona seguenti:
- DLL
- EXE
- JPG
- ICO
- PNG
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Specifica l'ID del gruppo di app da configurare. Questo valore è lo stesso del CI_ID, ad esempio 1025866
.
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifica un oggetto gruppo di app da configurare. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMApplicationGroup.
Type: | IResultObject |
Aliases: | ApplicationGroup |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Suggerimento
Per aggiungere più parole chiave, utilizzare CultureInfo.CurrentCulture.TextInfo.ListSeparator come delimitatore.
Type: | String[] |
Aliases: | Keywords |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LinkText
Quando si utilizza il parametro UserDocumentation, utilizzare questo parametro per visualizzare una stringa al posto di "Informazioni aggiuntive" in Software Center. La lunghezza massima è 128 caratteri.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalizedDescription
Specifica una descrizione per questo gruppo di app nella lingua selezionata. La lunghezza massima è 2048 caratteri.
Type: | String |
Aliases: | LocalizedAppGroupDescription |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalizedName
Specifica 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.
Type: | String |
Aliases: | LocalizedAppGroupName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModelName
Specifica l'identificatore del modello di applicazione del gruppo di app da configurare. Questo valore è noto anche come CI Unique ID. Ad esempio, ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specifica il nome del gruppo di app da configurare.
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationGroupName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Usa questo parametro per rinominare il gruppo di app. La lunghezza massima è 256 caratteri.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OptionalReference
Specifica una stringa facoltativa per trovare il gruppo di app nella console. La lunghezza massima è 256 caratteri.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivacyUrl
Specifica 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.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Publisher
Specifica informazioni facoltative sul fornitore per questo gruppo di app. La lunghezza massima è 256 caratteri.
Type: | String |
Aliases: | Manufacturer |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReleaseDate
Specifica un oggetto data per il rilascio di questo gruppo di app. Per ottenere questo oggetto, utilizzare il cmdlet incorporato Get-Date.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveAppCatalog
Specificare una matrice di ID lingua per rimuovere le voci software center associate. Per rimuovere tutte le voci, utilizzare il parametro ClearAppCatalog.
Questo ID è l'equivalente decimale dell'ID Windows lingua. Ad esempio, 1033
è 0x0409
per inglese (Stati Uniti) e per irlandese 2108
0x083C
(Irlanda). Per ulteriori informazioni, vedere [MS-LCID]: Windows riferimento LCID (Language Code Identifier).
Ad esempio, per rimuovere la voce localizzata Software Center per Irlanda (Irlanda):
-RemoveAppCatalog 2108
Type: | Int32[] |
Aliases: | RemoveAppCatalogsByLanguageId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveAppCategoryName
Specificare una matrice di nomi di categorie amministrative da rimuovere. Per rimuovere tutte le categorie amministrative, utilizzare il parametro CleanAppCategory.
Type: | String[] |
Aliases: | RemoveAppCategoryNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveApplication
Specificare una matrice di nomi di applicazioni da rimuovere da questo gruppo.
Type: | String[] |
Aliases: | RemoveApplications |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveOwner
Specificare una matrice di proprietari da rimuovere. Per rimuovere tutti i proprietari, utilizzare il parametro ClearOwner.
Type: | String[] |
Aliases: | RemoveOwners |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveSupportContact
Specificare una matrice di contatti di supporto da rimuovere. Per rimuovere tutti i contatti di supporto, utilizzare il parametro ClearSupportContact.
Type: | String[] |
Aliases: | RemoveSupportContacts |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveUserCategoryName
Specificare una matrice di nomi di categorie utente da rimuovere. Per rimuovere tutte le categorie utente, utilizzare il parametro CleanUserCategory.
Type: | String[] |
Aliases: | RemoveUserCategoryNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareVersion
Specifica una stringa di versione facoltativa per il gruppo di app. La lunghezza massima è 64 caratteri.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserDocumentation
Specifica il percorso di un file da cui gli utenti di Software Center possono ottenere ulteriori informazioni su questo gruppo di app. Questo percorso è un indirizzo di sito Web o un percorso di rete e un nome di file. Assicurarsi che gli utenti hanno accesso a questa posizione.
La lunghezza massima dell'intera stringa è di 256 caratteri.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
IResultObject
Questo cmdlet restituisce l'SMS_ApplicationGroup classe WMI.