Get-CMConfigurationPlatform

  • Riferimento
Modulo:
ConfigurationManager

Ottenere una piattaforma del sistema operativo per una regola dei requisiti.

Sintassi

Get-CMConfigurationPlatform
   [-Fast]
   [-IsSupported <Boolean>]
   [[-Name] <String>]
   [-PlatformOption <PlatformType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationPlatform
   [-Fast]
   [-Id] <Int32>
   [-IsSupported <Boolean>]
   [-PlatformOption <PlatformType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per ottenere una piattaforma del sistema operativo da usare con una regola dei requisiti del sistema operativo per un tipo di distribuzione dell'applicazione. È possibile usare l'oggetto output di questo cmdlet con il cmdlet New-CMRequirementRuleOperatingSystemValue .

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: Aggiungere una regola di requisito per un sistema operativo per piattaforma

Questo esempio usa innanzitutto il cmdlet Get-CMGlobalCondition per ottenere la condizione globale del sistema operativo predefinita per i dispositivi Windows non mobili. Definisce quindi le variabili per due piattaforme per Windows Server 2016 e Windows Server 2019. Successivamente viene usato il cmdlet New-CMRequirementRuleOperatingSystemValue per creare l'oggetto regola del requisito per includere queste due piattaforme. Infine passa l'oggetto regola al cmdlet Set-CMScriptDeploymentType per aggiungere il requisito.

$myGC = Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1

$platformA = Get-CMConfigurationPlatform -Name "All Windows Server 2019 and higher (64-bit)"

$platformB = Get-CMConfigurationPlatform -Name "All Windows Server 2016 and higher (64-bit)"

$myRule = $myGC | New-CMRequirementRuleOperatingSystemValue -RuleOperator OneOf -Platform $platformA, $platformB

Set-CMScriptDeploymentType -ApplicationName "Central App" -DeploymentTypeName "Install" -AddRequirement $myRule

Parametri

-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

-Fast

Aggiungere questo parametro per non aggiornare automaticamente le proprietà lazy. Le proprietà lazy contengono valori relativamente inefficienti da recuperare. Il recupero di queste proprietà può causare traffico di rete aggiuntivo e ridurre le prestazioni dei cmdlet.

Se non si usa questo parametro, il cmdlet visualizza un avviso. Per disabilitare questo avviso, impostare $CMPSSuppressFastNotUsedCheck = $true.

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

-Id

Specificare il valore intero per il CI_ID della piattaforma. Ad esempio, il CI_ID per la piattaforma All Windows Server 2019 e versioni successive (64 bit) è 287650.

Usare un comando simile al seguente per individuare il CI_ID per una piattaforma:

Get-CMConfigurationPlatform -Name "*Server 2019*" | Select-Object LocalizedDisplayName, CI_ID

Tipo:Int32
Alias:CI_ID
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IsSupported

Configuration Manager definisce ancora le piattaforme legacy per la compatibilità con le versioni precedenti. Impostare questo parametro su $true per filtrare i risultati solo sulle piattaforme attualmente supportate.

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

-Name

Specificare il nome della piattaforma del sistema operativo. È possibile usare caratteri jolly:

  • *: più caratteri
  • ?: carattere singolo
Tipo:String
Alias:LocalizedDisplayName
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PlatformOption

Usare questo parametro per filtrare i risultati in base al tipo di piattaforma.

Tipo:PlatformType
Valori accettati:None, Windows, Mobile, Mac, MixedPlatform
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject[]

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_ConfigurationPlatform classe WMI del server.

Questo cmdlet è diverso dal cmdlet Get-CMSupportedPlatform simile.