Partilhar via


Get-CMConfigurationPlatform

SYNOPSIS

Obtenha uma plataforma de SO para uma regra de requisito.

SYNTAX

SearchByName (Padrão)

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

Utilize este cmdlet para obter uma plataforma DE PARA a utilização com uma regra de exigência de SO para um tipo de implementação de aplicação. Pode utilizar o objeto de saída deste cmdlet com o cmdlet New-CMRequirementRuleOperatingSystemValue.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

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

Este exemplo utiliza primeiro o cmdlet Get-CMGlobalCondition para obter a condição global do sistema operativo padrão para dispositivos de Windows não móveis. Em seguida, define variáveis para duas plataformas para Windows Server 2016 e Windows Server 2019. Em seguida, utiliza o cmdlet New-CMRequirementRuleOperatingSystemValue para criar o objeto de regra de requisito para incluir estas duas plataformas. Por fim, passa o objeto de regra ao set-CMScriptDeploymentType cmdlet 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

PARAMETERS

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

- Rápido

Adicione este parâmetro para não atualizar automaticamente as propriedades preguiçosas. As propriedades preguiçosas contêm valores que são relativamente ineficientes de recuperação. Obter estas propriedades pode causar tráfego adicional de rede e diminuir o desempenho do cmdlet.

Se não utilizar este parâmetro, o cmdlet apresenta um aviso. Para desativar este aviso, desative $CMPSSuppressFastNotUsedCheck = $true .

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
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 para a plataforma All Windows Server 2019 e superior (64-bit) é 287650 .

Utilize 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
Parameter Sets: SearchById
Aliases: CI_ID

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Issupport

O Gestor de Configuração ainda define plataformas antigas para retrocompatibilidade. Desatrei este parâmetro $true para filtrar os resultados apenas para plataformas que são suportadas atualmente.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Especifique o nome da plataforma os. Pode utilizar caracteres wildcard:

  • *: Vários caracteres
  • ?: Personagem única
Type: String
Parameter Sets: SearchByName
Aliases: LocalizedDisplayName

Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PlataformaOption

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

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

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Nenhuma

OUTPUTS

IResultObject[]#SMS_ConfigurationPlatform

IResultObject#SMS_ConfigurationPlatform

NOTAS

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

Este cmdlet é diferente do cmdlet Get-CMSupportedPlatform semelhante.

Novo CMRequirementRuleOperatingSystemValue