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
Usare questo cmdlet per configurare le impostazioni di un gruppo di applicazioni esistente. Usare un gruppo di app 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.
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: 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
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 |
-AddAppCategory
Specificare uno o più oggetti categoria amministrativa per filtrare e trovare il gruppo di app nella console. Per ottenere questi oggetti, usare il cmdlet Get-CMCategory . Queste categorie sono di tipo AppCategories.
Per aggiungere categorie per consentire agli utenti di filtrare e trovare applicazioni in Software Center, usare il parametro AddUserCategory .
Tipo: | IResultObject[] |
Alias: | AddAppCategories |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-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: | False |
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 |
-AddUserCategory
Specificare uno o più oggetti categoria utente per filtrare e trovare il gruppo di app nella console. Per ottenere questi oggetti, usare il cmdlet Get-CMCategory . Queste categorie sono di tipo CatalogCategories.
Per aggiungere categorie per consentire agli utenti di filtrare e trovare applicazioni in Software Center, usare il parametro AddAppCategory .
Tipo: | IResultObject[] |
Alias: | AddUserCategories |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ApplyToLanguageById
Per le impostazioni visualizzate in Software Center, usare questo parametro per specificare l'ID lingua per le impostazioni.
Questo ID è l'equivalente decimale dell'ID lingua windows. Ad esempio, 1033
è 0x0409
per l'inglese (Stati Uniti) e 2108
per 0x083C
l'irlandese (Irlanda). Per altre informazioni, vedere [MS-LCID]: Informazioni di riferimento sull'identificatore LCID (Windows Language Code Identifier).
Ad esempio, per aggiungere un nome di app localizzato per l'irlandese (Irlanda):
-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"
Tipo: | Int32 |
Alias: | ApplySettingToSpecificLanguage |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-CleanAppCategory
Aggiungere questo parametro per rimuovere tutte le categorie amministrative. Per rimuovere una singola categoria, usare il parametro RemoveAppCategory .
Tipo: | SwitchParameter |
Alias: | CleanAppCategories |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-CleanUserCategory
Aggiungere questo parametro per rimuovere tutte le categorie utente. Per rimuovere una singola categoria, usare il parametro RemoveUserCategory .
Tipo: | SwitchParameter |
Alias: | CleanUserCategories |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ClearAppCatalog
Aggiungere questo parametro per rimuovere tutte le voci localizzate di Software Center. Per rimuovere una singola voce, usare il parametro RemoveAppCatalog .
Tipo: | SwitchParameter |
Alias: | ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ClearOwner
Aggiungere questo parametro per rimuovere tutti i proprietari. Per rimuovere un singolo proprietario, usare il parametro RemoveOwner .
Tipo: | SwitchParameter |
Alias: | CleanOwners |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ClearSupportContact
Aggiungere questo parametro per rimuovere tutti i contatti di supporto. Per rimuovere un singolo contatto, usare il parametro RemoveSupportContact .
Tipo: | SwitchParameter |
Alias: | CleanSupportContacts |
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 0x083C
l'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 |
-Id
Specificare l'ID del gruppo di app da configurare. Questo valore è uguale al CI_ID, ad esempio 1025866
.
Tipo: | Int32 |
Alias: | CIId, CI_ID |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-InputObject
Specificare un oggetto gruppo di app da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMApplicationGroup .
Tipo: | IResultObject |
Alias: | ApplicationGroup |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
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 |
-ModelName
Specificare l'identificatore del modello di applicazione del gruppo di app da configurare. Questo valore è noto anche come ID univoco ci. Ad esempio, ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed
.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Name
Specificare il nome del gruppo di app da configurare.
Tipo: | String |
Alias: | LocalizedDisplayName, ApplicationGroupName |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-NewName
Usare questo parametro per rinominare il gruppo di app. La lunghezza massima è 256 caratteri.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
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 |
-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.
Tipo: | SwitchParameter |
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 |
-RemoveAppCatalog
Specificare una matrice di ID lingua per rimuovere le voci di Software Center associate. Per rimuovere tutte le voci, usare il parametro ClearAppCatalog .
Questo ID è l'equivalente decimale dell'ID lingua windows. Ad esempio, 1033
è 0x0409
per l'inglese (Stati Uniti) e 2108
per 0x083C
l'irlandese (Irlanda). Per altre informazioni, vedere [MS-LCID]: Informazioni di riferimento sull'identificatore LCID (Windows Language Code Identifier).
Ad esempio, per rimuovere la voce localizzata di Software Center per l'irlandese (Irlanda):For example, to remove the localized Software Center entry for Irish (Ireland):For example, to remove the localized Software Center entry for Irish (Ireland):
-RemoveAppCatalog 2108
Tipo: | Int32[] |
Alias: | RemoveAppCatalogsByLanguageId |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-RemoveAppCategoryName
Specificare una matrice di nomi di categoria amministrativi da rimuovere. Per rimuovere tutte le categorie amministrative, usare il parametro CleanAppCategory .
Tipo: | String[] |
Alias: | RemoveAppCategoryNames |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-RemoveApplication
Specificare una matrice di nomi di applicazione da rimuovere da questo gruppo.
Tipo: | String[] |
Alias: | RemoveApplications |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-RemoveOwner
Specificare una matrice di proprietari da rimuovere. Per rimuovere tutti i proprietari, usare il parametro ClearOwner .
Tipo: | String[] |
Alias: | RemoveOwners |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-RemoveSupportContact
Specificare una matrice di contatti di supporto da rimuovere. Per rimuovere tutti i contatti di supporto, usare il parametro ClearSupportContact .
Tipo: | String[] |
Alias: | RemoveSupportContacts |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-RemoveUserCategoryName
Specificare una matrice di nomi di categorie utente da rimuovere. Per rimuovere tutte le categorie utente, usare il parametro CleanUserCategory .
Tipo: | String[] |
Alias: | RemoveUserCategoryNames |
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
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
IResultObject
Questo cmdlet restituisce l'oggetto classe WMI SMS_ApplicationGroup.