Condividi tramite


Get-CMOrchestrationGroup

Ottiene un oggetto gruppo di orchestrazione.

Sintassi

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

Descrizione

Usare questo cmdlet per ottenere un oggetto gruppo di orchestrazione in base al nome o all'ID. È possibile usare questo oggetto per avviare, rimuovere o configurare il gruppo di orchestrazione. Per queste altre azioni, usare i cmdlet seguenti:

Usare i gruppi di orchestrazione per controllare meglio la distribuzione degli aggiornamenti software nei dispositivi. Potrebbe essere necessario gestire con attenzione gli aggiornamenti per carichi di lavoro specifici o automatizzare i comportamenti intermedi. Per altre informazioni, vedere Informazioni sui gruppi di orchestrazione in Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Visualizzare i dettagli sui membri di un gruppo di orchestrazione

Questo esempio usa innanzitutto il cmdlet Get-CMOrchestrationGroup per ottenere un oggetto per il gruppo di orchestrazione denominato server IT.

Esegue quindi un ciclo attraverso ogni membro del gruppo di orchestrazione, che viene archiviato dal relativo ID risorsa. Usa quindi il cmdlet Get-CMDevice per visualizzare il nome del dispositivo e le proprietà di compilazione del sistema operativo.

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

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

Esempio 2: Ottenere gruppi di orchestrazione con script non approvati

Nell'esempio seguente vengono ottenuti tutti i gruppi di orchestrazione dal sito. Usa il cmdlet Where-Object predefinito per filtrare i risultati che hanno una delle proprietà dello stato di approvazione dello script con il valore 0. Usa nuovamente l'operatore della pipeline per ridurre le proprietà restituite con il cmdlet Select-Object predefinito per visualizzare solo il nome dei gruppi di orchestrazione.

È possibile usare questo esempio per visualizzare tutti i gruppi di orchestrazione con uno script pre o post-script non approvato.

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

Parametri

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specificare l'ID del gruppo di orchestrazione da ottenere. Questo valore è la proprietà MOGID , che è un numero intero. Ad esempio, 16777217.

Tipo:Int32
Alias:MOGID
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare il nome del gruppo di orchestrazione da ottenere.

Tipo:String
Alias:OrchestrationGroupName
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject

Note

Questo cmdlet restituisce un oggetto per la classe WMI SMS_MachineOrchestrationGroup .