Get-CMOrchestrationGroup

  • Referência
Módulo:
ConfigurationManager

Obter um objeto de grupo de orquestração.

Sintaxe

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

Description

Utilize este cmdlet para obter um objeto de grupo de orquestração por nome ou ID. Pode utilizar este objeto para iniciar, remover ou configurar o grupo de orquestração. Para estas outras ações, utilize os seguintes cmdlets:

Utilize grupos de orquestração para controlar melhor a implementação de atualizações de software em dispositivos. Poderá ter de gerir cuidadosamente as atualizações de cargas de trabalho específicas ou automatizar comportamentos intermédios. Para obter mais informações, veja About orchestration groups in Configuration Manager (Acerca dos grupos de orquestração no Configuration Manager).

Observação

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

Exemplos

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

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

Em seguida, percorre cada membro do grupo de orquestração, que é armazenado pelo respetivo ID de recurso. Em seguida, utiliza o cmdlet Get-CMDevice para apresentar o nome do dispositivo e as propriedades de compilação do SO.

$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 seguinte obtém todos os grupos de orquestração do site. Utiliza o cmdlet Where-Object incorporado para filtrar os resultados que têm uma das propriedades do estado de aprovação do script com um valor de 0. Utiliza novamente o operador de pipeline para reduzir as propriedades devolvidas com o cmdlet Select-Object incorporado para apresentar apenas o nome dos grupos de orquestração.

Pode utilizar este exemplo para apresentar todos os grupos de orquestração que tenham um pré-script ou pós-script que não esteja aprovado.

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

Parâmetros

-DisableWildcardHandling

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifique o ID do grupo de orquestração a obter. Este valor é a propriedade MOGID , que é um número inteiro. Por exemplo, 16777217.

Tipo:Int32
Aliases:MOGID
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique o nome do grupo de orquestração a obter.

Tipo:String
Aliases:OrchestrationGroupName
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject

Observações

Este cmdlet devolve um objeto para a classe WMI SMS_MachineOrchestrationGroup.