Get-CMConfigurationPlatform

Referenz

Modul:: ConfigurationManager

Abrufen einer Betriebssystemplattform für eine Anforderungsregel.

Syntax

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

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

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Betriebssystemplattform für die Verwendung mit einer Betriebssystemanforderungsregel für einen Anwendungsbereitstellungstyp abzurufen. Sie können das Ausgabeobjekt dieses Cmdlets mit dem Cmdlet "New-CMRequirementRuleOperatingSystemValue" verwenden.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Hinzufügen einer Anforderungsregel für ein Betriebssystem nach Plattform

In diesem Beispiel wird zunächst das Cmdlet "Get-CMGlobalCondition" verwendet, um die globale Standardbedingung des Betriebssystems für nicht mobile Windows Geräte abzurufen. Anschließend werden Variablen für zwei Plattformen für Windows Server 2016 und Windows Server 2019 definiert. Als Nächstes wird das Cmdlet "New-CMRequirementRuleOperatingSystemValue" verwendet, um das Anforderungsregelobjekt für diese beiden Plattformen zu erstellen. Schließlich wird dieses Regelobjekt an das Cmdlet "Set-CMScriptDeploymentType" übergeben, um die Anforderung hinzuzufügen.

$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

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Fast

Fügen Sie diesen Parameter hinzu, um nicht automatisch verzögerte Eigenschaften zu aktualisieren. Lazy-Eigenschaften enthalten Werte, die relativ ineffizient abzurufen sind. Das Abrufen dieser Eigenschaften kann zusätzlichen Netzwerkdatenverkehr verursachen und die Leistung von Cmdlets verringern.

Wenn Sie diesen Parameter nicht verwenden, zeigt das Cmdlet eine Warnung an. Um diese Warnung zu deaktivieren, legen Sie $CMPSSuppressFastNotUsedCheck = $true fest.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Geben Sie den ganzzahligen Wert für die CI_ID der Plattform an. Beispielsweise ist die CI_ID für die Plattform "Alle Windows Server 2019" und höher (64-Bit) 287650 .

Verwenden Sie einen Befehl wie den folgenden, um die CI_ID für eine Plattform zu ermitteln:

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

Type:	Int32
Aliases:	CI_ID
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IsSupported

Configuration Manager definiert weiterhin Legacyplattformen für die Abwärtskompatibilität. Legen Sie diesen Parameter so $true fest, dass die Ergebnisse nur auf Plattformen gefiltert werden, die derzeit unterstützt werden.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Geben Sie den Namen der Betriebssystemplattform an. Sie können Platzhalterzeichen verwenden:

*: Mehrere Zeichen
?: Einzelnes Zeichen

Type:	String
Aliases:	LocalizedDisplayName
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PlatformOption

Verwenden Sie diesen Parameter, um die Ergebnisse nach Plattformtyp zu filtern.

Type:	PlatformType
Accepted values:	None, Windows, Mobile, Mac, MixedPlatform
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Keine

Ausgaben

IResultObject[]

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_ConfigurationPlatform Server-WMI-Klasse.

Dieses Cmdlet unterscheidet sich vom ähnlichen Cmdlet "Get-CMSupportedPlatform".

New-CMRequirementRuleOperatingSystemValue