Get-CMConfigurationPlatform
SYNOPSIS
Hämta en OS-plattform för en kravregel.
SYNTAX
SearchByName (standard)
Get-CMConfigurationPlatform [-Fast] [-IsSupported <Boolean>] [[-Name] <String>]
[-PlatformOption <PlatformType>] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
SearchById
Get-CMConfigurationPlatform [-Fast] [-Id] <Int32> [-IsSupported <Boolean>] [-PlatformOption <PlatformType>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
Använd den här cmdleten för att få en OS-plattform att använda med en regel för operativsystemkrav för en programdistributionstyp. Du kan använda utdataobjektet för den här cmdleten med cmdleten New-CMRequirementRuleOperatingSystemValue.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\>
. Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Lägg till en kravregel för ett operativsystem per plattform
I det här exemplet används först cmdleten Get-CMGlobalCondition för att hämta det globala standardvillkoret operativsystem för icke-mobila Windows enheter. Sedan definieras variabler för två plattformar för Windows Server 2016 och Windows Server 2019. Därefter använder den cmdleten New-CMRequirementRuleOperatingSystemValue för att skapa kravregelobjektet för att inkludera dessa två plattformar. Slutligen skickar den regelobjektet till cmdleten Set-CMScriptDeploymentType för att lägga till kravet.
$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
PARAMETERS
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Snabb
Lägg till den här parametern för att inte uppdatera lazy-egenskaper automatiskt. Lazy-egenskaper innehåller värden som är relativt ineffektiva att hämta. Att hämta dessa egenskaper kan orsaka ytterligare nätverkstrafik och minska cmdlet-prestanda.
Om du inte använder den här parametern visar cmdleten en varning. Om du vill inaktivera den här varningen anger du $CMPSSuppressFastNotUsedCheck = $true
.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Ange heltalsvärdet för CI_ID för plattformen. Till exempel är CI_ID för plattformen Alla Windows Server 2019 och senare (64-bitars) 287650
.
Använd ett kommando som liknar följande för att identifiera CI_ID för en plattform:
Get-CMConfigurationPlatform -Name "*Server 2019*" | Select-Object LocalizedDisplayName, CI_ID
Type: Int32
Parameter Sets: SearchById
Aliases: CI_ID
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsSupported
Konfigurationshanteraren fortfarande äldre plattformar för bakåtkompatibilitet. Ange den här $true
parametern till för att filtrera resultaten till endast plattformar som stöds för närvarande.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Ange namnet på OS-plattformen. Du kan använda jokertecken:
*
: Flera tecken?
: Enskilt tecken
Type: String
Parameter Sets: SearchByName
Aliases: LocalizedDisplayName
Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PlatformOption
Använd den här parametern för att filtrera resultaten efter plattformstyp.
Type: PlatformType
Parameter Sets: (All)
Aliases:
Accepted values: None, Windows, Mobile, Mac, MixedPlatform
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
INPUTS
Ingen
OUTPUTS
IResultObject[]#SMS_ConfigurationPlatform
IResultObject#SMS_ConfigurationPlatform
ANTECKNINGAR
Mer information om det här returobjektet och dess egenskaper finns i SMS_ConfigurationPlatform serverns WMI-klass.
Denna cmdlet skiljer sig från den liknande cmdleten Get-CMSupportedPlatform.