Share via

Get-CMConfigurationPlatform

  • Referência
Módulo:
ConfigurationManager

Obter uma plataforma do sistema operacional para uma regra de requisito.

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>]

Description

Use este cmdlet para obter uma plataforma do sistema operacional a ser usada com uma regra de requisito do sistema operacional para um tipo de implantação de aplicativo. Você pode usar o objeto de saída deste cmdlet com o cmdlet New-CMRequirementRuleOperatingSystemValue.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Adicionar uma regra de requisito para um sistema operacional por plataforma

Este exemplo usa primeiro o cmdlet Get-CMGlobalCondition para obter a condição global padrão do sistema operacional para dispositivos que não Windows móveis. Em seguida, define variáveis para duas plataformas para Windows Server 2016 e Windows Server 2019. Em seguida, ele usa o cmdlet New-CMRequirementRuleOperatingSystemValue para criar o objeto de regra de requisitos para incluir essas duas plataformas. Por fim, ele passa esse objeto de regra para o cmdlet Set-CMScriptDeploymentType para adicionar o 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

Parâmetros

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-Fast

Adicione esse parâmetro para não atualizar automaticamente as propriedades desleisadas. Propriedades flexíveis contêm valores relativamente ineficientes para recuperar. Obter essas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.

Se você não usar esse parâmetro, o cmdlet exibirá um aviso. Para desabilitar esse aviso, de definir $CMPSSuppressFastNotUsedCheck = $true .

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-Id

Especifique o valor inteiro para o CI_ID da plataforma. Por exemplo, o CI_ID da plataforma All Windows Server 2019 e superior (64 bits) é 287650 .

Use um comando semelhante ao seguinte para descobrir o CI_ID para uma plataforma:

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

O Configuration Manager ainda define plataformas herdada para compatibilidade com compatibilidade. De definir esse parâmetro $true para filtrar os resultados para apenas plataformas com suporte no momento.

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

-Name

Especifique o nome da plataforma do sistema operacional. Você pode usar caracteres curinga:

  • *: Vários caracteres
  • ?: Caractere único
Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PlatformOption

Use este parâmetro para filtrar os resultados por tipo de plataforma.

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

Entradas

Nenhum

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_ConfigurationPlatform classe WMI do servidor.

Este cmdlet é diferente do cmdlet Get-CMSupportedPlatform semelhante.