Share via

Get-CMOrchestrationGroup

  • Referência
Módulo:
ConfigurationManager

Obtenha um objeto de grupo de orquestração.

Syntax

Get-CMOrchestrationGroup
   [[-Name] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMOrchestrationGroup
   [-Id] <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para obter um objeto de grupo de orquestração por nome ou ID. Você pode usar esse objeto para iniciar, remover ou configurar o grupo de orquestração. Para essas outras ações, use os seguintes cmdlets:

Use grupos de orquestração para controlar melhor a implantação de atualizações de software em dispositivos. Talvez seja necessário gerenciar cuidadosamente as atualizações para cargas de trabalho específicas ou automatizar comportamentos entre elas. Para obter mais informações, consulte Sobre grupos de orquestração em Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: exibir detalhes sobre membros de um grupo de orquestração

Este exemplo usa primeiro o cmdlet Get-CMOrchestrationGroup para obter um objeto para o grupo de orquestração chamado servidores de TI.

Em seguida, ele passa por cada membro do grupo de orquestração, que é armazenado pela ID do recurso. Em seguida, ele usa o cmdlet Get-CMDevice para exibir o nome do dispositivo e as propriedades de build do sistema operacional.

$og = Get-CMOrchestrationGroup -Name "IT servers"

foreach ( $member in $og.MOGMembers ) {
  Get-CMDevice -Id $member -Fast | Select-Object Name, Build
}

Exemplo 2: Obter grupos de orquestração com scripts não aprovados

O exemplo a seguir obtém todos os grupos de orquestração do site. Ele usa o cmdlet where-object interno para filtrar os resultados que têm uma das propriedades do estado de aprovação do script com um valor de 0. Ele usa o operador de pipeline novamente para reduzir as propriedades retornadas com o cmdlet Select-Object interno para exibir apenas o nome dos grupos de orquestração.

Você pode usar este exemplo para exibir todos os grupos de orquestração que têm um pré ou pós-script que não foi aprovado.

Get-CMOrchestrationGroup | Where-Object ( $_.PostScriptApprovalState -eq $false -or $_.PreScriptApprovalState -eq $false ) | Select-Object Name

Parâmetros

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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). Você não pode combiná-lo com DisableWildcardHandling.

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

-Id

Especifique a ID do grupo de orquestração a ser obtido. Esse valor é a propriedade MOGID , que é um inteiro. Por exemplo, 16777217.

Type:Int32
Aliases:MOGID
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique o nome do grupo de orquestração a ser obtido.

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

Entradas

None

Saídas

IResultObject

Observações

Este cmdlet retorna um objeto para a classe WMI SMS_MachineOrchestrationGroup .